DuploPay is a complete suite of payment gateway solutions developed to provide an end-to-end solution for online payments across various business verticals. With use cases cutting across payment, collections, disbursement, reconciliation and payouts, customization, and integration through different secured alternatives.
\nTo create your merchant account , click here.
\nOn the login screen, click Create an account
\nFill in the form requirements i.e. First Name, Last Name, Email Address and Password.
\nOnce you complete your registration form, click on Create Register
\nUsing the details provided on the sign up form, login to your account
\nWhen you login, select your business type (Individual, Business, SMEs and NGOs) as seen below and fill in the form requirements.
\nWhen you submit, your account will automatically be in test mode and a request will be sent to us to activate your account.
\nWhen you submit, a request will be sent to us to activate your account. By default your account will be in test mode till your business is activated.
\nIn test mode, no real money is involved.We'll still send webhooks and email notifications, and most of the API functions are the same.
\nWhen your account is activated, you can easily switch between test and live mode.
\nAPI Keys
Dpay APIs use API keys to authenticate all API requests. Upon creating your merchant account, your API keys will be auto generated for you. You can find your test and live API keys under Profile > Account/business settings > API key on your dashboard.
Webhooks
\nAfter a payment transaction on your account, we notify you on the status of this transaction i.e. successful payment or a failed transaction.
You can find the test and live Webhooks under Profile > Account/business settings > API key on your dashboard.
Callback URLs
\nAfter a payment transaction on your account, the Callback URL is where your customers are redirected to. You can find the test and live Callback URLs under Profile > Account/business settings > API key on your dashboard.
\nTo make API calls on Duplo, you’ll have to pass a Bearer Token (your_secret_key).
\nBASE_URL https://api.duplopg.com/api/v2
\nPass your secret key as the Bearer token in Authorization Header.
\nPass your HMAC Signature as Encryption Header. (Required only in Payout)
\nNOTE: Signature authentication ensures the highest level of security for your payment creation requests. Not only does it provide a secure authentication mechanism, but also it ensures the integrity of your request payload, that is the content of your request payload has not been altered since it was transmitted from your side. DuploPay signatures are calculated using HMAC-SH512 applied to payload and signed with your public key.
\nNOTE: Make sure your payload is arranged alphabetically.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Get Started","slug":"get-started"},{"content":"Payment Authentication","slug":"payment-authentication"},{"content":"Authentication","slug":"authentication"}],"owner":"16197916","collectionId":"888e9fae-4bf1-491e-b55f-964fe7bd3185","publishedId":"2s946bBEpi","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"146e5f"},"publishDate":"2023-07-10T14:53:03.000Z"},"item":[{"name":"Transactions","item":[{"name":"Initialize Transaction","id":"04f4e4b3-b688-48ce-a1ce-ad35e2cf44b1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_test_gmbq9kxqr6bc9otiuk10n5tgzotkoiiq0vagf4y"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email\": \"toluxsys@email.com\",\n \"amount\": \"100\",\n \"callback\": \"http://google.com\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.duplopg.com/api/v2/transaction/initialize","description":"The Transactions API allows you create and manage payments on your integration.
\nEndpoint: /transaction/verify/:reference
Method: GET
This endpoint allows you to get all transactions
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_test_gmbq9kxqr6bc9otiuk10n5tgzotkoiiq0vagf4y"}]},"isInherited":true,"source":{"_postman_id":"888e9fae-4bf1-491e-b55f-964fe7bd3185","id":"888e9fae-4bf1-491e-b55f-964fe7bd3185","name":"Dpay Merchant Integration Guide","type":"collection"}},"urlObject":{"path":["transaction"],"host":["https://api.duplopg.com/api/v2"],"query":[],"variable":[]}},"response":[],"_postman_id":"7f404297-e705-4662-83ad-98eb2dab2051"},{"name":"Transactions Query","id":"f2149750-f0ad-4b47-bbdd-62261fb784a7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.duplopg.com/api/v2/transaction_query/{search}","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_test_gmbq9kxqr6bc9otiuk10n5tgzotkoiiq0vagf4y"}]},"isInherited":true,"source":{"_postman_id":"888e9fae-4bf1-491e-b55f-964fe7bd3185","id":"888e9fae-4bf1-491e-b55f-964fe7bd3185","name":"Dpay Merchant Integration Guide","type":"collection"}},"urlObject":{"path":["transaction_query","{search}"],"host":["https://api.duplopg.com/api/v2"],"query":[],"variable":[]}},"response":[],"_postman_id":"f2149750-f0ad-4b47-bbdd-62261fb784a7"},{"name":"Fetch Transaction","id":"d18bbd4e-12cd-42a7-b203-0f351c12dafa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.duplopg.com/api/v2/transaction/:id","description":"Endpoint: /transaction/:id
Method: GET
The Wallet transactions API allows you fetch all your wallet transaction history.
\nList all your business Wallet Transactions.
\nEndpoint: /wallet_transactions/{currency}
Method: GET
Sometimes you may like to now your wallet balanace before a transfer is initiated or for any other purpose.
\nEndpoint: /wallet_balance/{currency}
Method: GET
The Customers API allows you create and manage customers on your integration.
\nCreate a customer on your integration
\nEndpoint: /customer
Method: POST
The first_name, last_name and phone are optional parameters. However, when creating a customer that would be assigned to a Dedicated Virtual Account, then these parameters become compulsory or necessary.
\nThe Settlements API allows you fetch all your settlement history.
\nList all your business Settlements.
\nEndpoint: /settlement
Method: GET
Get details of a Settlement with all transactions of that settlement .
\nEndpoint: /settlement/details/:{batchid}
Method: GET
The Dedicated Virtual Account API enables Nigerian merchants to manage unique payment accounts of their customers.
\nThis feature is only available to businesses in Nigeria.
\nCreate a dedicated virtual account and assign to a customer
\nEndpoint: /dedicated_virtual_account
Method: POST
We currently support Wema Bank only.
\nTo create Dedicated Virtual Accounts for testing, simply use your test secret key to generate the dedicated account number. And get your payment approved automatically.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_test_gmbq9kxqr6bc9otiuk10n5tgzotkoiiq0vagf4y"}]},"isInherited":true,"source":{"_postman_id":"888e9fae-4bf1-491e-b55f-964fe7bd3185","id":"888e9fae-4bf1-491e-b55f-964fe7bd3185","name":"Dpay Merchant Integration Guide","type":"collection"}},"urlObject":{"path":["dedicated_virtual_account"],"host":["https://api.duplopg.com/api/v2"],"query":[],"variable":[]}},"response":[],"_postman_id":"a192dbb9-2c2d-4f08-8302-4c1391e4fe47"},{"name":"List Dedicated Virtual Account","id":"c61823e1-1dc4-4e5f-a45e-814e0dfd3691","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.duplopg.com/api/v2/list_dedicated_accounts","description":"List dedicated virtual accounts available on your integration.
\nEndpoint: /list_dedicated_accounts
Method: GET
Get details of a dedicated virtual account on your integration.
\nEndpoint: /dedicated_account/:id
Method: GET
Get a list of all supported banks and their codes.
\nEndpoint: /bank_list
Method: GET
Get the account name on an account number.
\nEndpoint: /account_name_verify
Method: POST
Status of transfer object returned will be pending until it's proccessed successfully.
Endpoint: /bulk_bank_transfer
Method: POST
List the transfers made on your integration/business.
\nEndpoint: /list_transfers
Method: GET
Fetch a payout record using payout reference.
\nEndpoint: /payout/:reference
Method: GET
Sometimes you may like to now your transfer fee before a transfer is initiated.
\nEndpoint: /payout_fee
Method: POST
Status of transfer object returned will be pending until it's proccessed successfully.
Endpoint: /bank_transfer
Method: POST
The Refunds API allows you create and manage transaction refunds.
\nInitiate a refund on your integration
\nEndpoint: /refund
Method: POST
List refunds available on your integration.
\nEndpoint: /refund
Method: GET
Get details of a refund on your integration.
\nEndpoint: /refund/:reference
Method: GET