{"info":{"_postman_id":"052e278e-29e8-4c0c-824c-f34a33acce4b","name":"Kora Public APIs","description":"<html><head></head><body><p>Our APIs enable payment processing on your platform which collects your customers' payment information securely on the web or mobile and creates payments.</p>\n<p>The Kora API gives you access to pretty much all the features you can use on our dashboard and lets you extend them for use in your application.</p>\n\n<p>Before you do anything, you should<a href=\"https://merchant.korapay.com\"><b>create</b></a>a free Kora account that you can test the API against.</p>\n\n<p>Whether you're building a platform that needs to get sellers paid or building applications to do more with Korap integrations. We will provide you with test keys that you can use to make API calls.</p>\n\n<h1 id=\"get-started\">Get Started</h1>\n<p><code>Base URL - https://api.korapay.com/merchant</code></p>\n<ol>\n<li><p><a href=\"https://developers.korapay.com/docs/api-keys\"><b>API Keys</b></a></p>\n</li>\n<li><p><a href=\"https://developers.korapay.com/docs/test-live-modes\"><b>Test &amp; Live Modes</b></a></p>\n</li>\n<li><p><a href=\"https://developers.korapay.com/docs/testing-your-integration\"><b>Testing your Integration</b></a></p>\n</li>\n<li><p><a href=\"https://developers.korapay.com/docs/webhooks\"><b>Webhooks</b></a></p>\n</li>\n</ol>\n<h1 id=\"authentication\">Authentication</h1>\n<p>Every endpoint requires some form of authentication using a bearer token header. The key required for each request can either be a secret key or a public key.</p>\n<h5 id=\"apis-requiring-secret-key\">APIs requiring secret key</h5>\n<p>The following groups API endpoints require secret key for authentication</p>\n<p><code>Authorization: Bearer sk_live_****</code></p>\n<ul>\n<li><p>Pay-ins</p>\n</li>\n<li><p>Payouts</p>\n</li>\n<li><p>Virtual Accounts</p>\n</li>\n<li><p>Balances</p>\n</li>\n<li><p>Verification</p>\n</li>\n</ul>\n<h5 id=\"apis-requiring-public-key\">APIs requiring public key</h5>\n<p>The following group API endpoint requires public key for authentication</p>\n<p><code>Authorization: Bearer pk_live_****</code></p>\n<ul>\n<li>Miscellaneous</li>\n</ul>\n<h1 id=\"responses\">Responses</h1>\n<h3 id=\"success-response\">Success Response</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"status\": \"true\",\n  \"message\": \"Transaction retrieved successfully\",\n  \"data\": {...}\n}\n\n</code></pre>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Field</strong></th>\n<th><strong>Data Types</strong></th>\n<th><strong>Description</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>A boolean that lets you know if the request was successful or not.</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>A summary of the response based on the status. For example, when retrieving a list of transactions, it would read “Transaction retrieved successfully”. However, In the event of an error, the message key will contain a general description of the error.</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>This contains the information specific to your request. It can be an object or an array depending on the request. A request to retrieve a list of transactions would return an array while a request to verify a single charge would return an object.</td>\n</tr>\n</tbody>\n</table>\n</div><h3 id=\"webhook-request-body\">Webhook Request Body</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>event</td>\n<td>string</td>\n<td>transfer.success or transfer.failed</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>object containing transaction details: amount, fee, currency, status, reference</td>\n</tr>\n<tr>\n<td>data.amount</td>\n<td>number</td>\n<td>transaction amount</td>\n</tr>\n<tr>\n<td>data.fee</td>\n<td>number</td>\n<td>transaction fee</td>\n</tr>\n<tr>\n<td>data.currency</td>\n<td>string</td>\n<td>transaction currency</td>\n</tr>\n<tr>\n<td>data.status</td>\n<td>string</td>\n<td>transaction status. This can success or failed</td>\n</tr>\n<tr>\n<td>data.reference</td>\n<td>string</td>\n<td>transaction reference</td>\n</tr>\n</tbody>\n</table>\n</div><h1 id=\"errors\">Errors</h1>\n<p>Korapay API errors are expressed as a combination of HTTP status codes and an accompanying JSON body providing required detail where possible.</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"status\": false,\n    \"message\": \"Invalid request data\",\n    \"data\": {\n        \"amount\": {\n            \"message\": \"amount is required\",\n            \"customErrorMessage\": \"amount is required\"\n        }\n    }\n}\n\n</code></pre>\n<hr>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"status\": false,\n    \"message\": \"insufficient funds in wallet balance.\",\n    \"data\": null\n}\n\n</code></pre>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Field</strong></th>\n<th></th>\n<th><strong>Description</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>A boolean that lets you know if the request was successful or not.</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>A summary of the response bases on the status. For example, when the request is caused by a validation error, the message will read <strong>Invalid request data</strong> however when it's not a validation error, the message would hold the actual error for example, <strong>Insufficient funds</strong></td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>This contains the information specific to the error. For validation errors, the data would contain the key that failed validation and the <strong>key.message</strong> would contain the actual reason why the validation failed</td>\n</tr>\n</tbody>\n</table>\n</div><h3 id=\"http-status-codes\">HTTP Status Codes</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Status code</strong></th>\n<th><strong>Description</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>200,201</td>\n<td>This indicates that the request was successfully made and the action was carried out. However, check the data object of the response to confirm the status of the charge or verification. This can either be <strong>success</strong>, <strong>failed</strong> or <strong>processing</strong></td>\n</tr>\n<tr>\n<td>400</td>\n<td>This indicates the validation error or client-side error. Check the <strong>message</strong> and <strong>data</strong> object of the response to confirm the exact reason for the error.</td>\n</tr>\n<tr>\n<td>401</td>\n<td>This indicates that the request was not authorized, This can either be caused by an invalid <strong>secret key,</strong> <strong>public key</strong> or an improperly formed authorization header.</td>\n</tr>\n<tr>\n<td>403</td>\n<td>This indicates permission has not been granted to the resource the request is made to.</td>\n</tr>\n<tr>\n<td>404</td>\n<td>This indicates the resource meant to be accessed does not exist.</td>\n</tr>\n<tr>\n<td>409</td>\n<td>This indicates that an action meant to be performed has already been carried out. Verify or query the transaction to confirm the status of the transaction.</td>\n</tr>\n<tr>\n<td>500, 501, 502, 503, 504</td>\n<td>This indicates that the request could not be fulfilled due to an error on Korapay's end. However, this should not happen so kindly report any instance of this error to us.</td>\n</tr>\n</tbody>\n</table>\n</div></body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Get Started","slug":"get-started"},{"content":"Authentication","slug":"authentication"},{"content":"Responses","slug":"responses"},{"content":"Errors","slug":"errors"}],"owner":"303979","collectionId":"052e278e-29e8-4c0c-824c-f34a33acce4b","publishedId":"SVzxXeSM","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"102649","highlight":"2376F3"},"publishDate":"2020-01-29T14:33:54.000Z"},"item":[{"name":"Pay-ins","item":[{"name":"Voucher","item":[{"name":"Charge","id":"b9555381-6105-4fbf-be58-9cb80bedd754","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 100,\n    \"currency\": \"ZAR\",\n    \"merchant_bears_cost\": true,\n    \"notification_url\": \"https://secure.example.com/api/v1/callback/deposit\",\n    \"description\": \"This is a voucher payment\",\n    \"reference\": \"example-unique-reference\",\n    \"voucher\": {\n        \"pin\": \"1168648096792943\",\n        \"phone_number\": \"+270576847568\",\n        \"provider_code\": \"0001\"\n    },\n    \"customer\": {\n        \"email\": \"johndoe@example.com\",\n        \"name\": \"John Doe\"\n    },\n    \"metadata\": {\n        \"key\": \"Value 1\"\n    }\n}\n\n","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.comapi/v1/charge/voucher","urlObject":{"path":["v1","charge","voucher"],"host":["https://api.korapay.comapi"],"query":[],"variable":[]}},"response":[{"id":"4eccec1a-990c-49a4-8870-f958e384a6be","name":"Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 100,\n    \"currency\": \"ZAR\",\n    \"merchant_bears_cost\": true,\n    \"notification_url\": \"https://secure.example.com/api/v1/callback/deposit\",\n    \"description\": \"This is a voucher payment\",\n    \"reference\": \"example-unique-reference\",\n    \"voucher\": {\n        \"pin\": \"1168648096792943\",\n        \"phone_number\": \"+270576847568\",\n        \"provider_code\": \"0001\"\n    },\n    \"customer\": {\n        \"email\": \"johndoe@example.com\",\n        \"name\": \"John Doe\"\n    },\n    \"metadata\": {\n        \"key\": \"Value 1\"\n    }\n}\n\n","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.comapi/v1/charge/voucher"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Charge Successful\",\n    \"data\": {\n        \"currency\": \"ZAR\",\n        \"amount\": 10,\n        \"fee\": 0,\n        \"vat\": 0,\n        \"transaction_reference\": \"KPY-CA-qFNr4bXheKr6\",\n        \"payment_reference\": \"CR-FAGSHHH23737b\",\n        \"status\": \"success\",\n        \"voucher\": {\n            \"serial_number\": \"20251024103152983020\",\n            \"balance\": 10,\n            \"pin\": \"1168648096792943\",\n            \"expiry_date\": \"2026-10-24 10:31:26\"\n        },\n        \"customer\": {\n            \"name\": \"John Doe\",\n            \"email\": \"johndoe@example.com\"\n        }\n    }\n}"},{"id":"c8609804-77bf-4de2-9f3a-db22894a9284","name":"Voucher already used error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 100,\n    \"currency\": \"ZAR\",\n    \"merchant_bears_cost\": true,\n    \"notification_url\": \"https://secure.example.com/api/v1/callback/deposit\",\n    \"description\": \"This is a voucher payment\",\n    \"reference\": \"example-unique-reference\",\n    \"voucher\": {\n        \"pin\": \"1168648096792943\",\n        \"phone_number\": \"+270576847568\",\n        \"provider_code\": \"0001\"\n    },\n    \"customer\": {\n        \"email\": \"johndoe@example.com\",\n        \"name\": \"John Doe\"\n    },\n    \"metadata\": {\n        \"key\": \"Value 1\"\n    }\n}\n\n","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.comapi/v1/charge/voucher"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"The voucher has already been used\",\n    \"data\": null\n}"},{"id":"2fa3ebf2-c347-4328-ac6c-d727c8ef70dc","name":"Amount exceeded error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 100,\n    \"currency\": \"ZAR\",\n    \"merchant_bears_cost\": true,\n    \"notification_url\": \"https://secure.example.com/api/v1/callback/deposit\",\n    \"description\": \"This is a voucher payment\",\n    \"reference\": \"example-unique-reference\",\n    \"voucher\": {\n        \"pin\": \"1168648096792943\",\n        \"phone_number\": \"+270576847568\",\n        \"provider_code\": \"0001\"\n    },\n    \"customer\": {\n        \"email\": \"johndoe@example.com\",\n        \"name\": \"John Doe\"\n    },\n    \"metadata\": {\n        \"key\": \"Value 1\"\n    }\n}\n\n","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.comapi/v1/charge/voucher"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"The amount provided exceeds the required amount\",\n    \"data\": null\n}"},{"id":"c75ac87d-f01c-4518-b9ba-6bc1e484293a","name":"Duplicate payment reference error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 100,\n    \"currency\": \"ZAR\",\n    \"merchant_bears_cost\": true,\n    \"notification_url\": \"https://secure.example.com/api/v1/callback/deposit\",\n    \"description\": \"This is a voucher payment\",\n    \"reference\": \"example-unique-reference\",\n    \"voucher\": {\n        \"pin\": \"1168648096792943\",\n        \"phone_number\": \"+270576847568\",\n        \"provider_code\": \"0001\"\n    },\n    \"customer\": {\n        \"email\": \"johndoe@example.com\",\n        \"name\": \"John Doe\"\n    },\n    \"metadata\": {\n        \"key\": \"Value 1\"\n    }\n}\n\n","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.comapi/v1/charge/voucher"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Duplicate payment reference\",\n    \"data\": null\n}"},{"id":"2a713eb3-f36b-4530-a69b-a95617eeff46","name":"Provider not supported error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 100,\n    \"currency\": \"ZAR\",\n    \"merchant_bears_cost\": true,\n    \"notification_url\": \"https://secure.example.com/api/v1/callback/deposit\",\n    \"description\": \"This is a voucher payment\",\n    \"reference\": \"example-unique-reference\",\n    \"voucher\": {\n        \"pin\": \"1168648096792943\",\n        \"phone_number\": \"+270576847568\",\n        \"provider_code\": \"0001\"\n    },\n    \"customer\": {\n        \"email\": \"johndoe@example.com\",\n        \"name\": \"John Doe\"\n    },\n    \"metadata\": {\n        \"key\": \"Value 1\"\n    }\n}\n\n","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.comapi/v1/charge/voucher"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"The selected provider is not supported\",\n    \"data\": null\n}"},{"id":"2e59fb25-dd0f-4b67-94f8-2c73814ebff9","name":"Invalid voucher PIN error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 100,\n    \"currency\": \"ZAR\",\n    \"merchant_bears_cost\": true,\n    \"notification_url\": \"https://secure.example.com/api/v1/callback/deposit\",\n    \"description\": \"This is a voucher payment\",\n    \"reference\": \"example-unique-reference\",\n    \"voucher\": {\n        \"pin\": \"1168648096792943\",\n        \"phone_number\": \"+270576847568\",\n        \"provider_code\": \"0001\"\n    },\n    \"customer\": {\n        \"email\": \"johndoe@example.com\",\n        \"name\": \"John Doe\"\n    },\n    \"metadata\": {\n        \"key\": \"Value 1\"\n    }\n}\n\n","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.comapi/v1/charge/voucher"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"The voucher pin you have entered is invalid\",\n    \"data\": null\n}"}],"_postman_id":"b9555381-6105-4fbf-be58-9cb80bedd754"}],"id":"fc959682-553b-4ced-bb38-66f9141c2251","description":"<p>Kora’s Voucher Payments allow merchants to accept payments from customers using prepaid voucher codes or PINs. This solution is specifically designed to reach unbanked and underbanked customers in markets with low card penetration, enabling them to purchase vouchers through offline or alternative digital channels.</p>\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"_postman_id":"fc959682-553b-4ced-bb38-66f9141c2251"},{"name":"Card","item":[{"name":"Charge Card - step 1","id":"949d18c3-b1f5-4022-8ec2-feb7784297b9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"charge_data\": \"0e4ac0875daffa6d0538c4948126bf13:b78c21dc2314cf947cb0a514b1a6c865c3e0a0ff59c654c21f1e2b81d1a6a893dab2a716a72725f8af08a367f19b198733ba67e8e42cd6a9866ff005f937159fa1697c78174c1405b6fd987d419bdb5da8c3a825ffe5c5b0756239f9b7e29c256fd455e21cd20af9f442985d98d31b148ccc5a088295d8110f6ecc33400ecd78ca0f2a45048c651d061bc16574501e48496a2c4e6bd0068d16baf7f1cd4170eea07b7939e884df7991e340c8c76bf2b6648c9eed203be30577463b695dff1ec99df5a587b9e4cf6e9398a7f269b382562135c917f808c1170876aa9800ab4decf59c97a5fe89305a3f29f5cdf7a57b54104ca71494677635c2cb18c5ee2860aa8c9aa941be0d17cef43ad20af68bf6d8dad0a0b2965cfe8b9b313063c9e475a659624375418d173b08e8b840a922b710cd2f:a44dd109d10925ee0ecc65f2e8012b68\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/card","description":"<p>The endpoint requires that your encrypt the JOSN payload before making the request. See the <a href=\"https://developers.korapay.com/docs/accepting-card-payments-with-apis\">guide here</a> for more detail on encryption.</p>\n<h2 id=\"request-body\">Request Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>charge_data</td>\n<td>string</td>\n<td><code>Required</code> Encrypted charge data</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"successful-response-body\">Successful Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>Request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>Request status message</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>The object containing charge details</td>\n</tr>\n<tr>\n<td>amount</td>\n<td>number</td>\n<td>Amount to charge</td>\n</tr>\n<tr>\n<td>amount_charged</td>\n<td>number</td>\n<td>Total amount charged</td>\n</tr>\n<tr>\n<td>auth_model</td>\n<td>string</td>\n<td>The authentication model to be used to complete charge e.g <code>OTP</code>, <code>3DS</code>, <code>AVS</code>, <code>PIN</code></td>\n</tr>\n<tr>\n<td>currency</td>\n<td>string</td>\n<td>The currency for the charge</td>\n</tr>\n<tr>\n<td>fee</td>\n<td>number</td>\n<td>The fee charged for this transaction</td>\n</tr>\n<tr>\n<td>vat</td>\n<td>number</td>\n<td>The value added tax for this transaction</td>\n</tr>\n<tr>\n<td>response_message</td>\n<td>string</td>\n<td>The response message of the transaction</td>\n</tr>\n<tr>\n<td>payment_reference</td>\n<td>string</td>\n<td>The reference for this payment</td>\n</tr>\n<tr>\n<td>transaction_reference</td>\n<td>string</td>\n<td>The reference for each attempted transaction</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>The status of the transaction e.g <code>success</code>, <code>processing</code>, <code>failed</code></td>\n</tr>\n<tr>\n<td>card</td>\n<td>object</td>\n<td>object holding the card details</td>\n</tr>\n<tr>\n<td>payment_reference</td>\n<td>string</td>\n<td>The reference for this payment</td>\n</tr>\n<tr>\n<td>card_type</td>\n<td>string</td>\n<td>The card type issuer e.g <code>mastercard</code>, <code>visa</code>, <code>verve</code></td>\n</tr>\n<tr>\n<td>first_six</td>\n<td>string</td>\n<td>The first six digits of the card also known as <code>BIN</code></td>\n</tr>\n<tr>\n<td>last_four</td>\n<td>string</td>\n<td>The last four digit of the card</td>\n</tr>\n<tr>\n<td>expiry</td>\n<td>string</td>\n<td>The card expiry date formatted as <code>MM/YY</code></td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"failed-response-body\">Failed Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>Request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>Request status message</td>\n</tr>\n<tr>\n<td>code</td>\n<td>string</td>\n<td>Encrypted payment data</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>object containing extra information about the error</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","charges","card"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"245213a7-e84a-4192-9c6f-8f19c4022d4e","name":"Charge Card - OTP Required","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"charge_data\":\"AvPGTphmuBjcsrwsqqxLFowtIWaAw3WRlEZUH44sNbu7Bw2cC4ChAVS5KVuJsCxZfAmFAYbIEMV83O8bsTKDVTEf40TsxnDGePT9Pn8iOMqNdKbYSA7C5WZ0XVeNu+YMG9h54KSN6Fiv4mVSS55yqIVcAwI1kLnBay62r3qGyqyIG4TPzwOhwJWyWhdpSu8LN1kskICPVcs2xXy9Uj/1fSlOR5e3ZI8V\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/card"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"444"},{"key":"ETag","value":"W/\"1bc-Xt3Zv/70nLgXh0QWA46/8Rtdf50\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Date","value":"Wed, 04 Aug 2021 15:12:23 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Charge in progress\",\n    \"data\": {\n        \"amount\": 200,\n        \"amount_charged\": 200,\n        \"auth_model\": \"OTP\",\n        \"currency\": \"NGN\",\n        \"fee\": 2.6,\n        \"vat\": 0.2,\n        \"response_message\": \"Please enter the OTP sent to your mobile number 080****** and email te**@rave**.com\",\n        \"payment_reference\": \"your-transaction-reference-001\",\n        \"status\": \"processing\",\n        \"transaction_reference\": \"KPY-CA-b5Mit73shYeQ\",\n        \"card\": {\n            \"card_type\": \"mastercard\",\n            \"first_six\": \"539983\",\n            \"last_four\": \"8381\",\n            \"expiry\": \"10/31\"\n        }\n    }\n}"},{"id":"f6f34476-e2af-40a6-863e-c80b11688d0e","name":"Charge Card - PIN Required","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"charge_data\": \"AvPGTphmuBjcsrwsqqxLFowtIWaAw3WRcG6JhiSPzevVkIj6O6F9PxWupQJAReFuqGMe4mLncd7yjqAw716/ZNI/5wEzonU6nv9RDpjp2+3HTVdaLL8bgZ56lPGePG4+F2donzfDjkLpB8yXoZbxjB47Rq2caZV4Oa8fLIH7ueFYEn0m2fXL6cEtvS2pUsgh/sSUT0jGh1o=\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/card"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"374"},{"key":"ETag","value":"W/\"176-VE/en1NukLRQHaNbVTx5XVS41Vs\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Date","value":"Wed, 04 Aug 2021 15:11:14 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Charge in progress\",\n    \"data\": {\n        \"amount\": 200,\n        \"amount_charged\": 200,\n        \"auth_model\": \"PIN\",\n        \"currency\": \"NGN\",\n        \"fee\": 2.6,\n        \"vat\": 0.2,\n        \"response_message\": \"Card pin required\",\n        \"payment_reference\": \"your-transaction-reference-001\",\n        \"status\": \"pending\",\n        \"transaction_reference\": \"KPY-CA-aZvnjyUKQJ2r\",\n        \"card\": {\n            \"card_type\": \"mastercard\",\n            \"first_six\": \"539983\",\n            \"last_four\": \"8381\",\n            \"expiry\": \"10/31\"\n        }\n    }\n}"},{"id":"3a98516e-3a05-4191-b427-21e00a72e81e","name":"Charge Card -  Request Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"charge_data\": \"AvPGTphmuBjX41JA9onWPGzL+/lXDPAzjC0hZoDDdZHk7v0sHFZTJtI/5wEzonU6nv9RDpjp2+3HTVdaLL8bgZ56lPGePG4+F2donzfDjkLpB8yXoZbxjB47Rq2caZV4Oa8fLIH7ueFYEn0m2fXL6cEtvS2pUsgh/sSUT0jGh1o=\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/card"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"244"},{"key":"ETag","value":"W/\"f4-mOuY6E9qcSPyYX0Qd1TDsLO/+Rs\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Date","value":"Wed, 04 Aug 2021 15:10:04 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"code\": null,\n    \"message\": \"Invalid request data\",\n    \"data\": {\n        \"currency\": {\n            \"message\": \"currency is required\",\n            \"customErrorMessage\": \"currency is required\"\n        },\n        \"amount\": {\n            \"message\": \"amount is required\",\n            \"customErrorMessage\": \"amount is required\"\n        }\n    }\n}"},{"id":"e3d66ff1-5c51-4e06-a746-5f955a2ffb23","name":"Charge Card - Duplicate reference","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"charge_data\": \"AvPGTphmuBjX41JA9onWPGzL+/lXDPAzjC0hZoDDdZFwbomGJI/N69WQiPo7oX0/Fa6lAkBF4W6oYx7iYudx3vKOoDDvXr9k0j/nATOidTqe/1EOmOnb7cdNV1osvxuBnnqU8Z48bj4XZ2ifN8OOQukHzJehlvGMHjtGrZxplXg5rx8sgfu54VgSfSbZ9cvpwS29LalSyCH+xJRPSMaHWg==\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/card"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"77"},{"key":"ETag","value":"W/\"4d-4FZMPZ0WDV2ps1xseR8WVuEQDtQ\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Date","value":"Wed, 04 Aug 2021 15:10:41 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"code\": null,\n    \"message\": \"Duplicate payment reference\",\n    \"data\": {}\n}"},{"id":"e4279530-36af-4099-92ef-8380e8fe77d2","name":"Charge Card - invalid charge data","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"charge_data\": \"123456\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/card"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"119"},{"key":"ETag","value":"W/\"77-cs+UWgZDdLhxBZSKyXLvPyLTjF8\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Date","value":"Wed, 04 Aug 2021 15:10:22 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"code\": null,\n    \"message\": \"Unable to decrypt charge data, please check encryption and try again\",\n    \"data\": {}\n}"}],"_postman_id":"949d18c3-b1f5-4022-8ec2-feb7784297b9"},{"name":"Authorize Card Charge - step 2","id":"722e9579-00db-41fe-9e52-87afe97ba911","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"transaction_reference\": \"KPY-CA-k1jSSmC1GXue\",\n    \"authorization\": {\n        \"pin\": \"1234\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/card/authorize","description":"<p>This endpoint is used to complete the charge if extra authorization is required. Authorization required could be PIN, OTP, or 3DS. Follow the <a href=\"https://developers.korapay.com/docs/accepting-card-payments-with-apis#step-4-authorize-card-transaction\">guide here</a> for details</p>\n<h2 id=\"request-body\">Request Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>transaction_reference</td>\n<td>string</td>\n<td><code>Required</code> The reference gotten from the previous <code>charge request</code></td>\n</tr>\n<tr>\n<td>authorization</td>\n<td>object</td>\n<td><code>Required</code> The object containing details for authorization</td>\n</tr>\n<tr>\n<td>pin</td>\n<td>string</td>\n<td>Transaction pin of the card to charge if the auth_model is <code>PIN</code></td>\n</tr>\n<tr>\n<td>otp</td>\n<td>string</td>\n<td>one time password to be used to complete the request if the auth_model is <code>OTP</code></td>\n</tr>\n<tr>\n<td>avs</td>\n<td>object</td>\n<td>object containing AVS details. This should be present if the auth_model is <code>AVS</code></td>\n</tr>\n<tr>\n<td>state</td>\n<td>string</td>\n<td>The state registered with the card. Required if auth_mode is <code>AVS</code></td>\n</tr>\n<tr>\n<td>city</td>\n<td>string</td>\n<td>The city registered with the card. Required if auth_mode is <code>AVS</code></td>\n</tr>\n<tr>\n<td>country</td>\n<td>string</td>\n<td>The country registered with the card. Required if auth_mode is <code>AVS</code></td>\n</tr>\n<tr>\n<td>address</td>\n<td>string</td>\n<td>The address registered with the card. Required if auth_mode is <code>AVS</code></td>\n</tr>\n<tr>\n<td>zip_codes</td>\n<td>string</td>\n<td>The zip code registered with the card. Required if auth_mode is <code>AVS</code></td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"successful-response-body\">Successful Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>Request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>Request status message</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>object containing charge details</td>\n</tr>\n<tr>\n<td>amount</td>\n<td>number</td>\n<td>Amount to charge</td>\n</tr>\n<tr>\n<td>amount_charged</td>\n<td>number</td>\n<td>Total amount charged</td>\n</tr>\n<tr>\n<td>auth_model</td>\n<td>string</td>\n<td>The authentication model to be used to complete charge e.g <code>OTP</code>, <code>3DS</code>, <code>AVS</code>, <code>PIN</code></td>\n</tr>\n<tr>\n<td>currency</td>\n<td>string</td>\n<td>The currency for the charge</td>\n</tr>\n<tr>\n<td>fee</td>\n<td>number</td>\n<td>The fee charged for this transaction</td>\n</tr>\n<tr>\n<td>vat</td>\n<td>number</td>\n<td>The value added tax for this transaction</td>\n</tr>\n<tr>\n<td>response_message</td>\n<td>string</td>\n<td>The response message of the transaction</td>\n</tr>\n<tr>\n<td>payment_reference</td>\n<td>string</td>\n<td>The reference for this payment</td>\n</tr>\n<tr>\n<td>transaction_reference</td>\n<td>string</td>\n<td>The reference for each attempted transaction</td>\n</tr>\n<tr>\n<td>payment_reference</td>\n<td>string</td>\n<td>The reference for this payment</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>The status of the transaction e.g <code>success</code>, <code>processing</code>, <code>failed</code></td>\n</tr>\n<tr>\n<td>card</td>\n<td>object</td>\n<td>object holding the card details</td>\n</tr>\n<tr>\n<td>card_type</td>\n<td>string</td>\n<td>The card type issuer e.g <code>mastercard</code>, <code>visa</code>, <code>verve</code></td>\n</tr>\n<tr>\n<td>first_six</td>\n<td>string</td>\n<td>The first six digits of the card also known as <code>BIN</code></td>\n</tr>\n<tr>\n<td>last_four</td>\n<td>string</td>\n<td>The last four digit of the card</td>\n</tr>\n<tr>\n<td>expiry</td>\n<td>string</td>\n<td>The card expiry date formatted as <code>MM/YY</code></td>\n</tr>\n<tr>\n<td>authorizaton</td>\n<td>object</td>\n<td>Object contain extra authorization step if required</td>\n</tr>\n<tr>\n<td>redirect_url</td>\n<td>string</td>\n<td>A url to complete transaction. This is necessary for 3DS transaction</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","charges","card","authorize"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"8cd2a04e-50c3-4cdd-a3a6-4fd7b6b775bb","name":"Authorize Card Charge - step 2","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"transaction_reference\": \"KPY-CA-Te6FzKCU2Uns\",\n    \"authorization\": {\n        \"pin\": \"1234\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/card/authorize"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Charge in progress\",\n    \"data\": {\n        \"amount\": 100,\n        \"amount_charged\": 100,\n        \"auth_model\": \"OTP\",\n        \"currency\": \"NGN\",\n        \"fee\": 1.5,\n        \"vat\": 0.11,\n        \"response_message\": \"Kindly enter the OTP sent to 234816***7983\",\n        \"payment_reference\": \"your-transaction-reference-001\",\n        \"status\": \"processing\",\n        \"transaction_reference\": \"KPY-CA-Te6FzKCU2Uns\",\n        \"authorization\": {\n            \"required_fields\": [\n                \"otp\"\n            ]\n        },\n        \"metadata\": {\n            \"gateway_code\": \"T0\",\n            \"can_resend_otp\": true,\n            \"otp_attempts_left\": 3,\n            \"support_message\": \"Didn't get the OTP? Dial *322*0# on your phone (MTN, Etisalat, Airtel) Glo, use *805*0#.\"\n        },\n        \"card\": {\n            \"card_type\": \"mastercard\",\n            \"first_six\": \"539923\",\n            \"last_four\": \"0281\",\n            \"expiry\": \"12/24\"\n        }\n    }\n}"},{"id":"010ebea1-2c4f-4277-a564-7d76722d5671","name":"Authorize Card Charge - Authorization Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"transaction_reference\": \"KPY-CA-Te6FzKCU2Uns\",\n    \"authorization\": {\n        \"otp\": \"12345\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charge/card/authorize"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.14.0 (Ubuntu)"},{"key":"Date","value":"Mon, 16 Aug 2021 22:19:00 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"423"},{"key":"Connection","value":"keep-alive"},{"key":"x-powered-by","value":"Express"},{"key":"access-control-allow-origin","value":"*"},{"key":"www-environment","value":"live"},{"key":"etag","value":"W/\"1a7-Y7kHZnv6TF8O/xxCl/W3L1PEAtI\""},{"key":"vary","value":"Accept-Encoding"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Card charged successfully\",\n    \"data\": {\n        \"amount\": 100,\n        \"amount_charged\": 100,\n        \"auth_model\": \"OTP\",\n        \"currency\": \"NGN\",\n        \"fee\": 1.3,\n        \"vat\": 0.1,\n        \"response_message\": \"Card charged successfully\",\n        \"payment_reference\": \"your-transaction-reference-001\",\n        \"status\": \"success\",\n        \"transaction_reference\": \"KPY-CA-Te6FzKCU2Uns\",\n        \"authorization\": {},\n        \"card\": {\n            \"card_type\": \"mastercard\",\n            \"first_six\": \"553188\",\n            \"last_four\": \"2950\",\n            \"expiry\": \"09/32\"\n        }\n    }\n}"},{"id":"78acf3ca-35be-4282-be2b-cfd8169169b1","name":"Authorize Card Charge - Authorization Failed","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"transaction_reference\": \"KPY-CA-Te6FzKCU2Uns\",\n    \"authorization\": {\n        \"otp\": \"12345\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charge/card/authorize"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.14.0 (Ubuntu)"},{"key":"Date","value":"Mon, 16 Aug 2021 22:19:00 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"423"},{"key":"Connection","value":"keep-alive"},{"key":"x-powered-by","value":"Express"},{"key":"access-control-allow-origin","value":"*"},{"key":"www-environment","value":"live"},{"key":"etag","value":"W/\"1a7-Y7kHZnv6TF8O/xxCl/W3L1PEAtI\""},{"key":"vary","value":"Accept-Encoding"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Card charged successfully\",\n    \"data\": {\n        \"amount\": 100,\n        \"amount_charged\": 100,\n        \"auth_model\": \"OTP\",\n        \"currency\": \"NGN\",\n        \"fee\": 1.3,\n        \"vat\": 0.1,\n        \"response_message\": \"insufficient fund\",\n        \"payment_reference\": \"your-transaction-reference-001\",\n        \"status\": \"failed\",\n        \"transaction_reference\": \"KPY-CA-Te6FzKCU2Uns\",\n        \"card\": {\n            \"card_type\": \"mastercard\",\n            \"first_six\": \"553188\",\n            \"last_four\": \"2950\",\n            \"expiry\": \"09/32\"\n        }\n    }\n}"},{"id":"e5074e7d-1c89-4cb2-ad09-e4f78d653958","name":"Authorize Card Charge -  Request Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"authorization\": {\n        \"pin\": \"1234\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/card/authorize"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"bad_request\",\n    \"message\": \"invalid request data\",\n    \"data\": {\n        \"transaction_reference\": {\n            \"message\": \"transaction_reference is required\",\n            \"customErrorMessage\": \"transaction_reference is required\"\n        }\n    }\n}"}],"_postman_id":"722e9579-00db-41fe-9e52-87afe97ba911"},{"name":"Resend OTP","id":"fd605d5b-0a1d-4825-94ef-382f5f269667","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"transaction_reference\": \"KPY-CA-m9XzUbv4KytR\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/card/resend-otp","description":"<p>This endpoint allows you to resend otp in situation where the initial otp recieved has expired or was not recieved at all.</p>\n","urlObject":{"path":["merchant","api","v1","charges","card","resend-otp"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"7d2abe8a-1df5-4f6b-a7b6-71beafcbebba","name":"Resend OTP - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"transaction_reference\": \"KPY-CA-RXc7xSxCx86q\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/card/resend-otp"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 02 May 2023 15:39:26 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"Express"},{"key":"access-control-allow-origin","value":"*"},{"key":"www-environment","value":"live"},{"key":"etag","value":"W/\"11d-PwxL4fvE7gBt/rHqykhusc3h4w0\""},{"key":"vary","value":"Accept-Encoding"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7c115b64999c75a5-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Otp sent successfully\",\n    \"data\": {\n        \"status\": \"processing\",\n        \"response_message\": \"Kindly enter the One-time PIN (OTP) sent to your phone number\",\n        \"metadata\": {\n            \"support_message\": \"Didn't get the OTP? Dial *322*0# on your phone (MTN, Etisalat, Airtel) Glo, use *805*0#.\"\n        }\n    }\n}"},{"id":"3552ef06-ebb6-4b50-b04e-1a43a4182ad4","name":"Resend OTP - Request Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"transaction_reference\": \"KPY-CA-m9XzUbv4KytR\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/card/resend-otp"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 02 May 2023 14:49:46 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"260"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"Express"},{"key":"access-control-allow-origin","value":"*"},{"key":"www-environment","value":"live"},{"key":"etag","value":"W/\"104-5NZUImB1YjZ3oqhEHccm1QvjmMI\""},{"key":"vary","value":"Accept-Encoding"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7c11129f3982dc2d-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"bad_request\",\n    \"message\": \"invalid request data\",\n    \"data\": {\n        \"transaction_reference\": {\n            \"message\": \"transaction_reference is required\",\n            \"customErrorMessage\": \"transaction_reference is required\"\n        },\n        \"reference\": {\n            \"message\": \"reference is not allowed\"\n        }\n    }\n}"},{"id":"e2a6f90c-3dc2-4876-8d93-24a1c8f28e47","name":"Resend OTP - Transaction Completed","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"transaction_reference\": \"KPY-CA-m9XzUbv4KytR\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/card/resend-otp"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 02 May 2023 14:50:35 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"79"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"Express"},{"key":"access-control-allow-origin","value":"*"},{"key":"www-environment","value":"live"},{"key":"etag","value":"W/\"4f-euaCOAd9egILDKIGRE4KfzvZCcI\""},{"key":"vary","value":"Accept-Encoding"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7c1113d0f823dc2d-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Transaction has already been completed\",\n    \"data\": null\n}"},{"id":"dee57a62-2e63-467b-872f-22ac32877323","name":"Resend OTP - Transaction not found","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"transaction_reference\": \"KPY-CA-m9XzUbM4KytR\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/card/resend-otp"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 02 May 2023 14:51:48 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"Express"},{"key":"access-control-allow-origin","value":"*"},{"key":"www-environment","value":"live"},{"key":"etag","value":"W/\"3e-re5O+dy+chOupEj1K4crEq6aw2E\""},{"key":"vary","value":"Accept-Encoding"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7c11159e8963dc2d-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Transaction not found\",\n    \"data\": null\n}"}],"_postman_id":"fd605d5b-0a1d-4825-94ef-382f5f269667"}],"id":"ed410590-f9c0-4a41-94da-4fd083c50ccb","description":"<p>Card payments make up one of the most convenient ways customers pay online. Korapay supports major card schemes and enables you to receive debit card payments from your customers. The following APIs are specific to charging cards</p>\n","_postman_id":"ed410590-f9c0-4a41-94da-4fd083c50ccb","auth":{"type":"noauth","isInherited":true,"source":{"_postman_id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","name":"Pay-ins","type":"folder"}}},{"name":"Bank Transfer","item":[{"name":"Bank Transfer","id":"442648d8-0e6b-47b5-9e82-0fc73ba0b210","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"account_name\": \"Demo account\",\n    \"amount\": 1500,\n    \"currency\": \"NGN\",\n    \"reference\": \"your-transaction-reference-001\",\n    \"customer\": {\n        \"name\": \"John Doe\",\n        \"email\": \"johndoe@gmail.com\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/bank-transfer","description":"<p>This API allows you to create a virtual account for your customers to perform a one-time payment.</p>\n","urlObject":{"path":["merchant","api","v1","charges","bank-transfer"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"3033f392-9cd9-4670-9a37-74af9613785c","name":"Bank Transfer - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"account_name\": \"Demo account\",\n    \"amount\": 1500,\n    \"currency\": \"NGN\",\n    \"reference\": \"your-transaction-reference-001\",\n    \"customer\": {\n        \"name\": \"John Doe\",\n        \"email\": \"johndoe@gmail.com\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/bank-transfer"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 05 Jun 2023 15:58:09 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"200-H1nkhoBYn0zZWuyONP8H1tDUpIU\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Content-Security-Policy","value":"frame-ancestors 'none'"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7d299d802dd2418b-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Bank transfer initiated successfully\",\n    \"data\": {\n        \"currency\": \"NGN\",\n        \"amount\": 1500,\n        \"amount_expected\": 1500,\n        \"fee\": 22.5,\n        \"vat\": 1.69,\n        \"reference\": \"your-transaction-reference-001\",\n        \"payment_reference\": \"your-transaction-reference-001\",\n        \"status\": \"processing\",\n        \"narration\": \"Payment on Demo Merchant\",\n        \"merchant_bears_cost\": true,\n        \"bank_account\": {\n            \"account_name\": \"Demo account\",\n            \"account_number\": \"7590031627\",\n            \"bank_name\": \"wema\",\n            \"bank_code\": \"035\",\n            \"expiry_date_in_utc\": \"2023-06-05T16:58:09.193Z\"\n        },\n        \"customer\": {\n            \"name\": \"John Doe\",\n            \"email\": \"johndoe@gmail.com\"\n        }\n    }\n}"},{"id":"b4529ac8-7734-4fb3-b14f-599ec93752d4","name":"Bank Transfer - Request Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"account_name\": \"Demo account\",\n    \"currency\": \"NGN\",\n    \"reference\": \"your-custom-reference-001\",\n    \"customer\": {\n        \"name\": \"John Doe\",\n        \"email\": \"johndoe@gmail.com\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/bank-transfer"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 05 Jun 2023 19:26:32 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"164"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"a4-S+cukwMiB4IqcKBSxZNq9H+OCcA\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Set-Cookie","value":"__cf_bm=aRyuyD8tJqtyI0GviMNYykSiVQPuItmb8ueRFDFPdiA-1685993192-0-AaK5Tp0xdya5qKV0kHrGsSMVMjRe4R1XB35oCp7bwGt43sIEWRXoH7O8Hu4paavKy/bq2qqcRi/felwCzBc1dBA=; path=/; expires=Mon, 05-Jun-23 19:56:32 GMT; domain=.korapay.com; HttpOnly; Secure; SameSite=None"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7d2acecb499271e1-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"bad_request\",\n    \"message\": \"invalid request data\",\n    \"data\": {\n        \"amount\": {\n            \"message\": \"amount is required\",\n            \"customErrorMessage\": \"amount is required\"\n        }\n    }\n}"},{"id":"0b858e2a-8730-49f6-9d98-b517c071076d","name":"Bank Transfer - Duplicate Reference","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"account_name\": \"Demo account\",\n    \"amount\": 1500,\n    \"currency\": \"NGN\",\n    \"reference\": \"your-custom-reference-001\",\n    \"customer\": {\n        \"name\": \"John Doe\",\n        \"email\": \"johndoe@gmail.com\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/bank-transfer"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 05 Jun 2023 19:27:30 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"83"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"53-Jw763a/WHHXKpJC1At63iv/g3n0\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7d2ad0365b1a71e1-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"code\": \"AA021\",\n    \"message\": \"duplicate payment reference\",\n    \"data\": null\n}"}],"_postman_id":"442648d8-0e6b-47b5-9e82-0fc73ba0b210"}],"id":"3b8ab73b-4f8c-4b79-9b9d-2c93cb9cf6a0","description":"<p>One way to accept bank transfer payments is by using our Bank Transfer API. For more detailed guidance on how to use this API <a href=\"https://developers.korapay.com/docs/bank-transfers\">see here</a></p>\n","_postman_id":"3b8ab73b-4f8c-4b79-9b9d-2c93cb9cf6a0","auth":{"type":"noauth","isInherited":true,"source":{"_postman_id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","name":"Pay-ins","type":"folder"}}},{"name":"Virtual Bank Account","item":[{"name":"Create a Virtual Bank Account","id":"758aa9ef-c9cd-41b0-86d7-b71f53990f74","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"account_name\": \"Steph James testing company\",\n    \"account_reference\": \"your-account-reference-087\",\n    \"permanent\": true,\n    \"bank_code\": \"035\",\n    \"customer\": {\n        \"name\": \"John Doe\",\n        \"email\": \"don_alpha@email.com\"\n    },\n    \"kyc\": {\n        \"bvn\": \"11111111111\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/virtual-bank-account","description":"<p>This endpoint is used to create a virtual account. Pass your secret key in your authorization headers and the request parameters as shown below</p>\n","urlObject":{"path":["merchant","api","v1","virtual-bank-account"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"6b9722cc-d53f-4671-a855-562648ac81c8","name":"Create a Virtual Bank Account - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"account_name\": \"Steph James\",\n    \"account_reference\": \"your-account-reference-001\",\n    \"permanent\": true,\n    \"bank_code\": \"035\",\n    \"customer\": {\n        \"name\": \"Don Alpha\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/virtual-bank-account"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"Sucuri/Cloudproxy"},{"key":"Date","value":"Wed, 15 Sep 2021 11:05:51 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"362"},{"key":"Connection","value":"keep-alive"},{"key":"X-Sucuri-ID","value":"15002"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"16a-WVS87hXClb3LV4SujHGZwkYjB+w\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Content-Security-Policy","value":"frame-ancestors 'none'"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Virtual bank account created successfully\",\n    \"data\": {\n        \"account_name\": \"Steph James\",\n        \"account_number\": \"2341240011\",\n        \"bank_code\": \"035\",\n        \"bank_name\": \"Wema Bank\",\n        \"account_reference\": \"your-account-reference-001\",\n        \"unique_id\": \"KPY-VA-ab12cd34ef56\",\n        \"account_status\": \"active\",\n        \"created_at\": \"2021-09-15T11:05:51.428Z\",\n        \"currency\": \"NGN\",\n        \"customer\": {\n            \"name\": \"Don Alpha\"\n        }\n    }\n}"},{"id":"50cb46c9-cb19-4257-8b82-ea47aa91444c","name":"Create a Virtual Bank Account – Duplicate account reference","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"account_name\": \"Steph James\",\n    \"account_reference\": \"your-account-reference-002\",\n    \"permanent\": true,\n    \"bank_code\": \"035\",\n    \"customer\": {\n        \"name\": \"Don Alpha\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/virtual-bank-account"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.14.0 (Ubuntu)"},{"key":"Date","value":"Tue, 10 Aug 2021 21:47:07 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"78"},{"key":"Connection","value":"keep-alive"},{"key":"x-powered-by","value":"Express"},{"key":"access-control-allow-origin","value":"*"},{"key":"www-environment","value":"live"},{"key":"etag","value":"W/\"4e-cZEWDlMDvySZXZXiRi7Q/rXgaIU\""},{"key":"vary","value":"Accept-Encoding"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"code\": null,\n    \"message\": \"Duplicate account reference\",\n    \"data\": {}\n}"},{"id":"c6765c4f-8ce0-436d-9ed7-79f43a71b723","name":"Create a Virtual Bank Account - Request Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"account_name\": \"Steph James\",\n    \"permanent\": true,\n    \"bank_code\": \"035\",\n    \"customer\": {\n        \"name\": \"Don Alpha\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/virtual-bank-account"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"bad_request\",\n    \"message\": \"invalid request data\",\n    \"data\": {\n        \"amount\": {\n            \"message\": \"account_reference is required\",\n            \"customErrorMessage\": \"account_reference is required\"\n        }\n    }\n}"},{"id":"2c818271-125c-407e-a1cc-3814e96842ec","name":"Create a Virtual Bank Account: USD - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"currency\": \"USD\",\n    \"account_holder_reference\": \"KPY-AH-EKf82jtn6z3696V\",\n    \"account_reference\": \"AcmWYgVOoq3xkm51\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/virtual-bank-account"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Virtual bank account created successfully\",\n    \"data\": {\n        \"tier\": 1,\n        \"account_reference\": \"AcmWYgVOoq3xkm5\",\n        \"unique_id\": \"KPY-VA-28JuIvAXN864uA9\",\n        \"account_status\": \"pending\",\n        \"created_at\": \"2024-01-02T09:50:14.075Z\",\n        \"currency\": \"USD\",\n        \"account_holder_reference\": \"KPY-AH-AcmWYgVOoq3xkm5\"\n    }\n}"},{"id":"aa5f1768-bc1d-45fb-9b0d-de0df47809b8","name":"Create a Virtual Bank Account: USD - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"currency\": \"USD\",\n    \"account_holder_reference\": \"KPY-AH-EKf82jtn6z3696V\",\n    \"account_reference\": \"AcmWYgVOoq3xkm51\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/virtual-bank-account"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Virtual bank account created successfully\",\n    \"data\": {\n        \"tier\": 1,\n        \"account_reference\": \"AcmWYgVOoq3xkm5\",\n        \"unique_id\": \"KPY-VA-28JuIvAXN864uA9\",\n        \"account_status\": \"pending\",\n        \"created_at\": \"2024-01-02T09:50:14.075Z\",\n        \"currency\": \"USD\",\n        \"account_holder_reference\": \"KPY-AH-AcmWYgVOoq3xkm5\"\n    }\n}"}],"_postman_id":"758aa9ef-c9cd-41b0-86d7-b71f53990f74"},{"name":"Get a Virtual Bank Account Details","id":"972e66eb-d625-4510-ad60-67e9709b7d04","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.korapay.com/merchant/api/v1/virtual-bank-account/:accountReference","description":"<p>This API allows you to retrieve the details of a virual account.</p>\n","urlObject":{"path":["merchant","api","v1","virtual-bank-account",":accountReference"],"host":["https://api.korapay.com"],"query":[],"variable":[{"description":{"content":"<p>The virtual account reference</p>\n","type":"text/plain"},"type":"any","value":"your-account-reference-001","key":"accountReference"}]}},"response":[{"id":"a7d7c5e1-4e52-42b8-9e12-74bdb148e97d","name":"Get a Virtual Bank Account Details - Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/merchant/api/v1/virtual-bank-account/:account_reference","protocol":"https","host":["api","korapay","com"],"path":["merchant","api","v1","virtual-bank-account",":account_reference"],"variable":[{"key":"account_reference","value":"your-account-reference-001"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"Sucuri/Cloudproxy"},{"key":"Date","value":"Wed, 15 Sep 2021 11:12:14 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"372"},{"key":"Connection","value":"keep-alive"},{"key":"X-Sucuri-ID","value":"15002"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"174-JnIykApjJ2kxiO0GI+r3UrrXy3k\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Content-Security-Policy","value":"frame-ancestors 'none'"},{"key":"X-Sucuri-Cache","value":"MISS"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Virtual bank account retrieved successfully\",\n    \"data\": {\n        \"account_name\": \"Steph James\",\n        \"account_number\": \"7650000006\",\n        \"account_status\": \"active\",\n        \"account_reference\": \"your-account-reference-001\",\n        \"unique_id\": \"KPY-VA-obbdG3JeGVdY\",\n        \"bank_name\": \"wema\",\n        \"bank_code\": \"035\",\n        \"currency\": \"NGN\",\n        \"created_at\": \"2021-09-15T11:05:51.000Z\",\n        \"customer\": {\n            \"name\": \"Don Alpha\",\n            \"email\": null\n        }\n    }\n}"},{"id":"245e310c-e5f3-4d08-b05e-337f296067e3","name":"Get a Virtual Bank Account Details - Not found","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/merchant/api/v1/virtual-bank-account/:account_reference","protocol":"https","host":["api","korapay","com"],"path":["merchant","api","v1","virtual-bank-account",":account_reference"],"variable":[{"key":"account_reference","value":"your-account-reference-001"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.14.0 (Ubuntu)"},{"key":"Date","value":"Tue, 10 Aug 2021 21:48:02 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"81"},{"key":"Connection","value":"keep-alive"},{"key":"x-powered-by","value":"Express"},{"key":"access-control-allow-origin","value":"*"},{"key":"www-environment","value":"live"},{"key":"etag","value":"W/\"51-Z2bknBtS7kKdmzqfqDrEZ50ckdk\""},{"key":"vary","value":"Accept-Encoding"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"code\": null,\n    \"message\": \"Virtual bank account not found\",\n    \"data\": {}\n}"},{"id":"d3edf8ff-e7ab-4e80-b11a-78812d9d7a96","name":"Get a Virtual Bank Account Details: USD - Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/merchant/api/v1/virtual-bank-account/:accountReference","host":["https://api.korapay.com"],"path":["merchant","api","v1","virtual-bank-account",":accountReference"],"variable":[{"key":"accountReference","value":"cjyRM23333338werr0001","description":"The virtual account reference"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Virtual bank account retrieved successfully\",\n    \"data\": {\n        \"account_name\": null,\n        \"account_number\": \"345676551059\",\n        \"account_status\": \"active\",\n        \"account_reference\": \"cjyRM23333338werr0001\",\n        \"unique_id\": \"KPY-VA-j73YGLSh9DYlJHN\",\n        \"iban\": null,\n        \"tier\": 1,\n        \"payment_schemes\": {\n            \"swift\": null,\n            \"ach\": {\n                \"account_holder_name\": \"Fortress\",\n                \"account_number\": \"345676551059\",\n                \"memo\": \"UMA54PR\",\n                \"bank_name\": \"Cross River Bank\",\n                \"routing_code\": \"021214891\"\n            },\n            \"fedwire\": {\n                \"account_holder_name\": \"Fortress\",\n                \"account_number\": \"345676551059\",\n                \"memo\": \"M92PTDT\",\n                \"bank_name\": \"Cross River Bank\",\n                \"routing_code\": \"021214891\",\n                \"account_holder_address\": {\n                    \"city\": \"Lagos\",\n                    \"postal_code\": \"12345\",\n                    \"country_code\": \"NG\",\n                    \"address_line1\": \"Freedom Way St\"\n                },\n                \"bank_address\": {\n                    \"city\": \"Teaneck  \",\n                    \"state\": \"NJ\",\n                    \"postal_code\": \"07666\",\n                    \"country_code\": \"US\",\n                    \"address_line1\": \"885 Teaneck Rd\",\n                    \"address_line2\": \"\"\n                }\n            }\n        },\n        \"account_type\": \"individual\",\n        \"email\": \"james.jona2031@example.com\",\n        \"pending_upgrade_request\": true,\n        \"account_holder\": {\n            \"reference\": \"KPY-AH-ZSlk2c2kq9DUY7F\"\n        },\n        \"bank_code\": null,\n        \"currency\": \"USD\",\n        \"created_at\": \"2024-08-09T08:47:20.000Z\",\n        \"customer\": {\n            \"name\": \"Sarah Doe\",\n            \"email\": \"james.jona2031@example.com\"\n        }\n    }\n}"},{"id":"1ab55da4-e5e9-4c4e-a03b-346e4fb082a5","name":"Get a Virtual Bank Account Details: USD - Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/merchant/api/v1/virtual-bank-account/:accountReference","host":["https://api.korapay.com"],"path":["merchant","api","v1","virtual-bank-account",":accountReference"],"variable":[{"key":"accountReference","value":"cjyRM23333338werr0001","description":"The virtual account reference"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Virtual bank account retrieved successfully\",\n    \"data\": {\n        \"account_name\": null,\n        \"account_number\": \"345676551059\",\n        \"account_status\": \"active\",\n        \"account_reference\": \"cjyRM23333338werr0001\",\n        \"unique_id\": \"KPY-VA-j73YGLSh9DYlJHN\",\n        \"iban\": null,\n        \"tier\": 1,\n        \"payment_schemes\": {\n            \"swift\": null,\n            \"ach\": {\n                \"account_holder_name\": \"Fortress\",\n                \"account_number\": \"345676551059\",\n                \"memo\": \"UMA54PR\",\n                \"bank_name\": \"Cross River Bank\",\n                \"routing_code\": \"021214891\"\n            },\n            \"fedwire\": {\n                \"account_holder_name\": \"Fortress\",\n                \"account_number\": \"345676551059\",\n                \"memo\": \"M92PTDT\",\n                \"bank_name\": \"Cross River Bank\",\n                \"routing_code\": \"021214891\",\n                \"account_holder_address\": {\n                    \"city\": \"Lagos\",\n                    \"postal_code\": \"12345\",\n                    \"country_code\": \"NG\",\n                    \"address_line1\": \"Freedom Way St\"\n                },\n                \"bank_address\": {\n                    \"city\": \"Teaneck  \",\n                    \"state\": \"NJ\",\n                    \"postal_code\": \"07666\",\n                    \"country_code\": \"US\",\n                    \"address_line1\": \"885 Teaneck Rd\",\n                    \"address_line2\": \"\"\n                }\n            }\n        },\n        \"account_type\": \"individual\",\n        \"email\": \"james.jona2031@example.com\",\n        \"pending_upgrade_request\": true,\n        \"account_holder\": {\n            \"reference\": \"KPY-AH-ZSlk2c2kq9DUY7F\"\n        },\n        \"bank_code\": null,\n        \"currency\": \"USD\",\n        \"created_at\": \"2024-08-09T08:47:20.000Z\",\n        \"customer\": {\n            \"name\": \"Sarah Doe\",\n            \"email\": \"james.jona2031@example.com\"\n        }\n    }\n}"}],"_postman_id":"972e66eb-d625-4510-ad60-67e9709b7d04"},{"name":"Get Virtual Bank Account Transactions","id":"2f5c46cc-9e4c-44be-bbed-cb5330dde3f9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.korapay.com/merchant/api/v1/virtual-bank-account/transactions?account_number=7650000006","description":"<p>This API is used to retrieve a list of transaction that has been performed on the virtual account.</p>\n","urlObject":{"path":["merchant","api","v1","virtual-bank-account","transactions"],"host":["https://api.korapay.com"],"query":[{"description":{"content":"<p>The virtual account number</p>\n","type":"text/plain"},"key":"account_number","value":"7650000006"}],"variable":[]}},"response":[{"id":"dacea09f-ddfa-4f52-92ca-e9fd74446293","name":"Get Virtual Bank Account Transactions - Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/merchant/api/v1/virtual-bank-account/transactions?account_number=7650000006","protocol":"https","host":["api","korapay","com"],"path":["merchant","api","v1","virtual-bank-account","transactions"],"query":[{"key":"account_number","value":"7650000006"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 20 May 2022 02:05:40 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"218-0z2MW6CDkAIaOxKEcAxz6fz+ybw\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Content-Security-Policy","value":"frame-ancestors 'none'"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Expect-CT","value":"max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\""},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"70e182309d7003d6-LIS"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Virtual bank account transactions retrieved successfully\",\n    \"data\": {\n        \"total_amount_received\": 1000,\n        \"account_number\": \"7650000006\",\n        \"currency\": \"NGN\",\n        \"transactions\": [\n            {\n                \"reference\": \"KPY-PAY-4l5O8mxmgX2kijp\",\n                \"status\": \"success\",\n                \"amount\": \"1000.00\",\n                \"fee\": \"15.00\",\n                \"currency\": \"NGN\",\n                \"description\": \"Payment by Don Alpha\",\n                \"payer_bank_account\": {\n                    \"account_number\": \"1007408761\",\n                    \"account_name\": \"Steph James\",\n                    \"bank_name\": \"ZENITH BANK\"\n                }\n            }\n        ],\n        \"pagination\": {\n            \"page\": 1,\n            \"total\": 1,\n            \"pageCount\": 1,\n            \"totalPages\": 1\n        }\n    }\n}"},{"id":"aba3aaa9-2aa0-4420-ba89-23b56a7a61c6","name":"Get Virtual Bank Account Transactions - Invalid Virtual Account","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/merchant/api/v1/virtual-bank-account/transactions?account_number=7650000101","protocol":"https","host":["api","korapay","com"],"path":["merchant","api","v1","virtual-bank-account","transactions"],"query":[{"key":"account_number","value":"7650000101"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 21 May 2022 14:56:48 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"45-udQUIbv17u7KQgcyVixCUWhdDFU\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Expect-CT","value":"max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\""},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"70ee292bf8e771e4-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Virtual bank account not found\",\n    \"data\": {}\n}"},{"id":"6119751e-7c68-4960-b293-fd31fa8e0315","name":"Get Virtual Bank Account Transactions: USD - Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/merchant/api/v1/virtual-bank-account/transactions?account_number=390315414374","host":["https://api.korapay.com"],"path":["merchant","api","v1","virtual-bank-account","transactions"],"query":[{"key":"account_number","value":"390315414374","description":"The virtual account number"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Virtual bank account transactions retrieved successfully\",\n    \"data\": {\n        \"total_amount_received\": null,\n        \"account_number\": \"390315414374\",\n        \"currency\": \"USD\",\n        \"transactions\": [\n            {\n                \"reference\": \"KPY-PAY-bPh9XqyshaYipD9\",\n                \"status\": \"success\",\n                \"amount\": \"150.00\",\n                \"fee\": \"5.50\",\n                \"currency\": \"USD\",\n                \"description\": \"Payment to Merchant by Sarah Doe\",\n                \"transaction_date\": \"2024-08-08 16:43:58\",\n                \"payer_bank_account\": {\n                    \"account_number\": \"25847895\",\n                    \"account_name\": \"simulate test\",\n                    \"bank_name\": \"Checking Account\"\n                }\n            },\n            {\n                \"reference\": \"KPY-PAY-18HF92rsGusZv6z\",\n                \"status\": \"flagged\",\n                \"amount\": \"200.00\",\n                \"fee\": \"6.00\",\n                \"currency\": \"USD\",\n                \"description\": \"Payment to Merchant by Sarah Doe\",\n                \"transaction_date\": \"2024-08-08 16:43:58\",\n                \"payer_bank_account\": {\n                    \"account_number\": \"14075361\",\n                    \"account_name\": \"simulate test\",\n                    \"bank_name\": \"Auto Loan Account\"\n                }\n            }\n        ],\n        \"pagination\": {\n            \"page\": 1,\n            \"total\": 2,\n            \"pageCount\": 2,\n            \"totalPages\": 1\n        }\n    }\n}"},{"id":"fb1d2a33-d571-422b-b5ac-300dbbec09f2","name":"Get Virtual Bank Account Transactions - USD","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/merchant/api/v1/virtual-bank-account/transactions?account_number=390315414374","host":["https://api.korapay.com"],"path":["merchant","api","v1","virtual-bank-account","transactions"],"query":[{"key":"account_number","value":"390315414374","description":"The virtual account number"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Virtual bank account transactions retrieved successfully\",\n    \"data\": {\n        \"total_amount_received\": null,\n        \"account_number\": \"390315414374\",\n        \"currency\": \"USD\",\n        \"transactions\": [\n            {\n                \"reference\": \"KPY-PAY-bPh9XqyshaYipD9\",\n                \"status\": \"success\",\n                \"amount\": \"150.00\",\n                \"fee\": \"5.50\",\n                \"currency\": \"USD\",\n                \"description\": \"Payment to Merchant by Sarah Doe\",\n                \"transaction_date\": \"2024-08-08 16:43:58\",\n                \"payer_bank_account\": {\n                    \"account_number\": \"25847895\",\n                    \"account_name\": \"simulate test\",\n                    \"bank_name\": \"Checking Account\"\n                }\n            },\n            {\n                \"reference\": \"KPY-PAY-18HF92rsGusZv6z\",\n                \"status\": \"flagged\",\n                \"amount\": \"200.00\",\n                \"fee\": \"6.00\",\n                \"currency\": \"USD\",\n                \"description\": \"Payment to Merchant by Sarah Doe\",\n                \"transaction_date\": \"2024-08-08 16:43:58\",\n                \"payer_bank_account\": {\n                    \"account_number\": \"14075361\",\n                    \"account_name\": \"simulate test\",\n                    \"bank_name\": \"Auto Loan Account\"\n                }\n            }\n        ],\n        \"pagination\": {\n            \"page\": 1,\n            \"total\": 2,\n            \"pageCount\": 2,\n            \"totalPages\": 1\n        }\n    }\n}"}],"_postman_id":"2f5c46cc-9e4c-44be-bbed-cb5330dde3f9"},{"name":"Credit Sandbox Virtual Bank Account","id":"531895f9-87b9-4f2b-95e8-bfc7a7872deb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"account_number\": \"1110000395\",\n    \"amount\": 100,\n    \"currency\": \"NGN\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/virtual-bank-account/sandbox/credit","description":"<p>This endpoint allows you to test your virtual account by funding it. This API is only available in the sandbox environment.</p>\n","urlObject":{"path":["merchant","api","v1","virtual-bank-account","sandbox","credit"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"08a451a5-639b-43b7-a81c-8c300090bffe","name":"Credit Sandbox Virtual Bank Account - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"account_number\": \"1110000395\",\n    \"amount\": 100,\n    \"currency\": \"NGN\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/virtual-bank-account/sandbox/credit"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 05 Jul 2022 09:28:22 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"52-j+I0id9IpXvkhDnI+4znZJXAfGk\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"Cache-Control","value":"no-store"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Content-Security-Policy","value":"frame-ancestors 'none'"},{"key":"Content-Security-Policy","value":"frame-ancestors 'none'"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Expect-CT","value":"max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\""},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"725f11edfa6bb27e-DUR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Virtual bank account credited successfully\",\n    \"data\": null\n}"},{"id":"a4266578-f257-4a55-ae1e-b2f3f8b6614e","name":"Credit Sandbox Virtual Bank Account: USD - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"account_number\": \"345676551059\",\n    \"amount\": 100,\n    \"currency\": \"USD\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/virtual-bank-account/sandbox/credit"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 05 Jul 2022 09:28:22 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"52-j+I0id9IpXvkhDnI+4znZJXAfGk\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"Cache-Control","value":"no-store"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Content-Security-Policy","value":"frame-ancestors 'none'"},{"key":"Content-Security-Policy","value":"frame-ancestors 'none'"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Expect-CT","value":"max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\""},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"725f11edfa6bb27e-DUR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Virtual bank account credited successfully\",\n    \"data\": null\n}"},{"id":"fba8e655-713c-4122-87c5-d5a16fee12d6","name":"Credit Sandbox Virtual Bank Account: USD - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"account_number\": \"345676551059\",\n    \"amount\": 100,\n    \"currency\": \"USD\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/virtual-bank-account/sandbox/credit"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 05 Jul 2022 09:28:22 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"52-j+I0id9IpXvkhDnI+4znZJXAfGk\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"Cache-Control","value":"no-store"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Content-Security-Policy","value":"frame-ancestors 'none'"},{"key":"Content-Security-Policy","value":"frame-ancestors 'none'"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Expect-CT","value":"max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\""},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"725f11edfa6bb27e-DUR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Virtual bank account credited successfully\",\n    \"data\": null\n}"},{"id":"bb427c61-ec45-4ef9-bfaf-5a151d54a366","name":"Credit Sandbox Virtual Bank Account - Request Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 100,\n    \"currency\": \"NGN\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/virtual-bank-account/sandbox/credit"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"bad_request\",\n    \"message\": \"invalid request data\",\n    \"data\": {\n        \"amount\": {\n            \"message\": \"account_number is required\",\n            \"customErrorMessage\": \"account_number is required\"\n        }\n    }\n}"}],"_postman_id":"531895f9-87b9-4f2b-95e8-bfc7a7872deb"},{"name":"Create a Virtual Bank Account Holder","id":"8f1e91d9-0137-4935-9568-4518586d73b6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n  \"first_name\": \"Sarah\",\n  \"last_name\": \"Doe\",\n  \"use_case\": \"Personal\",\n  \"type\": \"individual\",\n  \"date_of_birth\": \"1988-04-04\",\n  \"nationality\": \"NG\",\n  \"occupation\": \"Entrepreneur\",\n  \"email\": \"sarah.doe@example.com\",\n  \"phone\": \"+2348133443000\",\n  \"bank_id_number\": \"12332435200\",\n  \"source_of_inflow\": \"bank_statement\",\n  \"source_of_inflow_document\": {\n    \"reference\": \"KPY-FILE-202509091525ocHUp9oxwrt4lICRJ63S35963\"\n  },\n  \"selfie\": {\n    \"reference\": \"KPY-FILE-202509091525ocHUp9oxwrt4lICRJ63S35963\"\n  },\n  \"identification\": {\n     \"type\": \"passport\",\n     \"number\": \"A11111111\",\n     \"document_front\": {\n        \"reference\": \"KPY-FILE-202509091525ocHUp9oxwrt4lICRJ63S35963\"\n     },\n     \"issued_date\": \"2010-01-01\",\n     \"expiry_date\": \"2030-01-01\",\n     \"country\": \"NG\"\n  },\n  \"proof_of_address\": {\n    \"type\": \"bank_statement\",\n    \"document\": {\n        \"reference\": \"KPY-FILE-202509091525ocHUp9oxwrt4lICRJ63S35963\"\n    }\n  },\n  \"address\": {\n    \"country\": \"NG\",\n    \"zip\": \"12345\",\n    \"address\": \"Freedom Way St\",\n    \"state\": \"Lagos\",\n    \"city\": \"Lagos\"\n  },\n  \"employment\": {\n    \"status\": \"employer\",\n    \"employer\": \"Google\",\n    \"description\": \"I am an employer\"\n  },\n  \"metadata\": {\n    \"key1\": \"value1\"\n  }\n}\n","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/api/v1/virtual-bank-account/account-holders","urlObject":{"path":["api","v1","virtual-bank-account","account-holders"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"8a17763c-db86-4c36-9f7e-fd0b28c6f696","name":"Create a Virtual Bank Account Holder - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n  \"first_name\": \"Sarah\",\n  \"last_name\": \"Doe\",\n  \"use_case\": \"Personal\",\n  \"type\": \"individual\",\n  \"date_of_birth\": \"1988-04-04\",\n  \"nationality\": \"NG\",\n  \"occupation\": \"Entrepreneur\",\n  \"email\": \"sarah.doe@example.com\",\n  \"phone\": \"+2348133443000\",\n  \"bank_id_number\": \"12332435200\",\n  \"source_of_inflow\": \"bank_statement\",\n  \"source_of_inflow_document\": {\n    \"reference\": \"KPY-FILE-202509091525ocHUp9oxwrt4lICRJ63S35963\"\n  },\n  \"selfie\": {\n    \"reference\": \"KPY-FILE-202509091525ocHUp9oxwrt4lICRJ63S35963\"\n  },\n  \"identification\": {\n     \"type\": \"passport\",\n     \"number\": \"A11111111\",\n     \"document_front\": {\n        \"reference\": \"KPY-FILE-202509091525ocHUp9oxwrt4lICRJ63S35963\"\n     },\n     \"issued_date\": \"2010-01-01\",\n     \"expiry_date\": \"2030-01-01\",\n     \"country\": \"NG\"\n  },\n  \"proof_of_address\": {\n    \"type\": \"bank_statement\",\n    \"document\": {\n        \"reference\": \"KPY-FILE-202509091525ocHUp9oxwrt4lICRJ63S35963\"\n    }\n  },\n  \"address\": {\n    \"country\": \"NG\",\n    \"zip\": \"12345\",\n    \"address\": \"Freedom Way St\",\n    \"state\": \"Lagos\",\n    \"city\": \"Lagos\"\n  },\n  \"employment\": {\n    \"status\": \"employer\",\n    \"employer\": \"Google\",\n    \"description\": \"I am an employer\"\n  },\n  \"metadata\": {\n    \"key1\": \"value1\"\n  }\n}\n","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/api/v1/virtual-bank-account/account-holders"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Virtual account holder creation requested successfully\",\n    \"data\": {\n        \"reference\": \"KPY-AH-CGAXuc6jZwDA8TJ\",\n        \"email\": \"sarah.doe@example.com\",\n        \"status\": \"pending\",\n        \"metadata\": {\n            \"key1\": \"value1\"\n        }\n    }\n}"}],"_postman_id":"8f1e91d9-0137-4935-9568-4518586d73b6"},{"name":"Get a Virtual Bank Account Holder","id":"126481e2-da02-4076-a8be-041e0918033c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.korapay.com/api/v1/virtual-bank-account/account-holders/:accountHolderReference/details","auth":{"type":"noauth","isInherited":true,"source":{"_postman_id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","name":"Pay-ins","type":"folder"}},"urlObject":{"path":["api","v1","virtual-bank-account","account-holders",":accountHolderReference","details"],"host":["https://api.korapay.com"],"query":[],"variable":[{"id":"69c93f6a-e800-45a4-b3d4-c83ff5b98232","type":"any","value":"KPY-AH-WveCyyYAvKh107Y","key":"accountHolderReference"}]}},"response":[{"id":"74e50209-4026-4a1c-80ba-316edbce6451","name":"Get a Virtual Bank Account Holder - Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/api/v1/virtual-bank-account/account-holders/:accountHolderReference/details","host":["https://api.korapay.com"],"path":["api","v1","virtual-bank-account","account-holders",":accountHolderReference","details"],"variable":[{"key":"accountHolderReference","value":"KPY-AH-WveCyyYAvKh107Y"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Virtual account holder retrieved successfully\",\n    \"data\": {\n        \"reference\": \"KPY-AH-WveCyyYAvKh107Y\",\n        \"account_type\": \"individual\",\n        \"first_name\": \"Sarah\",\n        \"last_name\": \"Doe\",\n        \"email\": \"israel.ban12@example.com\",\n        \"phone_number\": \"+2348121775311\",\n        \"occupation\": \"Software Engineering\",\n        \"status\": \"pending\",\n        \"metadata\": {\n            \"key1\": \"value1\"\n        },\n        \"date_created\": \"2024-03-22T13:27:17.000Z\",\n        \"country\": \"NG\",\n        \"date_of_birth\": \"1988-04-04T00:00:00.000Z\",\n        \"address\": {\n            \"zip\": \"12345\",\n            \"city\": \"Lagos\",\n            \"state\": \"Lagos\",\n            \"address\": \"Freedom Way St\",\n            \"country\": \"NG\"\n        },\n        \"documents\": {\n            \"identification_front\": \"iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAApgAAAKYB3X3/OAAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAANCSURBVEiJtZZPbBtFFMZ/M7ubXdtdb1xSFyeilBapySVU8h8OoFaooFSqiihIVIpQBKci6KEg9Q6H9kovIHoCIVQJJCKE1ENFjnAgcaSGC6rEnxBwA04Tx43t2FnvDAfjkNibxgHxnWb2e/u992bee7tCa00YFsffekFY+nUzFtjW0LrvjRXrCDIAaPLlW0nHL0SsZtVoaF98mLrx3pdhOqLtYPHChahZcYYO7KvPFxvRl5XPp1sN3adWiD1ZAqD6XYK1b/dvE5IWryTt2udLFedwc1+9kLp+vbbpoDh+6TklxBeAi9TL0taeWpdmZzQDry0AcO+jQ12RyohqqoYoo8RDwJrU+qXkjWtfi8Xxt58BdQuwQs9qC/afLwCw8tnQbqYAPsgxE1S6F3EAIXux2oQFKm0ihMsOF71dHYx+f3NND68ghCu1YIoePPQN1pGRABkJ6Bus96CutRZMydTl+TvuiRW1m3n0eDl0vRPcEysqdXn+jsQPsrHMquGeXEaY4Yk4wxWcY5V/9scqOMOVUFthatyTy8QyqwZ+kDURKoMWxNKr2EeqVKcTNOajqKoBgOE28U4tdQl5p5bwCw7BWquaZSzAPlwjlithJtp3pTImSqQRrb2Z8PHGigD4RZuNX6JYj6wj7O4TFLbCO/Mn/m8R+h6rYSUb3ekokRY6f/YukArN979jcW+V/S8g0eT/N3VN3kTqWbQ428m9/8k0P/1aIhF36PccEl6EhOcAUCrXKZXXWS3XKd2vc/TRBG9O5ELC17MmWubD2nKhUKZa26Ba2+D3P+4/MNCFwg59oWVeYhkzgN/JDR8deKBoD7Y+ljEjGZ0sosXVTvbc6RHirr2reNy1OXd6pJsQ+gqjk8VWFYmHrwBzW/n+uMPFiRwHB2I7ih8ciHFxIkd/3Omk5tCDV1t+2nNu5sxxpDFNx+huNhVT3/zMDz8usXC3ddaHBj1GHj/As08fwTS7Kt1HBTmyN29vdwAw+/wbwLVOJ3uAD1wi/dUH7Qei66PfyuRj4Ik9is+hglfbkbfR3cnZm7chlUWLdwmprtCohX4HUtlOcQjLYCu+fzGJH2QRKvP3UNz8bWk1qMxjGTOMThZ3kvgLI5AzFfo379UAAAAASUVORK5CYII=\",\n            \"identification_back\": \"iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAApgAAAKYB3X3/OAAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAANCSURBVEiJtZZPbBtFFMZ/M7ubXdtdb1xSFyeilBapySVU8h8OoFaooFSqiihIVIpQBKci6KEg9Q6H9kovIHoCIVQJJCKE1ENFjnAgcaSGC6rEnxBwA04Tx43t2FnvDAfjkNibxgHxnWb2e/u992bee7tCa00YFsffekFY+nUzFtjW0LrvjRXrCDIAaPLlW0nHL0SsZtVoaF98mLrx3pdhOqLtYPHChahZcYYO7KvPFxvRl5XPp1sN3adWiD1ZAqD6XYK1b/dvE5IWryTt2udLFedwc1+9kLp+vbbpoDh+6TklxBeAi9TL0taeWpdmZzQDry0AcO+jQ12RyohqqoYoo8RDwJrU+qXkjWtfi8Xxt58BdQuwQs9qC/afLwCw8tnQbqYAPsgxE1S6F3EAIXux2oQFKm0ihMsOF71dHYx+f3NND68ghCu1YIoePPQN1pGRABkJ6Bus96CutRZMydTl+TvuiRW1m3n0eDl0vRPcEysqdXn+jsQPsrHMquGeXEaY4Yk4wxWcY5V/9scqOMOVUFthatyTy8QyqwZ+kDURKoMWxNKr2EeqVKcTNOajqKoBgOE28U4tdQl5p5bwCw7BWquaZSzAPlwjlithJtp3pTImSqQRrb2Z8PHGigD4RZuNX6JYj6wj7O4TFLbCO/Mn/m8R+h6rYSUb3ekokRY6f/YukArN979jcW+V/S8g0eT/N3VN3kTqWbQ428m9/8k0P/1aIhF36PccEl6EhOcAUCrXKZXXWS3XKd2vc/TRBG9O5ELC17MmWubD2nKhUKZa26Ba2+D3P+4/MNCFwg59oWVeYhkzgN/JDR8deKBoD7Y+ljEjGZ0sosXVTvbc6RHirr2reNy1OXd6pJsQ+gqjk8VWFYmHrwBzW/n+uMPFiRwHB2I7ih8ciHFxIkd/3Omk5tCDV1t+2nNu5sxxpDFNx+huNhVT3/zMDz8usXC3ddaHBj1GHj/As08fwTS7Kt1HBTmyN29vdwAw+/wbwLVOJ3uAD1wi/dUH7Qei66PfyuRj4Ik9is+hglfbkbfR3cnZm7chlUWLdwmprtCohX4HUtlOcQjLYCu+fzGJH2QRKvP3UNz8bWk1qMxjGTOMThZ3kvgLI5AzFfo379UAAAAASUVORK5CYII=\",\n            \"proof_of_address\": \"iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAApgAAAKYB3X3/OAAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAANCSURBVEiJtZZPbBtFFMZ/M7ubXdtdb1xSFyeilBapySVU8h8OoFaooFSqiihIVIpQBKci6KEg9Q6H9kovIHoCIVQJJCKE1ENFjnAgcaSGC6rEnxBwA04Tx43t2FnvDAfjkNibxgHxnWb2e/u992bee7tCa00YFsffekFY+nUzFtjW0LrvjRXrCDIAaPLlW0nHL0SsZtVoaF98mLrx3pdhOqLtYPHChahZcYYO7KvPFxvRl5XPp1sN3adWiD1ZAqD6XYK1b/dvE5IWryTt2udLFedwc1+9kLp+vbbpoDh+6TklxBeAi9TL0taeWpdmZzQDry0AcO+jQ12RyohqqoYoo8RDwJrU+qXkjWtfi8Xxt58BdQuwQs9qC/afLwCw8tnQbqYAPsgxE1S6F3EAIXux2oQFKm0ihMsOF71dHYx+f3NND68ghCu1YIoePPQN1pGRABkJ6Bus96CutRZMydTl+TvuiRW1m3n0eDl0vRPcEysqdXn+jsQPsrHMquGeXEaY4Yk4wxWcY5V/9scqOMOVUFthatyTy8QyqwZ+kDURKoMWxNKr2EeqVKcTNOajqKoBgOE28U4tdQl5p5bwCw7BWquaZSzAPlwjlithJtp3pTImSqQRrb2Z8PHGigD4RZuNX6JYj6wj7O4TFLbCO/Mn/m8R+h6rYSUb3ekokRY6f/YukArN979jcW+V/S8g0eT/N3VN3kTqWbQ428m9/8k0P/1aIhF36PccEl6EhOcAUCrXKZXXWS3XKd2vc/TRBG9O5ELC17MmWubD2nKhUKZa26Ba2+D3P+4/MNCFwg59oWVeYhkzgN/JDR8deKBoD7Y+ljEjGZ0sosXVTvbc6RHirr2reNy1OXd6pJsQ+gqjk8VWFYmHrwBzW/n+uMPFiRwHB2I7ih8ciHFxIkd/3Omk5tCDV1t+2nNu5sxxpDFNx+huNhVT3/zMDz8usXC3ddaHBj1GHj/As08fwTS7Kt1HBTmyN29vdwAw+/wbwLVOJ3uAD1wi/dUH7Qei66PfyuRj4Ik9is+hglfbkbfR3cnZm7chlUWLdwmprtCohX4HUtlOcQjLYCu+fzGJH2QRKvP3UNz8bWk1qMxjGTOMThZ3kvgLI5AzFfo379UAAAAASUVORK5CYII=\",\n            \"selfie\": \"iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAApgAAAKYB3X3/OAAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAANCSURBVEiJtZZPbBtFFMZ/M7ubXdtdb1xSFyeilBapySVU8h8OoFaooFSqiihIVIpQBKci6KEg9Q6H9kovIHoCIVQJJCKE1ENFjnAgcaSGC6rEnxBwA04Tx43t2FnvDAfjkNibxgHxnWb2e/u992bee7tCa00YFsffekFY+nUzFtjW0LrvjRXrCDIAaPLlW0nHL0SsZtVoaF98mLrx3pdhOqLtYPHChahZcYYO7KvPFxvRl5XPp1sN3adWiD1ZAqD6XYK1b/dvE5IWryTt2udLFedwc1+9kLp+vbbpoDh+6TklxBeAi9TL0taeWpdmZzQDry0AcO+jQ12RyohqqoYoo8RDwJrU+qXkjWtfi8Xxt58BdQuwQs9qC/afLwCw8tnQbqYAPsgxE1S6F3EAIXux2oQFKm0ihMsOF71dHYx+f3NND68ghCu1YIoePPQN1pGRABkJ6Bus96CutRZMydTl+TvuiRW1m3n0eDl0vRPcEysqdXn+jsQPsrHMquGeXEaY4Yk4wxWcY5V/9scqOMOVUFthatyTy8QyqwZ+kDURKoMWxNKr2EeqVKcTNOajqKoBgOE28U4tdQl5p5bwCw7BWquaZSzAPlwjlithJtp3pTImSqQRrb2Z8PHGigD4RZuNX6JYj6wj7O4TFLbCO/Mn/m8R+h6rYSUb3ekokRY6f/YukArN979jcW+V/S8g0eT/N3VN3kTqWbQ428m9/8k0P/1aIhF36PccEl6EhOcAUCrXKZXXWS3XKd2vc/TRBG9O5ELC17MmWubD2nKhUKZa26Ba2+D3P+4/MNCFwg59oWVeYhkzgN/JDR8deKBoD7Y+ljEjGZ0sosXVTvbc6RHirr2reNy1OXd6pJsQ+gqjk8VWFYmHrwBzW/n+uMPFiRwHB2I7ih8ciHFxIkd/3Omk5tCDV1t+2nNu5sxxpDFNx+huNhVT3/zMDz8usXC3ddaHBj1GHj/As08fwTS7Kt1HBTmyN29vdwAw+/wbwLVOJ3uAD1wi/dUH7Qei66PfyuRj4Ik9is+hglfbkbfR3cnZm7chlUWLdwmprtCohX4HUtlOcQjLYCu+fzGJH2QRKvP3UNz8bWk1qMxjGTOMThZ3kvgLI5AzFfo379UAAAAASUVORK5CYII=\",\n            \"source_of_inflow\": \"iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAApgAAAKYB3X3/OAAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAANCSURBVEiJtZZPbBtFFMZ/M7ubXdtdb1xSFyeilBapySVU8h8OoFaooFSqiihIVIpQBKci6KEg9Q6H9kovIHoCIVQJJCKE1ENFjnAgcaSGC6rEnxBwA04Tx43t2FnvDAfjkNibxgHxnWb2e/u992bee7tCa00YFsffekFY+nUzFtjW0LrvjRXrCDIAaPLlW0nHL0SsZtVoaF98mLrx3pdhOqLtYPHChahZcYYO7KvPFxvRl5XPp1sN3adWiD1ZAqD6XYK1b/dvE5IWryTt2udLFedwc1+9kLp+vbbpoDh+6TklxBeAi9TL0taeWpdmZzQDry0AcO+jQ12RyohqqoYoo8RDwJrU+qXkjWtfi8Xxt58BdQuwQs9qC/afLwCw8tnQbqYAPsgxE1S6F3EAIXux2oQFKm0ihMsOF71dHYx+f3NND68ghCu1YIoePPQN1pGRABkJ6Bus96CutRZMydTl+TvuiRW1m3n0eDl0vRPcEysqdXn+jsQPsrHMquGeXEaY4Yk4wxWcY5V/9scqOMOVUFthatyTy8QyqwZ+kDURKoMWxNKr2EeqVKcTNOajqKoBgOE28U4tdQl5p5bwCw7BWquaZSzAPlwjlithJtp3pTImSqQRrb2Z8PHGigD4RZuNX6JYj6wj7O4TFLbCO/Mn/m8R+h6rYSUb3ekokRY6f/YukArN979jcW+V/S8g0eT/N3VN3kTqWbQ428m9/8k0P/1aIhF36PccEl6EhOcAUCrXKZXXWS3XKd2vc/TRBG9O5ELC17MmWubD2nKhUKZa26Ba2+D3P+4/MNCFwg59oWVeYhkzgN/JDR8deKBoD7Y+ljEjGZ0sosXVTvbc6RHirr2reNy1OXd6pJsQ+gqjk8VWFYmHrwBzW/n+uMPFiRwHB2I7ih8ciHFxIkd/3Omk5tCDV1t+2nNu5sxxpDFNx+huNhVT3/zMDz8usXC3ddaHBj1GHj/As08fwTS7Kt1HBTmyN29vdwAw+/wbwLVOJ3uAD1wi/dUH7Qei66PfyuRj4Ik9is+hglfbkbfR3cnZm7chlUWLdwmprtCohX4HUtlOcQjLYCu+fzGJH2QRKvP3UNz8bWk1qMxjGTOMThZ3kvgLI5AzFfo379UAAAAASUVORK5CYII=\"\n        }\n    }\n}"}],"_postman_id":"126481e2-da02-4076-a8be-041e0918033c"},{"name":"Update Virtual Bank Account Holder Kyc","id":"3582a488-295b-4c84-a846-eaa19d3019a6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n  \"first_name\": \"Sarah\",\n  \"last_name\": \"Doe\",\n  \"source_of_inflow\": \"bank_statement\",\n  \"source_of_inflow_document\": \"data:application/pdf;base64,…\",\n  \"selfie\": \"data:image/jpeg;base64,…\",\n  \"identification\": {\n     \"type\": \"passport\",\n     \"number\": \"A11111111\",\n     \"document_front\": \"data:image/jpeg;base64,…\",\n     \"issued_date\": \"2010-01-01\",\n     \"expiry_date\": \"2030-01-01\",\n     \"country\": \"NG\"\n  },\n  \"proof_of_address\": {\n    \"type\": \"bank_statement\",\n    \"document\": \"data:application/pdf;base64,…\"\n  }\n}\n","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.comapi/v1/virtual-bank-account/account-holders/:reference/update-kyc","auth":{"type":"noauth","isInherited":true,"source":{"_postman_id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","name":"Pay-ins","type":"folder"}},"urlObject":{"path":["v1","virtual-bank-account","account-holders",":reference","update-kyc"],"host":["https://api.korapay.comapi"],"query":[],"variable":[{"id":"660b6787-2434-4fe9-b7b8-0744c574d42d","type":"any","value":"","key":"reference"}]}},"response":[{"id":"98bd4786-795a-40be-9da2-16752af8eb64","name":"Update Virtual Bank Account Holder Kyc - Success","originalRequest":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n  \"first_name\": \"Sarah\",\n  \"last_name\": \"Doe\",\n  \"source_of_inflow\": \"bank_statement\",\n  \"source_of_inflow_document\": \"data:application/pdf;base64,…\",\n  \"selfie\": \"data:image/jpeg;base64,…\",\n  \"identification\": {\n     \"type\": \"passport\",\n     \"number\": \"A11111111\",\n     \"document_front\": \"data:image/jpeg;base64,…\",\n     \"issued_date\": \"2010-01-01\",\n     \"expiry_date\": \"2030-01-01\",\n     \"country\": \"NG\"\n  },\n  \"proof_of_address\": {\n    \"type\": \"bank_statement\",\n    \"document\": \"data:application/pdf;base64,…\"\n  }\n}\n","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.korapay.comapi/v1/virtual-bank-account/account-holders/:reference/update-kyc","host":["https://api.korapay.comapi"],"path":["v1","virtual-bank-account","account-holders",":reference","update-kyc"],"variable":[{"key":"reference","value":"KPY-AH-WveCyyYAvKh107Y"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Virtual bank account holder update kyc requested successfully\",\n    \"data\": {\n        \"reference\": \"KPY-AH-WveCyyYAvKh107Y\",\n        \"first_name\": \"Sarah\",\n        \"last_name\": \"Doe\",\n        \"status\": \"pending\"\n    }\n}"}],"_postman_id":"3582a488-295b-4c84-a846-eaa19d3019a6"},{"name":"Create a Virtual Bank Account Holder","id":"11f6f671-fa54-4c40-98c0-8cbb1aa23c01","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n  \"first_name\": \"Sarah\",\n  \"last_name\": \"Doe\",\n  \"use_case\": \"Personal\",\n  \"type\": \"individual\",\n  \"date_of_birth\": \"1988-04-04\",\n  \"nationality\": \"NG\",\n  \"occupation\": \"Entrepreneur\",\n  \"email\": \"sarah.doe@example.com\",\n  \"phone\": \"+2348133443000\",\n  \"bank_id_number\": \"12332435200\",\n  \"source_of_inflow\": \"bank_statement\",\n  \"source_of_inflow_document\": \"data:application/pdf;base64,…\",\n  \"selfie\": \"data:image/jpeg;base64,…\",\n  \"identification\": {\n     \"type\": \"passport\",\n     \"number\": \"A11111111\",\n     \"document_front\": \"data:image/jpeg;base64,…\",\n     \"issued_date\": \"2010-01-01\",\n     \"expiry_date\": \"2030-01-01\",\n     \"country\": \"NG\"\n  },\n  \"proof_of_address\": {\n    \"type\": \"bank_statement\",\n    \"document\": \"data:application/pdf;base64,…\"\n  },\n  \"address\": {\n    \"country\": \"NG\",\n    \"zip\": \"12345\",\n    \"address\": \"Freedom Way St\",\n    \"state\": \"Lagos\",\n    \"city\": \"Lagos\"\n  },\n  \"employment\": {\n    \"status\": \"employer\",\n    \"employer\": \"Google\",\n    \"description\": \"I am an employer\"\n  },\n  \"metadata\": {\n    \"key1\": \"value1\"\n  }\n}\n","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/api/v1/virtual-bank-account/account-holders","urlObject":{"path":["api","v1","virtual-bank-account","account-holders"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"c59b6e3b-d287-4482-ac0e-f3409fee948e","name":"Create a Virtual Bank Account Holder - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n  \"first_name\": \"Sarah\",\n  \"last_name\": \"Doe\",\n  \"use_case\": \"Personal\",\n  \"type\": \"individual\",\n  \"date_of_birth\": \"1988-04-04\",\n  \"nationality\": \"NG\",\n  \"occupation\": \"Entrepreneur\",\n  \"email\": \"sarah.doe@example.com\",\n  \"phone\": \"+2348133443000\",\n  \"bank_id_number\": \"12332435200\",\n  \"source_of_inflow\": \"bank_statement\",\n  \"source_of_inflow_document\": \"data:application/pdf;base64,…\",\n  \"selfie\": \"data:image/jpeg;base64,…\",\n  \"identification\": {\n     \"type\": \"passport\",\n     \"number\": \"A11111111\",\n     \"document_front\": \"data:image/jpeg;base64,…\",\n     \"issued_date\": \"2010-01-01\",\n     \"expiry_date\": \"2030-01-01\",\n     \"country\": \"NG\"\n  },\n  \"proof_of_address\": {\n    \"type\": \"bank_statement\",\n    \"document\": \"data:application/pdf;base64,…\"\n  },\n  \"address\": {\n    \"country\": \"NG\",\n    \"zip\": \"12345\",\n    \"address\": \"Freedom Way St\",\n    \"state\": \"Lagos\",\n    \"city\": \"Lagos\"\n  },\n  \"employment\": {\n    \"status\": \"employer\",\n    \"employer\": \"Google\",\n    \"description\": \"I am an employer\"\n  },\n  \"metadata\": {\n    \"key1\": \"value1\"\n  }\n}\n","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/api/v1/virtual-bank-account/account-holders"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Virtual account holder creation requested successfully\",\n    \"data\": {\n        \"reference\": \"KPY-AH-CGAXuc6jZwDA8TJ\",\n        \"email\": \"sarah.doe@example.com\",\n        \"status\": \"pending\",\n        \"metadata\": {\n            \"key1\": \"value1\"\n        }\n    }\n}"}],"_postman_id":"11f6f671-fa54-4c40-98c0-8cbb1aa23c01"},{"name":"Get a Virtual Bank Account Holder","id":"67c517c1-29e1-4b48-a04b-7eeb07ebf7ab","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.korapay.com/api/v1/virtual-bank-account/account-holders/:accountHolderReference/details","auth":{"type":"noauth","isInherited":true,"source":{"_postman_id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","name":"Pay-ins","type":"folder"}},"urlObject":{"path":["api","v1","virtual-bank-account","account-holders",":accountHolderReference","details"],"host":["https://api.korapay.com"],"query":[],"variable":[{"id":"dd8a860d-aa2a-43b1-998b-6ecab5e3a54e","type":"any","value":"KPY-AH-WveCyyYAvKh107Y","key":"accountHolderReference"}]}},"response":[{"id":"4a6ec29d-39bd-40b8-9d98-2a98c5241123","name":"Get a Virtual Bank Account Holder - Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/api/v1/virtual-bank-account/account-holders/:accountHolderReference/details","host":["https://api.korapay.com"],"path":["api","v1","virtual-bank-account","account-holders",":accountHolderReference","details"],"variable":[{"key":"accountHolderReference","value":"KPY-AH-WveCyyYAvKh107Y"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Virtual account holder retrieved successfully\",\n    \"data\": {\n        \"reference\": \"KPY-AH-WveCyyYAvKh107Y\",\n        \"account_type\": \"individual\",\n        \"first_name\": \"Sarah\",\n        \"last_name\": \"Doe\",\n        \"email\": \"israel.ban12@example.com\",\n        \"phone_number\": \"+2348121775311\",\n        \"occupation\": \"Software Engineering\",\n        \"status\": \"pending\",\n        \"metadata\": {\n            \"key1\": \"value1\"\n        },\n        \"date_created\": \"2024-03-22T13:27:17.000Z\",\n        \"country\": \"NG\",\n        \"date_of_birth\": \"1988-04-04T00:00:00.000Z\",\n        \"address\": {\n            \"zip\": \"12345\",\n            \"city\": \"Lagos\",\n            \"state\": \"Lagos\",\n            \"address\": \"Freedom Way St\",\n            \"country\": \"NG\"\n        },\n        \"documents\": {\n            \"identification_front\": \"iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAApgAAAKYB3X3/OAAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAANCSURBVEiJtZZPbBtFFMZ/M7ubXdtdb1xSFyeilBapySVU8h8OoFaooFSqiihIVIpQBKci6KEg9Q6H9kovIHoCIVQJJCKE1ENFjnAgcaSGC6rEnxBwA04Tx43t2FnvDAfjkNibxgHxnWb2e/u992bee7tCa00YFsffekFY+nUzFtjW0LrvjRXrCDIAaPLlW0nHL0SsZtVoaF98mLrx3pdhOqLtYPHChahZcYYO7KvPFxvRl5XPp1sN3adWiD1ZAqD6XYK1b/dvE5IWryTt2udLFedwc1+9kLp+vbbpoDh+6TklxBeAi9TL0taeWpdmZzQDry0AcO+jQ12RyohqqoYoo8RDwJrU+qXkjWtfi8Xxt58BdQuwQs9qC/afLwCw8tnQbqYAPsgxE1S6F3EAIXux2oQFKm0ihMsOF71dHYx+f3NND68ghCu1YIoePPQN1pGRABkJ6Bus96CutRZMydTl+TvuiRW1m3n0eDl0vRPcEysqdXn+jsQPsrHMquGeXEaY4Yk4wxWcY5V/9scqOMOVUFthatyTy8QyqwZ+kDURKoMWxNKr2EeqVKcTNOajqKoBgOE28U4tdQl5p5bwCw7BWquaZSzAPlwjlithJtp3pTImSqQRrb2Z8PHGigD4RZuNX6JYj6wj7O4TFLbCO/Mn/m8R+h6rYSUb3ekokRY6f/YukArN979jcW+V/S8g0eT/N3VN3kTqWbQ428m9/8k0P/1aIhF36PccEl6EhOcAUCrXKZXXWS3XKd2vc/TRBG9O5ELC17MmWubD2nKhUKZa26Ba2+D3P+4/MNCFwg59oWVeYhkzgN/JDR8deKBoD7Y+ljEjGZ0sosXVTvbc6RHirr2reNy1OXd6pJsQ+gqjk8VWFYmHrwBzW/n+uMPFiRwHB2I7ih8ciHFxIkd/3Omk5tCDV1t+2nNu5sxxpDFNx+huNhVT3/zMDz8usXC3ddaHBj1GHj/As08fwTS7Kt1HBTmyN29vdwAw+/wbwLVOJ3uAD1wi/dUH7Qei66PfyuRj4Ik9is+hglfbkbfR3cnZm7chlUWLdwmprtCohX4HUtlOcQjLYCu+fzGJH2QRKvP3UNz8bWk1qMxjGTOMThZ3kvgLI5AzFfo379UAAAAASUVORK5CYII=\",\n            \"identification_back\": \"iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAApgAAAKYB3X3/OAAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAANCSURBVEiJtZZPbBtFFMZ/M7ubXdtdb1xSFyeilBapySVU8h8OoFaooFSqiihIVIpQBKci6KEg9Q6H9kovIHoCIVQJJCKE1ENFjnAgcaSGC6rEnxBwA04Tx43t2FnvDAfjkNibxgHxnWb2e/u992bee7tCa00YFsffekFY+nUzFtjW0LrvjRXrCDIAaPLlW0nHL0SsZtVoaF98mLrx3pdhOqLtYPHChahZcYYO7KvPFxvRl5XPp1sN3adWiD1ZAqD6XYK1b/dvE5IWryTt2udLFedwc1+9kLp+vbbpoDh+6TklxBeAi9TL0taeWpdmZzQDry0AcO+jQ12RyohqqoYoo8RDwJrU+qXkjWtfi8Xxt58BdQuwQs9qC/afLwCw8tnQbqYAPsgxE1S6F3EAIXux2oQFKm0ihMsOF71dHYx+f3NND68ghCu1YIoePPQN1pGRABkJ6Bus96CutRZMydTl+TvuiRW1m3n0eDl0vRPcEysqdXn+jsQPsrHMquGeXEaY4Yk4wxWcY5V/9scqOMOVUFthatyTy8QyqwZ+kDURKoMWxNKr2EeqVKcTNOajqKoBgOE28U4tdQl5p5bwCw7BWquaZSzAPlwjlithJtp3pTImSqQRrb2Z8PHGigD4RZuNX6JYj6wj7O4TFLbCO/Mn/m8R+h6rYSUb3ekokRY6f/YukArN979jcW+V/S8g0eT/N3VN3kTqWbQ428m9/8k0P/1aIhF36PccEl6EhOcAUCrXKZXXWS3XKd2vc/TRBG9O5ELC17MmWubD2nKhUKZa26Ba2+D3P+4/MNCFwg59oWVeYhkzgN/JDR8deKBoD7Y+ljEjGZ0sosXVTvbc6RHirr2reNy1OXd6pJsQ+gqjk8VWFYmHrwBzW/n+uMPFiRwHB2I7ih8ciHFxIkd/3Omk5tCDV1t+2nNu5sxxpDFNx+huNhVT3/zMDz8usXC3ddaHBj1GHj/As08fwTS7Kt1HBTmyN29vdwAw+/wbwLVOJ3uAD1wi/dUH7Qei66PfyuRj4Ik9is+hglfbkbfR3cnZm7chlUWLdwmprtCohX4HUtlOcQjLYCu+fzGJH2QRKvP3UNz8bWk1qMxjGTOMThZ3kvgLI5AzFfo379UAAAAASUVORK5CYII=\",\n            \"proof_of_address\": \"iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAApgAAAKYB3X3/OAAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAANCSURBVEiJtZZPbBtFFMZ/M7ubXdtdb1xSFyeilBapySVU8h8OoFaooFSqiihIVIpQBKci6KEg9Q6H9kovIHoCIVQJJCKE1ENFjnAgcaSGC6rEnxBwA04Tx43t2FnvDAfjkNibxgHxnWb2e/u992bee7tCa00YFsffekFY+nUzFtjW0LrvjRXrCDIAaPLlW0nHL0SsZtVoaF98mLrx3pdhOqLtYPHChahZcYYO7KvPFxvRl5XPp1sN3adWiD1ZAqD6XYK1b/dvE5IWryTt2udLFedwc1+9kLp+vbbpoDh+6TklxBeAi9TL0taeWpdmZzQDry0AcO+jQ12RyohqqoYoo8RDwJrU+qXkjWtfi8Xxt58BdQuwQs9qC/afLwCw8tnQbqYAPsgxE1S6F3EAIXux2oQFKm0ihMsOF71dHYx+f3NND68ghCu1YIoePPQN1pGRABkJ6Bus96CutRZMydTl+TvuiRW1m3n0eDl0vRPcEysqdXn+jsQPsrHMquGeXEaY4Yk4wxWcY5V/9scqOMOVUFthatyTy8QyqwZ+kDURKoMWxNKr2EeqVKcTNOajqKoBgOE28U4tdQl5p5bwCw7BWquaZSzAPlwjlithJtp3pTImSqQRrb2Z8PHGigD4RZuNX6JYj6wj7O4TFLbCO/Mn/m8R+h6rYSUb3ekokRY6f/YukArN979jcW+V/S8g0eT/N3VN3kTqWbQ428m9/8k0P/1aIhF36PccEl6EhOcAUCrXKZXXWS3XKd2vc/TRBG9O5ELC17MmWubD2nKhUKZa26Ba2+D3P+4/MNCFwg59oWVeYhkzgN/JDR8deKBoD7Y+ljEjGZ0sosXVTvbc6RHirr2reNy1OXd6pJsQ+gqjk8VWFYmHrwBzW/n+uMPFiRwHB2I7ih8ciHFxIkd/3Omk5tCDV1t+2nNu5sxxpDFNx+huNhVT3/zMDz8usXC3ddaHBj1GHj/As08fwTS7Kt1HBTmyN29vdwAw+/wbwLVOJ3uAD1wi/dUH7Qei66PfyuRj4Ik9is+hglfbkbfR3cnZm7chlUWLdwmprtCohX4HUtlOcQjLYCu+fzGJH2QRKvP3UNz8bWk1qMxjGTOMThZ3kvgLI5AzFfo379UAAAAASUVORK5CYII=\",\n            \"selfie\": \"iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAApgAAAKYB3X3/OAAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAANCSURBVEiJtZZPbBtFFMZ/M7ubXdtdb1xSFyeilBapySVU8h8OoFaooFSqiihIVIpQBKci6KEg9Q6H9kovIHoCIVQJJCKE1ENFjnAgcaSGC6rEnxBwA04Tx43t2FnvDAfjkNibxgHxnWb2e/u992bee7tCa00YFsffekFY+nUzFtjW0LrvjRXrCDIAaPLlW0nHL0SsZtVoaF98mLrx3pdhOqLtYPHChahZcYYO7KvPFxvRl5XPp1sN3adWiD1ZAqD6XYK1b/dvE5IWryTt2udLFedwc1+9kLp+vbbpoDh+6TklxBeAi9TL0taeWpdmZzQDry0AcO+jQ12RyohqqoYoo8RDwJrU+qXkjWtfi8Xxt58BdQuwQs9qC/afLwCw8tnQbqYAPsgxE1S6F3EAIXux2oQFKm0ihMsOF71dHYx+f3NND68ghCu1YIoePPQN1pGRABkJ6Bus96CutRZMydTl+TvuiRW1m3n0eDl0vRPcEysqdXn+jsQPsrHMquGeXEaY4Yk4wxWcY5V/9scqOMOVUFthatyTy8QyqwZ+kDURKoMWxNKr2EeqVKcTNOajqKoBgOE28U4tdQl5p5bwCw7BWquaZSzAPlwjlithJtp3pTImSqQRrb2Z8PHGigD4RZuNX6JYj6wj7O4TFLbCO/Mn/m8R+h6rYSUb3ekokRY6f/YukArN979jcW+V/S8g0eT/N3VN3kTqWbQ428m9/8k0P/1aIhF36PccEl6EhOcAUCrXKZXXWS3XKd2vc/TRBG9O5ELC17MmWubD2nKhUKZa26Ba2+D3P+4/MNCFwg59oWVeYhkzgN/JDR8deKBoD7Y+ljEjGZ0sosXVTvbc6RHirr2reNy1OXd6pJsQ+gqjk8VWFYmHrwBzW/n+uMPFiRwHB2I7ih8ciHFxIkd/3Omk5tCDV1t+2nNu5sxxpDFNx+huNhVT3/zMDz8usXC3ddaHBj1GHj/As08fwTS7Kt1HBTmyN29vdwAw+/wbwLVOJ3uAD1wi/dUH7Qei66PfyuRj4Ik9is+hglfbkbfR3cnZm7chlUWLdwmprtCohX4HUtlOcQjLYCu+fzGJH2QRKvP3UNz8bWk1qMxjGTOMThZ3kvgLI5AzFfo379UAAAAASUVORK5CYII=\",\n            \"source_of_inflow\": \"iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAApgAAAKYB3X3/OAAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAANCSURBVEiJtZZPbBtFFMZ/M7ubXdtdb1xSFyeilBapySVU8h8OoFaooFSqiihIVIpQBKci6KEg9Q6H9kovIHoCIVQJJCKE1ENFjnAgcaSGC6rEnxBwA04Tx43t2FnvDAfjkNibxgHxnWb2e/u992bee7tCa00YFsffekFY+nUzFtjW0LrvjRXrCDIAaPLlW0nHL0SsZtVoaF98mLrx3pdhOqLtYPHChahZcYYO7KvPFxvRl5XPp1sN3adWiD1ZAqD6XYK1b/dvE5IWryTt2udLFedwc1+9kLp+vbbpoDh+6TklxBeAi9TL0taeWpdmZzQDry0AcO+jQ12RyohqqoYoo8RDwJrU+qXkjWtfi8Xxt58BdQuwQs9qC/afLwCw8tnQbqYAPsgxE1S6F3EAIXux2oQFKm0ihMsOF71dHYx+f3NND68ghCu1YIoePPQN1pGRABkJ6Bus96CutRZMydTl+TvuiRW1m3n0eDl0vRPcEysqdXn+jsQPsrHMquGeXEaY4Yk4wxWcY5V/9scqOMOVUFthatyTy8QyqwZ+kDURKoMWxNKr2EeqVKcTNOajqKoBgOE28U4tdQl5p5bwCw7BWquaZSzAPlwjlithJtp3pTImSqQRrb2Z8PHGigD4RZuNX6JYj6wj7O4TFLbCO/Mn/m8R+h6rYSUb3ekokRY6f/YukArN979jcW+V/S8g0eT/N3VN3kTqWbQ428m9/8k0P/1aIhF36PccEl6EhOcAUCrXKZXXWS3XKd2vc/TRBG9O5ELC17MmWubD2nKhUKZa26Ba2+D3P+4/MNCFwg59oWVeYhkzgN/JDR8deKBoD7Y+ljEjGZ0sosXVTvbc6RHirr2reNy1OXd6pJsQ+gqjk8VWFYmHrwBzW/n+uMPFiRwHB2I7ih8ciHFxIkd/3Omk5tCDV1t+2nNu5sxxpDFNx+huNhVT3/zMDz8usXC3ddaHBj1GHj/As08fwTS7Kt1HBTmyN29vdwAw+/wbwLVOJ3uAD1wi/dUH7Qei66PfyuRj4Ik9is+hglfbkbfR3cnZm7chlUWLdwmprtCohX4HUtlOcQjLYCu+fzGJH2QRKvP3UNz8bWk1qMxjGTOMThZ3kvgLI5AzFfo379UAAAAASUVORK5CYII=\"\n        }\n    }\n}"}],"_postman_id":"67c517c1-29e1-4b48-a04b-7eeb07ebf7ab"},{"name":"Update Virtual Bank Account Holder Kyc","id":"fc7c3ed6-086b-4a75-b800-8e255438352c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n  \"first_name\": \"Sarah\",\n  \"last_name\": \"Doe\",\n  \"source_of_inflow\": \"bank_statement\",\n  \"source_of_inflow_document\": {\n    \"reference\": \"KPY-FILE-202509091525ocHUp9oxwrt4lICRJ63S35963\"\n  },\n  \"selfie\": {\n    \"reference\": \"KPY-FILE-202509091525ocHUp9oxwrt4lICRJ63S35963\"\n  },\n  \"identification\": {\n     \"type\": \"passport\",\n     \"number\": \"A11111111\",\n     \"document_front\": {\n        \"reference\": \"KPY-FILE-202509091525ocHUp9oxwrt4lICRJ63S35963\"\n     },\n     \"issued_date\": \"2010-01-01\",\n     \"expiry_date\": \"2030-01-01\",\n     \"country\": \"NG\"\n  },\n  \"proof_of_address\": {\n    \"type\": \"bank_statement\",\n    \"document\": {\n        \"reference\": \"KPY-FILE-202509091525ocHUp9oxwrt4lICRJ63S35963\"\n    }\n  }\n}\n","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.comapi/v1/virtual-bank-account/account-holders/:reference/update-kyc","auth":{"type":"noauth","isInherited":true,"source":{"_postman_id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","name":"Pay-ins","type":"folder"}},"urlObject":{"path":["v1","virtual-bank-account","account-holders",":reference","update-kyc"],"host":["https://api.korapay.comapi"],"query":[],"variable":[{"type":"any","value":"","key":"reference"}]}},"response":[{"id":"f832d963-8563-4ac8-a527-d7da857888fb","name":"Update Virtual Bank Account Holder Kyc - Success","originalRequest":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n  \"first_name\": \"Sarah\",\n  \"last_name\": \"Doe\",\n  \"source_of_inflow\": \"bank_statement\",\n  \"source_of_inflow_document\": {\n    \"reference\": \"KPY-FILE-202509091525ocHUp9oxwrt4lICRJ63S35963\"\n  },\n  \"selfie\": {\n    \"reference\": \"KPY-FILE-202509091525ocHUp9oxwrt4lICRJ63S35963\"\n  },\n  \"identification\": {\n     \"type\": \"passport\",\n     \"number\": \"A11111111\",\n     \"document_front\": {\n        \"reference\": \"KPY-FILE-202509091525ocHUp9oxwrt4lICRJ63S35963\"\n     },\n     \"issued_date\": \"2010-01-01\",\n     \"expiry_date\": \"2030-01-01\",\n     \"country\": \"NG\"\n  },\n  \"proof_of_address\": {\n    \"type\": \"bank_statement\",\n    \"document\": {\n        \"reference\": \"KPY-FILE-202509091525ocHUp9oxwrt4lICRJ63S35963\"\n    }\n  }\n}\n","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.korapay.comapi/v1/virtual-bank-account/account-holders/:reference/update-kyc","host":["https://api.korapay.comapi"],"path":["v1","virtual-bank-account","account-holders",":reference","update-kyc"],"variable":[{"key":"reference","value":"KPY-AH-WveCyyYAvKh107Y"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Virtual bank account holder update kyc requested successfully\",\n    \"data\": {\n        \"reference\": \"KPY-AH-WveCyyYAvKh107Y\",\n        \"first_name\": \"Sarah\",\n        \"last_name\": \"Doe\",\n        \"status\": \"pending\"\n    }\n}"}],"_postman_id":"fc7c3ed6-086b-4a75-b800-8e255438352c"},{"name":"Generate File Upload Url","id":"c55a25d9-138f-4812-b980-307ee235f689","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n  \"reference\": \"REF-J999222D338SFSwwww\",\n  \"purpose\": \"kyc_document\",\n  \"content_type\": \"image/jpeg\" //image/jpeg, application/pdf\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/api/v1/files/generate-upload-url","auth":{"type":"noauth","isInherited":true,"source":{"_postman_id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","name":"Pay-ins","type":"folder"}},"urlObject":{"path":["api","v1","files","generate-upload-url"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"6a92e475-f435-4a87-8227-085adccc23e2","name":"Generate File Upload Url - Success","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\n  \"reference\": \"REF-J999222D338SFSwwww\",\n  \"purpose\": \"kyc_document\",\n  \"content_type\": \"image/jpeg\" //image/jpeg, application/pdf\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/api/v1/files/generate-upload-url"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"File upload url created successfully\",\n    \"data\": {\n        \"korapay_reference\": \"KPY-FILE-202508291414WUPh6CmvLAU052iYVynj14842\",\n        \"owner_reference\": \"REF-JGSJHVVV122200\",\n        \"purpose\": \"kyc_document\",\n        \"upload_url\": \"https://kpy-exported-files-staging.s3.amazonaws.com/merchant/4/kyc_document/files/REF-JGSJHVVV122200-1756473254842pdf?Content-Type=application%2Foctet-stream&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIA2LOU5WV7QNYTHWE2%2F20250829%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20250829T131414Z&X-Amz-Expires=3600&X-Amz-Signature=de8c15cd5c6514e1df7e811a12fbbae3ab7dd94528928308b746b24c1145de73&X-Amz-SignedHeaders=host\",\n        \"upload_url_expires\": \"2025-08-29T14:14:14.849Z\"\n    }\n}"}],"_postman_id":"c55a25d9-138f-4812-b980-307ee235f689"},{"name":"Create Virtual Bank Account(KES,TZS, RWF)","id":"81aa00fe-2978-49c1-abbe-3ba745fff84d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"account_name\": \"Steph James testing company\",\n    \"account_reference\": \"your-account-reference-907\",\n    \"permanent\": true,\n    \"currency\": \"KES\",\n    \"customer\": {\n        \"name\": \"John Doe\",\n        \"email\": \"don_alpha@email.com\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/virtual-bank-account","urlObject":{"protocol":"https","path":["merchant","api","v1","virtual-bank-account"],"host":["api","korapay","com"],"query":[],"variable":[]}},"response":[{"id":"ef8bfc97-cbf1-4744-92eb-19b7f0816410","name":"Create Virtual Bank Account(KES,TZS, RWF)","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"account_name\": \"Steph James testing company\",\n    \"account_reference\": \"your-account-reference-906\",\n    \"permanent\": true,\n    \"currency\": \"KES\",\n    \"customer\": {\n        \"name\": \"John Doe\",\n        \"email\": \"don_alpha@email.com\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/virtual-bank-account"},"status":"OK","code":200,"_postman_previewlanguage":"","header":[{"key":":status","value":200},{"key":"date","value":"Tue, 16 Jun 2026 06:40:06 GMT"},{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"server","value":"cloudflare"},{"key":"access-control-allow-origin","value":"*"},{"key":"kora-request-id","value":"REQ-ID-FiJ3MPQ2A1ipzNF"},{"key":"etag","value":"W/\"11b-DADCejRqJ1MuG5h6/5WIOADa41s\""},{"key":"vary","value":"Accept-Encoding"},{"key":"cache-control","value":"no-store"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"content-security-policy","value":"frame-ancestors 'none'"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"content-encoding","value":"gzip"},{"key":"cf-ray","value":"a0c7d235b81135dd-LHR"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Virtual bank account created successfully\",\n    \"data\": {\n        \"bank_name\": \"Choice Bank\",\n        \"account_reference\": \"your-account-reference-906\",\n        \"unique_id\": \"KPY-VA-n9vAKSZUwB0HtWe\",\n        \"account_status\": \"pending\",\n        \"created_at\": \"2026-06-16T06:40:06.158Z\",\n        \"currency\": \"KES\"\n    }\n}"}],"_postman_id":"81aa00fe-2978-49c1-abbe-3ba745fff84d"}],"id":"aa42b059-8acd-45d4-a493-d3d8cb76e850","description":"<p>Virtual Bank Accounts (or Virtual Accounts) are a special type of bank account that you can use to receive payments from your customers multiple times. For more details on Virtual accounts, <a href=\"https://developers.korapay.com/docs/virtual-bank-accounts\">see here</a></p>\n","_postman_id":"aa42b059-8acd-45d4-a493-d3d8cb76e850","auth":{"type":"noauth","isInherited":true,"source":{"_postman_id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","name":"Pay-ins","type":"folder"}}},{"name":"Mobile Money","item":[{"name":"Charge Mobile Money - Step 1","id":"ced34c62-951c-4b12-b751-9b36f0d93d93","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 701,\n    \"currency\": \"GHS\",\n    \"reference\": \"idkMain27105551024\",\n    \"description\": \"Payment for a emilokan\",\n    \"notification_url\": \"https://webhook.site/1c209942-1a66-4cdf-a7ab-78d9cc684ad2\",\n    \"redirect_url\": \"https://webhook.site\",\n    \"customer\": {\n        \"name\": \"John Doe\",\n        \"email\": \"john@email.com\"\n    },\n    \"merchant_bears_cost\": true,\n    \"mobile_money\": {\n        \"number\": \"233240000000\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/mobile-money","description":"<p>To charge a customer, you will need to collect the necessary payment information from the customer.<br />Here are the request parameters.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Parameter</th>\n<th>Type</th>\n<th>Required</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>reference</td>\n<td>String</td>\n<td>True</td>\n<td>A unique reference for the payment. The reference must be at least 8 characters long.</td>\n</tr>\n<tr>\n<td>amount</td>\n<td>Number</td>\n<td>True</td>\n<td>The amount for the charge</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>String</td>\n<td>True</td>\n<td>The currency for the charge</td>\n</tr>\n<tr>\n<td>redirect_url</td>\n<td>String</td>\n<td>False</td>\n<td>A URL to which we can redirect your customer after their payment is complete</td>\n</tr>\n<tr>\n<td>customer</td>\n<td>Object</td>\n<td>True</td>\n<td>The information of the customer you want to charge</td>\n</tr>\n<tr>\n<td>customer.name</td>\n<td>String</td>\n<td>False</td>\n<td>The name of your customer</td>\n</tr>\n<tr>\n<td>customer.email</td>\n<td>String</td>\n<td>True</td>\n<td>The email of your customer</td>\n</tr>\n<tr>\n<td>mobile_money</td>\n<td>Object</td>\n<td>True</td>\n<td>Object holding the mobile money wallet details</td>\n</tr>\n<tr>\n<td>mobile_money.number</td>\n<td>String</td>\n<td>True</td>\n<td>The mobile number of the customer to be charged e.g 254700000000</td>\n</tr>\n<tr>\n<td>notification_url</td>\n<td>String</td>\n<td>False</td>\n<td>The webhook URL to be called when the transaction is complete.</td>\n</tr>\n<tr>\n<td>merchant_bears_cost</td>\n<td>Boolean</td>\n<td>False</td>\n<td>This sets who bear the fees of the transaction. If it is set to true, the merchant will bear the fee. If it is set to false, the customer will bear the fee. By default, it is false.</td>\n</tr>\n<tr>\n<td>description</td>\n<td>String</td>\n<td>False</td>\n<td>Information/narration about the transaction</td>\n</tr>\n<tr>\n<td>metadata</td>\n<td>Object</td>\n<td>False</td>\n<td>It takes a JSON object with a maximum of 5 fields/keys. Empty JSON objects are not allowed.  <br />  <br />Each field name has a maximum length of 20 characters. Allowed characters: <strong>A-Z</strong>, <strong>a-z</strong>, <strong>0-9</strong>, and <strong>-</strong>.</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","charges","mobile-money"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"a0275e80-7caf-42c5-a2c1-420ca1c9cf0e","name":"Success – OTP","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 701,\n    \"currency\": \"GHS\",\n    \"reference\": \"idkMain27105551026\",\n    \"description\": \"Payment for a emilokan\",\n    \"notification_url\": \"https://webhook.site/1c209942-1a66-4cdf-a7ab-78d9cc684ad2\",\n    \"redirect_url\": \"https://webhook.site\",\n    \"customer\": {\n        \"name\": \"John Doe\",\n        \"email\": \"john@email.com\"\n    },\n    \"merchant_bears_cost\": true,\n    \"mobile_money\": {\n      \"number\": \"233240000000\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/mobile-money"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 21 Aug 2023 09:50:28 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"5b-3tbVn2xdiLUTs8e+1nX3IeMWzwo\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7fa1f8d32c88dd70-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Authorization required\",\n    \"data\": {\n        \"amount\": 701,\n        \"amount_expected\": 701,\n        \"currency\": \"GHS\",\n        \"fee\": 1.87,\n        \"vat\": 0.13,\n        \"auth_model\": \"OTP\",\n        \"transaction_reference\": \"KPY-CA-tp6S3eI1AY6g\",\n        \"payment_reference\": \"idkMain27105551026\",\n        \"status\": \"processing\",\n        \"narration\": \"Payment for a emilokan\",\n        \"message\": \"Token generated and sent out successfully\",\n        \"mobile_money\": {\n            \"number\": \"+233240000000\"\n        },\n        \"customer\": {\n            \"name\": \"John Doe\",\n            \"email\": \"uchenna@korapay.com\"\n        }\n    }\n}"},{"id":"aea75a65-909f-4fe1-8e59-48804859bf1a","name":"Success – STK","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 70,\n    \"currency\": \"KES\",\n    \"reference\": \"idkMain27105551060\",\n    \"description\": \"Payment for a emilokan\",\n    \"notification_url\": \"https://webhook.site/1c209942-1a66-4cdf-a7ab-78d9cc684ad2\",\n    \"redirect_url\": \"https://webhook.site\",\n    \"customer\": {\n        \"name\": \"John Doe\",\n        \"email\": \"john@email.com\"\n    },\n    \"merchant_bears_cost\": false,\n    \"mobile_money\": {\n      \"number\": \"254700000000\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/mobile-money"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 21 Aug 2023 09:50:28 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"5b-3tbVn2xdiLUTs8e+1nX3IeMWzwo\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7fa1f8d32c88dd70-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Authorization required\",\n    \"data\": {\n        \"amount\": 70,\n        \"amount_expected\": 77.5,\n        \"currency\": \"KES\",\n        \"fee\": 7.01,\n        \"vat\": 0.49,\n        \"auth_model\": \"STK_PROMPT\",\n        \"transaction_reference\": \"KPY-CA-HttHaaEeUbRK\",\n        \"payment_reference\": \"idkMain27105551060\",\n        \"status\": \"processing\",\n        \"narration\": \"Payment for a emilokan\",\n        \"message\": \"You will receive a pin prompt on your mobile number +254700000000 for KES 77.5. Kindly enter your wallet PIN to authorize the payment\",\n        \"mobile_money\": {\n            \"number\": \"+254700000000\"\n        },\n        \"customer\": {\n            \"name\": \"John Doe\",\n            \"email\": \"uchenna@korapay.com\"\n        }\n    }\n}"},{"id":"d1c4ceb9-7f55-48ee-9bc6-1dd8f9891cfa","name":"Invalid Phone Number","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 701,\n    \"currency\": \"KES\",\n    \"reference\": \"idkMain27105551027\",\n    \"description\": \"Payment for a emilokan\",\n    \"notification_url\": \"https://webhook.site/1c209942-1a66-4cdf-a7ab-78d9cc684ad2\",\n    \"redirect_url\": \"https://webhook.site\",\n    \"customer\": {\n        \"name\": \"John Doe\",\n        \"email\": \"john@email.com\"\n    },\n    \"merchant_bears_cost\": true,\n    \"mobile_money\": {\n      \"number\": \"233240000000\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/mobile-money"},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 21 Aug 2023 09:50:28 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"5b-3tbVn2xdiLUTs8e+1nX3IeMWzwo\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7fa1f8d32c88dd70-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Invalid phone number: 233240000000\",\n    \"data\": null\n}"},{"id":"4a591c7d-1213-4e2d-bf81-2ba592697906","name":"Duplicate Reference","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 701,\n    \"currency\": \"GHS\",\n    \"reference\": \"idkMain27105551024\",\n    \"description\": \"Payment for a emilokan\",\n    \"notification_url\": \"https://webhook.site/1c209942-1a66-4cdf-a7ab-78d9cc684ad2\",\n    \"redirect_url\": \"https://webhook.site\",\n    \"customer\": {\n        \"name\": \"John Doe\",\n        \"email\": \"john@email.com\"\n    },\n    \"merchant_bears_cost\": true,\n    \"mobile_money\": {\n      \"number\": \"233240000000\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/mobile-money"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 21 Aug 2023 09:50:28 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"5b-3tbVn2xdiLUTs8e+1nX3IeMWzwo\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7fa1f8d32c88dd70-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Duplicate payment reference\",\n    \"data\": null\n}"}],"_postman_id":"ced34c62-951c-4b12-b751-9b36f0d93d93"},{"name":"Authorize Mobile Money - Step 2","id":"c21b6a5a-9396-4ac4-af68-b8521c30f518","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"KPY-CA-hVuzyZ4qPGGV\",\n    \"token\": \"123456\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/mobile-money/authorize","description":"<p>The next step is based on the auth model returned in the previous response after initiating the charge. There are 2 ways of authorizing a transaction <code>OTP</code> and <code>STK_PROMPT</code>.</p>\n<h3 id=\"authorizing-an-otp-transaction\">Authorizing an OTP transaction</h3>\n<p>After making the request to charge the number, if the status of the transaction is processing and auth_model is OTP, this means an OTP has been sent to the wallet owner's phone. You would need to collect the OTP in order to authorize the transaction.</p>\n<p>Collect the OTP sent to the customer’s phone and make a request to our authorize endpoint with the OTP and the transaction reference.</p>\n<p>If the OTP verification is successful, an STK prompt will be sent to the wallet owner's phone for him to enter his PIN.</p>\n","urlObject":{"path":["merchant","api","v1","charges","mobile-money","authorize"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"095194d7-b3e8-45ed-ba2d-9f45bded3d91","name":"Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"KPY-CA-hVuzyZ4qPGGV\",\n    \"token\": \"123456\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/mobile-money/authorize"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 29 Aug 2023 11:07:25 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"97"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"61-qYspsfmRrJTp/1jxLLVi81OsLPM\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Set-Cookie","value":"__cf_bm=HQSKtrY8soPigQ_64GcMjq_z38czyEe_KXj_PyOJrlA-1693307245-0-AYPdAFiWbTL/CHZnKY78OvN9NQXmlYy7WVgYksHW5iC7bikP4kkcNTy6XxLoQlBmwDUW600fKOG/cs0N1dT2PVc=; path=/; expires=Tue, 29-Aug-23 11:37:25 GMT; domain=.korapay.com; HttpOnly; Secure; SameSite=None"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7fe4548c79fd5351-LOS"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Authorization required\",\n    \"data\": {\n        \"amount\": \"70.00\",\n        \"amount_expected\": \"71.87\",\n        \"currency\": \"GHS\",\n        \"fee\": 1.75,\n        \"vat\": 0.12,\n        \"auth_model\": \"STK_PROMPT\",\n        \"transaction_reference\": \"KPY-CA-JyAOpuOw9O9A\",\n        \"payment_reference\": \"idkMain27105551057\",\n        \"status\": \"processing\",\n        \"message\": \"You will receive a prompt on mobile number. Kindly enter your wallet PIN to authorize the payment\",\n        \"mobile_money\": {\n            \"number\": \"+233240000000\"\n        }\n    }\n}"},{"id":"e2904e1e-d677-4d15-a3f8-175dbd071ea0","name":"OTP Not Required","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"KPY-CA-hVuzyZ4qPGGV\",\n    \"token\": \"123456\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/mobile-money/authorize"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 29 Aug 2023 11:07:25 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"97"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"61-qYspsfmRrJTp/1jxLLVi81OsLPM\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Set-Cookie","value":"__cf_bm=HQSKtrY8soPigQ_64GcMjq_z38czyEe_KXj_PyOJrlA-1693307245-0-AYPdAFiWbTL/CHZnKY78OvN9NQXmlYy7WVgYksHW5iC7bikP4kkcNTy6XxLoQlBmwDUW600fKOG/cs0N1dT2PVc=; path=/; expires=Tue, 29-Aug-23 11:37:25 GMT; domain=.korapay.com; HttpOnly; Secure; SameSite=None"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7fe4548c79fd5351-LOS"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"OTP is not required for this transaction\",\n    \"data\": null\n}"},{"id":"e7a40f23-c44f-4dac-8fdd-20fc3725ef27","name":"Invalid OTP","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"KPY-CA-hVuzyZ4qPGGV\",\n    \"token\": \"123455\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/mobile-money/authorize"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 29 Aug 2023 11:07:25 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"97"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"61-qYspsfmRrJTp/1jxLLVi81OsLPM\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Set-Cookie","value":"__cf_bm=HQSKtrY8soPigQ_64GcMjq_z38czyEe_KXj_PyOJrlA-1693307245-0-AYPdAFiWbTL/CHZnKY78OvN9NQXmlYy7WVgYksHW5iC7bikP4kkcNTy6XxLoQlBmwDUW600fKOG/cs0N1dT2PVc=; path=/; expires=Tue, 29-Aug-23 11:37:25 GMT; domain=.korapay.com; HttpOnly; Secure; SameSite=None"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7fe4548c79fd5351-LOS"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Authorization required\",\n    \"data\": {\n        \"amount\": \"70.00\",\n        \"amount_expected\": \"71.87\",\n        \"currency\": \"GHS\",\n        \"fee\": 1.75,\n        \"vat\": 0.12,\n        \"auth_model\": \"OTP\",\n        \"transaction_reference\": \"KPY-CA-cL3kfnJ0KLid\",\n        \"payment_reference\": \"idkMain27105551058\",\n        \"status\": \"processing\",\n        \"message\": \"The OTP you provided is invalid\",\n        \"mobile_money\": {\n            \"number\": \"233240000000\"\n        },\n        \"attempts_left\": 2\n    }\n}"},{"id":"7b9a5375-6cdb-4720-8457-aa8b6c9e27f5","name":"OTP attempts exceeded","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"KPY-CA-hVuzyZ4qPGGV\",\n    \"token\": \"123455\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/mobile-money/authorize"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 29 Aug 2023 11:07:25 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"97"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"61-qYspsfmRrJTp/1jxLLVi81OsLPM\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Set-Cookie","value":"__cf_bm=HQSKtrY8soPigQ_64GcMjq_z38czyEe_KXj_PyOJrlA-1693307245-0-AYPdAFiWbTL/CHZnKY78OvN9NQXmlYy7WVgYksHW5iC7bikP4kkcNTy6XxLoQlBmwDUW600fKOG/cs0N1dT2PVc=; path=/; expires=Tue, 29-Aug-23 11:37:25 GMT; domain=.korapay.com; HttpOnly; Secure; SameSite=None"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7fe4548c79fd5351-LOS"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Payment failed\",\n    \"data\": {\n        \"amount\": \"70.00\",\n        \"amount_expected\": \"71.87\",\n        \"currency\": \"GHS\",\n        \"fee\": 1.75,\n        \"vat\": 0.12,\n        \"auth_model\": \"OTP\",\n        \"transaction_reference\": \"KPY-CA-cL3kfnJ0KLid\",\n        \"payment_reference\": \"idkMain27105551058\",\n        \"status\": \"failed\",\n        \"message\": \"OTP attempts exceeded\",\n        \"mobile_money\": {\n            \"number\": \"233240000000\"\n        },\n        \"attempts_left\": 0\n    }\n}"},{"id":"acdd1876-d049-4d76-a803-77fa7c301aa6","name":"Transaction already completed","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"KPY-CA-hVuzyZ4qPGGV\",\n    \"token\": \"123455\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/mobile-money/authorize"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 29 Aug 2023 11:07:25 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"97"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"61-qYspsfmRrJTp/1jxLLVi81OsLPM\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Set-Cookie","value":"__cf_bm=HQSKtrY8soPigQ_64GcMjq_z38czyEe_KXj_PyOJrlA-1693307245-0-AYPdAFiWbTL/CHZnKY78OvN9NQXmlYy7WVgYksHW5iC7bikP4kkcNTy6XxLoQlBmwDUW600fKOG/cs0N1dT2PVc=; path=/; expires=Tue, 29-Aug-23 11:37:25 GMT; domain=.korapay.com; HttpOnly; Secure; SameSite=None"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7fe4548c79fd5351-LOS"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Transaction has already been completed\",\n    \"data\": null\n}"}],"_postman_id":"c21b6a5a-9396-4ac4-af68-b8521c30f518"},{"name":"Resend OTP","id":"936e4a78-4d0c-4c5f-b1bf-775e77434c77","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"transaction_reference\": \"KPY-CA-8pWT28OW7RJM\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/mobile-money/resend-otp","description":"<p>This endpoint allows you to resend OTP in a situation where the initial OTP recieved had expired or was not recieved at all.</p>\n","urlObject":{"path":["merchant","api","v1","charges","mobile-money","resend-otp"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"63aed5b6-c741-4f90-bc4d-cb4a68df4d6d","name":"Success","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n    \"transaction_reference\": \"KPY-CA-8pWT28OW7RJM\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/mobile-money/resend-otp"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Kindly enter the OTP sent to your phone or email\",\n    \"data\": null\n}"},{"id":"b8a8a7ac-72ae-45ca-be43-7d74397b6401","name":"Resend OTP attempts exceeded","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n    \"transaction_reference\": \"KPY-CA-8pWT28OW7RJM\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/mobile-money/resend-otp"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Resend OTP attempts exceeded\",\n    \"data\": null\n}"}],"_postman_id":"936e4a78-4d0c-4c5f-b1bf-775e77434c77"},{"name":"Resend STK","id":"0fce8dda-96b4-470e-b1ce-be3759052257","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"transaction_reference\": \"KPY-CA-8pWT28OW7RJM\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/mobile-money/resend-stk","description":"<p>This endpoint allows you to resend the STK prompt in a situation where the initial STK prompt recieved had expired or was not recieved at all.</p>\n","urlObject":{"path":["merchant","api","v1","charges","mobile-money","resend-stk"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"90658ae5-d7dd-41a9-8cfe-09bed7ed8d44","name":"Success","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n    \"transaction_reference\": \"KPY-CA-8pWT28OW7RJM\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/mobile-money/resend-stk"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Kindly authorize transaction with the new STK sent to your phone\",\n    \"data\": null\n}"},{"id":"4dd6acbc-b56e-44c2-bca7-5c65da7fb110","name":"Resend STK attempts exceeded","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n    \"transaction_reference\": \"KPY-CA-8pWT28OW7RJM\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/mobile-money/resend-stk"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Resend STK attempts exceeded\",\n    \"data\": null\n}"}],"_postman_id":"0fce8dda-96b4-470e-b1ce-be3759052257"},{"name":"Authorize STK Mobile Money - (Sandbox)","id":"2ab77627-79ed-4044-b090-172a2e0ca062","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{test_secret_key}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"KPY-CA-hVuzyZ4qPGGV\",\n    \"pin\": \"1234\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/mobile-money/sandbox/authorize-stk","description":"<h3 id=\"authorizing-an-stk-transaction\">Authorizing an STK transaction</h3>\n<p>This endpoint allows you to authorize the transaction in the Sandbox environment. It is meant to simulate a wallet owner entering their wallet PIN at the STK prompt.</p>\n<p><em>Note that you can only call this endpoint with your test secret key.</em></p>\n","urlObject":{"path":["merchant","api","v1","charges","mobile-money","sandbox","authorize-stk"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"2343fc6b-2df4-4f25-9071-4078c07240d9","name":"Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"KPY-CA-QyFSGvIWHDTE\",\n    \"pin\": \"1234\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/mobile-money/sandbox/authorize-stk"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Approved by financial institution\",\n    \"data\": {\n        \"amount\": \"1000.00\",\n        \"amount_expected\": \"1000.00\",\n        \"currency\": \"GHS\",\n        \"fee\": 0,\n        \"vat\": 0,\n        \"auth_model\": \"STK_PROMPT\",\n        \"transaction_reference\": \"KPY-CA-QyFSGvIWHDTE\",\n        \"payment_reference\": \"idkMain27105551080\",\n        \"status\": \"success\",\n        \"message\": \"Approved by financial institution\",\n        \"mobile_money\": {\n            \"number\": \"+233240000000\"\n        }\n    }\n}"},{"id":"ec89e01c-4bf1-4d1d-9ca5-f4bd799a19f0","name":"STK not required","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"KPY-CA-qHDxMguFb7li\",\n    \"pin\": \"1234\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/mobile-money/sandbox/authorize-stk"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"STK is not required for this transaction\",\n    \"data\": null\n}"},{"id":"17fd4de0-9755-4947-9c2a-3a96771a89e2","name":"Transaction already completed","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"KPY-CA-JrhjPLCTFYPc\",\n    \"pin\": \"1233\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/mobile-money/sandbox/authorize-stk"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Transaction has already been completed\",\n    \"data\": null\n}"}],"_postman_id":"2ab77627-79ed-4044-b090-172a2e0ca062"}],"id":"7505356e-7b28-492a-827c-f248d992dfb1","description":"<p>We currently only support payments in Kenyan Shillings and Ghanaian Cedis. For Kenya, we support the following wallets; Mpesa, Airtel, and Equitel. While for Ghana we support; MTN Momo and Airtel Tigo. Here are some <a href=\"https://developers.korapay.com/docs/testing-your-integration#testing-mobile-money-pay-ins\">test mobile money numbers</a> we created to help you simulate different scenarios for mobile money payments as you integrate</p>\n","_postman_id":"7505356e-7b28-492a-827c-f248d992dfb1","auth":{"type":"noauth","isInherited":true,"source":{"_postman_id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","name":"Pay-ins","type":"folder"}}},{"name":"Checkout Redirect","item":[{"name":"Initialize Charge","id":"f192d2e8-aab2-4f5a-98ef-fa0ed7e2d853","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 6000,\n    \"redirect_url\": \"https://korapay.com?order=1234\",\n    \"currency\": \"NGN\",\n    \"reference\": \"test-postman-transaction-1\",\n    \"narration\": \"Payment for product Y\",\n    \"merchant_bears_cost\": false,\n    \"customer\": {\n        \"name\": \"John Doe\",\n        \"email\": \"john@email.com\"\n    },\n    \"notification_url\": \"https://webhook.site/8d321d8d-397f-4bab-bf4d-7e9ae3afbd50\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/initialize","description":"<p>The Charge API allows you to configure payment channel of your choice when initiating a payment.</p>\n<p>This endpoint also supports split payments using the description provided in the request body below.</p>\n<h2 id=\"request-body\">Request Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>amount</td>\n<td>number</td>\n<td><code>Required</code> The amount to charge the customer</td>\n</tr>\n<tr>\n<td>redirect_url</td>\n<td>string</td>\n<td><code>Optional</code> The URL to redirect your customer when the transaction is complete.</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>string</td>\n<td><code>Required</code> The currency in which the customer should be charged.</td>\n</tr>\n<tr>\n<td>reference</td>\n<td>string</td>\n<td><code>Required</code> Your transaction reference. Must be unique for every transaction.</td>\n</tr>\n<tr>\n<td>channels</td>\n<td>array</td>\n<td><code>Optional</code> Allowed payment channels for this transaction. Example <code>['card', 'bank_transfer', 'mobile_money']</code>.</td>\n</tr>\n<tr>\n<td>default_channel</td>\n<td>string</td>\n<td><code>Optional</code> The channel that shows up when the modal is instantiated. Example <code>bank_transfer</code></td>\n</tr>\n<tr>\n<td>notification_url</td>\n<td>string</td>\n<td><code>Required</code> The webhook URL to be called when the transaction is complete.</td>\n</tr>\n<tr>\n<td>narration</td>\n<td>string</td>\n<td><code>Required</code> This is the transaction description.</td>\n</tr>\n<tr>\n<td>customer</td>\n<td>object</td>\n<td><code>Required</code></td>\n</tr>\n<tr>\n<td>customer.email</td>\n<td>string</td>\n<td><code>Required</code> Customer Email</td>\n</tr>\n<tr>\n<td>customer.name</td>\n<td>string</td>\n<td><code>Optional</code> Customer Name</td>\n</tr>\n<tr>\n<td>split_reference</td>\n<td>string</td>\n<td><code>Optional</code> Required only if you want split payment to be made using the existing split rule reference on your merchant dashboard.  <br />  <br />Do not provide the <code>split_configuration</code> field if this field is supplied.</td>\n</tr>\n<tr>\n<td>split_configuration.split_type</td>\n<td>string</td>\n<td><code>Optional</code> Required only when applying split payments with a dynamic split configuration, without creating a split rule on your merchant dashboard.  <br />  <br />This field accepts either a <code>percentage</code> or a <code>flat</code> value.  <br />  <br />Do not provide the <code>split_reference</code> field if this field is supplied.</td>\n</tr>\n<tr>\n<td>split_configuration.split_accounts[0].value</td>\n<td>string</td>\n<td><code>Optional</code> Required only when applying split payments with a dynamic split configuration, without creating a split rule on your merchant dashboard.  <br />  <br />If <code>split_type</code> is set to <code>percentage</code>, provide the value as a percentage (include the % symbol).  <br />If <code>split_type</code> is <code>flat</code>, provide the value as a numeric amount (exclude the currency).  <br />  <br />Do not provide the <code>split_reference</code> field if this field is supplied.</td>\n</tr>\n<tr>\n<td>split_configuration.split_accounts[0].split_account_reference</td>\n<td>string</td>\n<td><code>Optional</code> Required only when applying split payments with a dynamic split configuration, without creating a split rule on your merchant dashboard.  <br />  <br />The value must be a valid split account reference from your merchant dashboard.  <br />  <br />Do not provide the <code>split_reference</code> field if this field is supplied.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"successful-response-body\">Successful Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>boolean</td>\n<td>request status <code>true</code></td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>request status message</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>object containing charge details: reference, checkout_url</td>\n</tr>\n<tr>\n<td>reference</td>\n<td>string</td>\n<td>charge reference</td>\n</tr>\n<tr>\n<td>checkout_url</td>\n<td>string</td>\n<td>checkout url to be used to complete the payment</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"failed-response-body\">Failed Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>boolean</td>\n<td>request status <code>false</code></td>\n</tr>\n<tr>\n<td>error</td>\n<td>string</td>\n<td>error returned</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>error description</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>error data</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","charges","initialize"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"7cf7fe4a-1c7c-47e5-8644-cd46dc70a8dc","name":"Initialize Charge","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 6000,\n    \"redirect_url\": \"https://korapay.com?order=1234\",\n    \"currency\": \"NGN\",\n    \"reference\": \"test-postman-transaction-1234719\",\n    \"narration\": \"Payment for product Y\",\n    \"merchant_bears_cost\": false,\n    \"customer\": {\n        \"name\": \"John Doe\",\n        \"email\": \"john@email.com\"\n    },\n    \"notification_url\": \"https://webhook.site/8d321d8d-397f-4bab-bf4d-7e9ae3afbd50\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/initialize"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Wed, 17 Sep 2025 17:58:22 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"c0-hZLDl8Vj5eVgzq9TKlREV8CXDiU\""},{"key":"vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"content-security-policy","value":"frame-ancestors 'none'"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"980a7db1f9fe1ef2-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Charge created successfully\",\n    \"data\": {\n        \"reference\": \"test-postman-transaction-1234719\",\n        \"checkout_url\": \"https://checkout.korapay.com/KPY-PI-202509171758oDUd0V19327/pay\"\n    }\n}"},{"id":"abd94333-4ce0-46a3-a5ae-2709802394ee","name":"Initialize Charge With Existing Split Reference","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 6000,\n    \"redirect_url\": \"https://korapay.com?order=1234\",\n    \"currency\": \"NGN\",\n    \"reference\": \"test-postman-transaction-12345\",\n    \"narration\": \"Payment for product Y\",\n    \"merchant_bears_cost\": false,\n    \"customer\": {\n        \"name\": \"John Doe\",\n        \"email\": \"john@email.com\"\n    },\n    \"notification_url\": \"https://webhook.site/8d321d8d-397f-4bab-bf4d-7e9ae3afbd50\",\n    \"split_reference\": \"KPY-SAS-12345\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/initialize"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 17 Sep 2025 17:44:39 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"be-6/7Wac95TXzdfErtu/BBAlpHqNA\""},{"key":"vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"content-security-policy","value":"frame-ancestors 'none'"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"980a6999e84d6341-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Charge created successfully\",\n    \"data\": {\n        \"reference\": \"test-postman-transaction-12345\",\n        \"checkout_url\": \"https://checkout.korapay.com/KPY-PI-202509171744yxuDov36332/pay\"\n    }\n}"},{"id":"4aa0061d-8a85-4f7e-9847-7f32e6576330","name":"Initialize Charge With Dynamic Percentage Type Split Configuration","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 6000,\n    \"redirect_url\": \"https://korapay.com?order=1234\",\n    \"currency\": \"NGN\",\n    \"reference\": \"test-postman-transaction-123456\",\n    \"narration\": \"Payment for product Y\",\n    \"merchant_bears_cost\": false,\n    \"customer\": {\n        \"name\": \"John Doe\",\n        \"email\": \"john@email.com\"\n    },\n    \"notification_url\": \"https://webhook.site/8d321d8d-397f-4bab-bf4d-7e9ae3afbd50\",\n    \"split_configuration\": {\n        \"split_type\": \"percentage\",\n        \"split_accounts\": [\n            {\n                \"value\": \"30\",\n                \"split_account_reference\" : \"KPY-SPA-12345\"\n            },\n            {\n                \"value\": \"25\",\n                \"split_account_reference\" : \"KPY-SPA-12345678\"\n            }\n        ]\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/initialize"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 17 Sep 2025 17:46:33 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"bf-h8SmZ5DvxSDupq6nMEE6+wPR+20\""},{"key":"vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"content-security-policy","value":"frame-ancestors 'none'"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"980a6c655954ed0c-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Charge created successfully\",\n    \"data\": {\n        \"reference\": \"test-postman-transaction-123456\",\n        \"checkout_url\": \"https://checkout.korapay.com/KPY-PI-202509171746S5yZVy30765/pay\"\n    }\n}"},{"id":"7b2281f4-e673-45ac-b6c6-02cb5051a818","name":"Error Response: Split Payment Minimum Amount Validation","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 6000,\n    \"redirect_url\": \"https://korapay.com?order=1234\",\n    \"currency\": \"NGN\",\n    \"reference\": \"test-postman-transaction-123471\",\n    \"narration\": \"Payment for product Y\",\n    \"merchant_bears_cost\": false,\n    \"customer\": {\n        \"name\": \"John Doe\",\n        \"email\": \"john@email.com\"\n    },\n    \"notification_url\": \"https://webhook.site/8d321d8d-397f-4bab-bf4d-7e9ae3afbd50\",\n    \"split_configuration\": {\n        \"split_type\": \"flat\",\n        \"split_accounts\": [\n            {\n                \"value\": \"3000\",\n                \"split_account_reference\" : \"KPY-SPA-12345\"\n            },\n            {\n                \"value\": \"2500\",\n                \"split_account_reference\" : \"KPY-SPA-123456\"\n            }\n        ]\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charges/initialize"},"status":"Bad Request","code":400,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Wed, 17 Sep 2025 17:53:39 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"149"},{"key":"Connection","value":"keep-alive"},{"key":"CF-RAY","value":"980a76dc8de7edf8-LHR"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"95-gvOUFSnRzmQrn+ApnJ0oyvJGnNI\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"code\": \"AA027\",\n    \"message\": \"Split payment can only be applied on NGN7150 and above using the selected split configuration\",\n    \"data\": null\n}"}],"_postman_id":"f192d2e8-aab2-4f5a-98ef-fa0ed7e2d853"}],"id":"7e503671-3383-4ee4-b0fc-eafe686033c5","_postman_id":"7e503671-3383-4ee4-b0fc-eafe686033c5","description":"","auth":{"type":"noauth","isInherited":true,"source":{"_postman_id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","name":"Pay-ins","type":"folder"}}},{"name":"Pay With Bank","item":[{"name":"Initiate - Direct Debit","id":"e239a5b5-6c23-4aac-b03e-758ae5b30cc7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 600,\n    \"currency\": \"NGN\",\n    \"reference\": \"CPY-GB-h2223320000024hhh\",\n    \"bank_code\": \"100004\",\n    \"redirect_url\": \"https://www.example.com\",\n    \"customer\": {\n        \"name\": \"John Doe\",\n        \"email\": \"john@email.com\"\n    },\n    \"narration\": \"Payment for Cloth\",\n    \"merchant_bears_cost\": true,\n    \"notification_url\": \"https://webhook.site/b97227be-3cc0-4572-9a45-0cf944b976d3\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charge/pay-with-bank","description":"<p>This API allows you to initiate a Pay With Bank for direct debit collections for your customers.</p>\n<h2 id=\"request-body\">Request Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Required?</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>amount</td>\n<td>Number</td>\n<td>True</td>\n<td>The amount of money to be debited. Minimum is NGN 200.00.</td>\n</tr>\n<tr>\n<td>bank_code</td>\n<td>String</td>\n<td>True</td>\n<td>The unique code for each supported bank. Please refer to the <a href=\"https://developers.korapay.com/docs/pay-with-bank-direct-debit#bank-codes-ngn\">bank codes table</a> below. You can only pass bank codes for the banks that have been enabled for your account.</td>\n</tr>\n<tr>\n<td>redirect_url</td>\n<td>String</td>\n<td>False</td>\n<td>The URL redirected to after transaction is completed.</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>String</td>\n<td>True</td>\n<td>The currency of the transaction.</td>\n</tr>\n<tr>\n<td>reference</td>\n<td>String</td>\n<td>True</td>\n<td>A unique reference for the payment. This reference must be at least 8 characters long.</td>\n</tr>\n<tr>\n<td>customer.name</td>\n<td>String</td>\n<td>True</td>\n<td>The name of your customer.</td>\n</tr>\n<tr>\n<td>customer.email</td>\n<td>String</td>\n<td>True</td>\n<td>The email of your customer.</td>\n</tr>\n<tr>\n<td>merchant_bears_cost</td>\n<td>Boolean</td>\n<td>False</td>\n<td>This sets who bears the fees of the transaction. If it is set to <code>true</code>, the merchant will bear the fee. If it is set to <code>false</code>, the customer will bear the fee. By default, it is set to <code>false</code>.</td>\n</tr>\n<tr>\n<td>narration</td>\n<td>String</td>\n<td>False</td>\n<td>Information/narration about the transaction.</td>\n</tr>\n<tr>\n<td>notification_url</td>\n<td>String</td>\n<td>False</td>\n<td>The webhook URL to be called when the transaction is complete.</td>\n</tr>\n<tr>\n<td>metadata</td>\n<td>Object</td>\n<td>False</td>\n<td>It takes a JSON object with a maximum of 5 fields/keys. Empty JSON objects are not allowed. Each field name has a maximum length of 20 characters. Allowed characters: <code>A-Z</code>, <code>a-z</code>, <code>0-9</code>, and <code>-</code>.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"successful-response-body\">Successful Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>Request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>Request status message</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>The object containing charge details</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>string</td>\n<td>The currency for the charge</td>\n</tr>\n<tr>\n<td>amount</td>\n<td>number</td>\n<td>Amount to charge</td>\n</tr>\n<tr>\n<td>fee</td>\n<td>number</td>\n<td>The fee charged for this transaction</td>\n</tr>\n<tr>\n<td>vat</td>\n<td>number</td>\n<td>The value added tax for this transaction</td>\n</tr>\n<tr>\n<td>transaction_reference</td>\n<td>string</td>\n<td>The reference for each attempted transaction</td>\n</tr>\n<tr>\n<td>payment_reference</td>\n<td>string</td>\n<td>The reference for this payment</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>The status of the transaction e.g <code>success</code>, <code>processing</code>, <code>failed</code></td>\n</tr>\n<tr>\n<td>merchant_bears_cost</td>\n<td>boolean</td>\n<td>This sets who bears the fees of the transaction. If it is set to true, the merchant will bear the fee. If it is set to false, the customer will bear the fee. By default, it is set to false.</td>\n</tr>\n<tr>\n<td>customer</td>\n<td>object</td>\n<td>Object containing the customer details</td>\n</tr>\n<tr>\n<td>customer.name</td>\n<td>string</td>\n<td>The name of the customer</td>\n</tr>\n<tr>\n<td>customer.email</td>\n<td>string</td>\n<td>The email of the customer</td>\n</tr>\n<tr>\n<td>narration</td>\n<td>string</td>\n<td>Information/narration about the transaction</td>\n</tr>\n<tr>\n<td>authorization</td>\n<td>object</td>\n<td>Object containing authorization information</td>\n</tr>\n<tr>\n<td>authorization.redirect_url</td>\n<td>string</td>\n<td>The redirect url to proceed with payment</td>\n</tr>\n<tr>\n<td>bank_account</td>\n<td>object</td>\n<td>Object containing the bank details</td>\n</tr>\n<tr>\n<td>bank_name</td>\n<td>string</td>\n<td>The bank name for the transaction</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"failed-response-body\">Failed Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>Request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>Request status message</td>\n</tr>\n<tr>\n<td>code</td>\n<td>string</td>\n<td>Request code</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>object containing extra information about the error</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","charge","pay-with-bank"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"f4fa3cf5-14d5-4989-8e76-eafbb56ba0e3","name":"Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 600,\n    \"currency\": \"NGN\",\n    \"reference\": \"CPY-GB-h2223320000024hhh\",\n    \"bank_code\": \"100004\",\n     \"redirect_url\": \"https://www.example.com\",\n    \"customer\": {\n        \"name\": \"John Doe\",\n        \"email\": \"john@email.com\"\n    },\n    \"narration\": \"Payment for Cloth\",\n    \"merchant_bears_cost\": true,\n    \"notification_url\": \"https://webhook.site/b97227be-3cc0-4572-9a45-0cf944b976d3\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charge/pay-with-bank"},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Pay With Bank initiated successfully\",\n    \"data\": {\n        \"currency\": \"NGN\",\n        \"amount\": 600,\n        \"fee\": 25,\n        \"vat\": 1.88,\n        \"transaction_reference\": \"KPY-CA-qVa4wceXkwEpMPw\",\n        \"payment_reference\": \"CPY-GB-h2223320000024hhh\",\n        \"status\": \"processing\",\n        \"merchant_bears_cost\": true,\n        \"customer\": {\n            \"name\": \"John Doe\",\n            \"email\": \"johndoe@korapay.com\"\n        },\n        \"narration\": \"Payment for Cloth\",\n        \"authorization\": {\n            \"redirect_url\": \"https://redirect.example.com/redirect/payment/KPY-CA-qVa4wceXkwEpMPw\"\n        },\n        \"bank_account\": {\n            \"bank_name\": \"Opay\"\n        },\n        \"message\": \"SUCCESSFUL\"\n    }\n}"},{"id":"0bd7f52d-cea9-4f48-92e4-68df3626ea55","name":"Duplicate Reference Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 600,\n    \"currency\": \"NGN\",\n    \"reference\": \"CPY-GB-h2223320000024hhh\",\n    \"bank_code\": \"100004\",\n     \"redirect_url\": \"https://www.example.com\",\n    \"customer\": {\n        \"name\": \"John Doe\",\n        \"email\": \"john@email.com\"\n    },\n    \"narration\": \"Payment for Cloth\",\n    \"merchant_bears_cost\": true,\n    \"notification_url\": \"https://webhook.site/b97227be-3cc0-4572-9a45-0cf944b976d3\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charge/pay-with-bank"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 05 Jun 2023 19:27:30 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"83"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"53-Jw763a/WHHXKpJC1At63iv/g3n0\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7d2ad0365b1a71e1-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"code\": \"AA021\",\n    \"message\": \"duplicate payment reference\",\n    \"data\": null\n}"},{"id":"df6932b9-b141-4d6b-a288-4c9fd901d042","name":"Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 600,\n    \"currency\": \"NGN\",\n    \"reference\": \"CPY-GB-h2223320000024hhh\",\n    \"bank_code\": \"100004\",\n    \"redirect_url\": \"https://www.example.com\",\n    \"customer\": {\n        \"name\": \"John Doe\",\n        \"email\": \"john@email.com\"\n    },\n    \"narration\": \"Payment for Cloth\",\n    \"merchant_bears_cost\": true,\n    \"notification_url\": \"https://webhook.site/b97227be-3cc0-4572-9a45-0cf944b976d3\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charge/pay-with-bank"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 05 Jun 2023 19:26:32 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"164"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"a4-S+cukwMiB4IqcKBSxZNq9H+OCcA\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Set-Cookie","value":"__cf_bm=aRyuyD8tJqtyI0GviMNYykSiVQPuItmb8ueRFDFPdiA-1685993192-0-AaK5Tp0xdya5qKV0kHrGsSMVMjRe4R1XB35oCp7bwGt43sIEWRXoH7O8Hu4paavKy/bq2qqcRi/felwCzBc1dBA=; path=/; expires=Mon, 05-Jun-23 19:56:32 GMT; domain=.korapay.com; HttpOnly; Secure; SameSite=None"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7d2acecb499271e1-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"bad_request\",\n    \"message\": \"invalid request data\",\n    \"data\": {\n        \"amount\": {\n            \"message\": \"amount is required\",\n            \"customErrorMessage\": \"amount is required\"\n        }\n    }\n}"}],"_postman_id":"e239a5b5-6c23-4aac-b03e-758ae5b30cc7"},{"name":"Initiate - Instant EFT","id":"3fa7041a-b825-49da-b2b8-7904ec27644b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 600,\n    \"currency\": \"ZAR\",\n    \"reference\": \"CPY-DF-hdjkdhjjd24222d1434\",\n    \"bank_code\": \"198765\",\n    \"customer\": {\n        \"name\": \"John Doe\",\n        \"email\": \"john@email.com\"\n    },\n    \"merchant_bears_cost\": false,\n    \"notification_url\": \"https://webhook.site/b97227be-3cc0-4572-9a45-0cf944b976d3\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charge/pay-with-bank","description":"<p>This allows you to integrate our Pay with Bank (Instant EFT) APIs to accept ZAR payments. Simply call the endpoint, after which you will receive a redirect URL that will be used to complete the payment process.</p>\n<h2 id=\"request-body\">Request Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><br />  <br />Field  <br />  <br /></th>\n<th><br />  <br />Data Type  <br />  <br /></th>\n<th><br />  <br />Required?  <br />  <br /></th>\n<th><br />  <br />Description  <br />  <br /></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><br />  <br />amount  <br />  <br /></td>\n<td><br />  <br />Number  <br />  <br /></td>\n<td><br />  <br />True  <br />  <br /></td>\n<td><br />  <br />The amount of money to be debited.  <br />  <br /></td>\n</tr>\n<tr>\n<td><br />  <br />bank_code  <br />  <br /></td>\n<td><br />  <br />String  <br />  <br /></td>\n<td><br />  <br />True  <br />  <br /></td>\n<td><br />  <br />The unique code for each supported bank. Please refer to the <a href=\"https://developers.korapay.com/docs/pay-with-bank-instant-eft#zar-bank-codes\">bank codes table</a> below. You can only pass bank codes for the banks that have been enabled for your account.  <br />  <br /></td>\n</tr>\n<tr>\n<td><br />  <br />currency  <br />  <br /></td>\n<td><br />  <br />String  <br />  <br /></td>\n<td><br />  <br />True  <br />  <br /></td>\n<td><br />  <br />The currency of the transaction.  <br />  <br /></td>\n</tr>\n<tr>\n<td><br />  <br />reference  <br />  <br /></td>\n<td><br />  <br />String  <br />  <br /></td>\n<td><br />  <br />True  <br />  <br /></td>\n<td><br />  <br />A unique reference for the payment. This reference must be at least 8 characters long.  <br />  <br /></td>\n</tr>\n<tr>\n<td><br />  <br />customer.name  <br />  <br /></td>\n<td><br />  <br />String  <br />  <br /></td>\n<td><br />  <br />True  <br />  <br /></td>\n<td><br />  <br />The name of your customer.  <br />  <br /></td>\n</tr>\n<tr>\n<td><br />  <br />customer.email  <br />  <br /></td>\n<td><br />  <br />String  <br />  <br /></td>\n<td><br />  <br />True  <br />  <br /></td>\n<td><br />  <br />The email of your customer.  <br />  <br /></td>\n</tr>\n<tr>\n<td><br />  <br />merchant_bears_cost  <br />  <br /></td>\n<td><br />  <br />Boolean  <br />  <br /></td>\n<td><br />  <br />False  <br />  <br /></td>\n<td><br />  <br />This sets who bears the fees of the transaction. If it is set to <code>true</code>, the merchant will bear the fee. If it is set to <code>false</code>, the customer will bear the fee. By default, it is set to <code>false</code>.  <br />  <br /></td>\n</tr>\n<tr>\n<td><br />  <br />narration  <br />  <br /></td>\n<td><br />  <br />String  <br />  <br /></td>\n<td><br />  <br />False  <br />  <br /></td>\n<td><br />  <br />Information/narration about the transaction.  <br />  <br /></td>\n</tr>\n<tr>\n<td><br />  <br />notification_url  <br />  <br /></td>\n<td><br />  <br />String  <br />  <br /></td>\n<td><br />  <br />False  <br />  <br /></td>\n<td><br />  <br />The webhook URL to be called when the transaction is complete.  <br />  <br /></td>\n</tr>\n<tr>\n<td><br />  <br />metadata  <br />  <br /></td>\n<td><br />  <br />Object  <br />  <br /></td>\n<td><br />  <br />False  <br />  <br /></td>\n<td><br />  <br />It takes a JSON object with a maximum of 5 fields/keys. Empty JSON objects are not allowed. Each field name has a maximum length of 20 characters. Allowed characters: <code>A-Z</code>, <code>a-z</code>, <code>0-9</code>, and <code>-</code>.  <br />  <br /></td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"successful-response-body\">Successful Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>Request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>Request status message</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>The object containing charge details</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>string</td>\n<td>The currency for the charge</td>\n</tr>\n<tr>\n<td>amount</td>\n<td>number</td>\n<td>Amount to charge</td>\n</tr>\n<tr>\n<td>fee</td>\n<td>number</td>\n<td>The fee charged for this transaction</td>\n</tr>\n<tr>\n<td>vat</td>\n<td>number</td>\n<td>The value added tax for this transaction</td>\n</tr>\n<tr>\n<td>transaction_reference</td>\n<td>string</td>\n<td>The reference for each attempted transaction</td>\n</tr>\n<tr>\n<td>payment_reference</td>\n<td>string</td>\n<td>The reference for this payment</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>The status of the transaction e.g <code>success</code>, <code>processing</code>, <code>failed</code></td>\n</tr>\n<tr>\n<td>merchant_bears_cost</td>\n<td>boolean</td>\n<td>This sets who bears the fees of the transaction. If it is set to true, the merchant will bear the fee. If it is set to false, the customer will bear the fee. By default, it is set to false.</td>\n</tr>\n<tr>\n<td>customer</td>\n<td>object</td>\n<td>Object containing the customer details</td>\n</tr>\n<tr>\n<td>customer.name</td>\n<td>string</td>\n<td>The name of the customer</td>\n</tr>\n<tr>\n<td>customer.email</td>\n<td>string</td>\n<td>The email of the customer</td>\n</tr>\n<tr>\n<td>narration</td>\n<td>string</td>\n<td>Information/narration about the transaction</td>\n</tr>\n<tr>\n<td>authorization</td>\n<td>object</td>\n<td>Object containing authorization information</td>\n</tr>\n<tr>\n<td>authorization.redirect_url</td>\n<td>string</td>\n<td>The redirect url to proceed with payment</td>\n</tr>\n<tr>\n<td>bank_account</td>\n<td>object</td>\n<td>Object containing the bank details</td>\n</tr>\n<tr>\n<td>bank_name</td>\n<td>string</td>\n<td>The bank name for the transaction</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"failed-response-body\">Failed Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>Request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>Request status message</td>\n</tr>\n<tr>\n<td>code</td>\n<td>string</td>\n<td>Request code</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>object containing extra information about the error</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","charge","pay-with-bank"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"0a1fc9ce-dddb-4ff1-b8d0-4f408ba3d5ab","name":"Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"bank_code\": \"0001\",\n    \"amount\": 600,\n    \"currency\": \"ZAR\",\n    \"reference\": \"CPY-DF-hdjkdhjjd2ss124\",\n    \"customer\": {\n        \"name\": \"John Doe\",\n        \"email\": \"john@email.com\"\n    },\n    \"merchant_bears_cost\": false\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charge/pay-with-bank"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"489"},{"key":"ETag","value":"W/\"1e9-kkaVul8HE49SUzE4giaLoLh6ozM\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Date","value":"Wed, 15 May 2024 12:17:38 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Pay With Bank initiated successfully\",\n    \"data\": {\n        \"currency\": \"ZAR\",\n        \"amount\": 600,\n        \"amount_expected\": 600,\n        \"fee\": 0,\n        \"vat\": 0,\n        \"transaction_reference\": \"KPY-CA-yzeIw00fYNVhJxY\",\n        \"payment_reference\": \"CPY-DF-hdjkdhjjd245ss124\",\n        \"status\": \"processing\",\n        \"narration\": \"Payment on Microsoft Inc\",\n        \"merchant_bears_cost\": false,\n        \"authorization\": {\n            \"redirect_url\": \"http://localhost:7500/KPY-CA-yzeIw00fYNVhJxY\"\n        },\n        \"bank_account\": {\n            \"bank_name\": \"ABSA\"\n        },\n        \"customer\": {\n            \"name\": \"John Doe\",\n            \"email\": \"johndoe@example.com\"\n        }\n    }\n}"},{"id":"be7c9c6d-a4ae-4f13-b323-909f93d8d319","name":"Duplicate Reference Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"bank_code\": \"0001\",\n    \"amount\": 600,\n    \"currency\": \"ZAR\",\n    \"reference\": \"CPY-DF-hdjkdhjjd2ss124\",\n     \"customer\": {\n        \"name\": \"John Doe\",\n        \"email\": \"john@email.com\"\n    },\n    \"merchant_bears_cost\": false\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charge/pay-with-bank"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 05 Jun 2023 19:27:30 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"83"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"53-Jw763a/WHHXKpJC1At63iv/g3n0\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7d2ad0365b1a71e1-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"code\": \"AA021\",\n    \"message\": \"duplicate payment reference\",\n    \"data\": null\n}"},{"id":"1d2adda5-07f0-477d-86bc-09d28d7ba5cb","name":"Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"bank_code\": \"0001\",\n    \"currency\": \"ZAR\",\n    \"reference\": \"CPY-DF-hdjkdhjjd2ss124\",\n    \"customer\": {\n        \"name\": \"John Doe\",\n        \"email\": \"john@email.com\"\n    },\n    \"merchant_bears_cost\": false\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charge/pay-with-bank"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 05 Jun 2023 19:26:32 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"164"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"a4-S+cukwMiB4IqcKBSxZNq9H+OCcA\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Set-Cookie","value":"__cf_bm=aRyuyD8tJqtyI0GviMNYykSiVQPuItmb8ueRFDFPdiA-1685993192-0-AaK5Tp0xdya5qKV0kHrGsSMVMjRe4R1XB35oCp7bwGt43sIEWRXoH7O8Hu4paavKy/bq2qqcRi/felwCzBc1dBA=; path=/; expires=Mon, 05-Jun-23 19:56:32 GMT; domain=.korapay.com; HttpOnly; Secure; SameSite=None"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7d2acecb499271e1-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"bad_request\",\n    \"message\": \"invalid request data\",\n    \"data\": {\n        \"amount\": {\n            \"message\": \"amount is required\",\n            \"customErrorMessage\": \"amount is required\"\n        }\n    }\n}"}],"_postman_id":"3fa7041a-b825-49da-b2b8-7904ec27644b"},{"name":"Get Banks","id":"4602ebd1-4d3d-4cec-90f1-e161901139cc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.korapay.com/merchant/api/v1/charge/pay-with-bank/banks?currency=ZAR","urlObject":{"path":["merchant","api","v1","charge","pay-with-bank","banks"],"host":["https://api.korapay.com"],"query":[{"key":"currency","value":"ZAR"}],"variable":[]}},"response":[{"id":"36b2f343-0d18-4506-939f-2449b055fed4","name":"Get Banks","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/api/v1/charge/pay-with-bank/banks?currency=ZAR","host":["https://api.korapay.com"],"path":["api","v1","charge","pay-with-bank","banks"],"query":[{"key":"currency","value":"ZAR"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 06 May 2025 10:35:37 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"www-environment","value":"live"},{"key":"etag","value":"W/\"1ff-p1rA3rZw//fY0UYd3e+Xu8zdukk\""},{"key":"vary","value":"Accept-Encoding"},{"key":"X-Robots-Tag","value":"noindex"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"93b7d4f16ced8286-IAD"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Pay with Bank supported banks retrieved successfully\",\n    \"data\": [\n        {\n            \"code\": \"632005\",\n            \"name\": \"ABSA\",\n            \"slug\": \"absa-za\",\n            \"country\": \"ZA\"\n        },\n        {\n            \"code\": \"430000\",\n            \"name\": \"African Bank\",\n            \"slug\": \"african-bank-za\",\n            \"country\": \"ZA\"\n        },\n        {\n            \"code\": \"462005\",\n            \"name\": \"Bidvest Bank Gro\",\n            \"slug\": \"bidvest-bank-za\",\n            \"country\": \"ZA\"\n        },\n        {\n            \"code\": \"250655\",\n            \"name\": \"FNB\",\n            \"slug\": \"fnb-za\",\n            \"country\": \"ZA\"\n        },\n        {\n            \"code\": \"580105\",\n            \"name\": \"Investec\",\n            \"slug\": \"investec-za\",\n            \"country\": \"ZA\"\n        },\n        {\n            \"code\": \"198765\",\n            \"name\": \"Nedbank\",\n            \"slug\": \"nedbank-za\",\n            \"country\": \"ZA\"\n        },\n        {\n            \"code\": \"051001\",\n            \"name\": \"Standard Bank\",\n            \"slug\": \"standard-bank-za\",\n            \"country\": \"ZA\"\n        },\n        {\n            \"code\": \"678910\",\n            \"name\": \"Tymebank\",\n            \"slug\": \"tymebank-za\",\n            \"country\": \"ZA\"\n        }\n    ]\n}"}],"_postman_id":"4602ebd1-4d3d-4cec-90f1-e161901139cc"}],"id":"33f27430-c33d-4bc9-a4a4-ca3bbb020f96","_postman_id":"33f27430-c33d-4bc9-a4a4-ca3bbb020f96","description":"","auth":{"type":"noauth","isInherited":true,"source":{"_postman_id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","name":"Pay-ins","type":"folder"}}},{"name":"Pool Account","item":[{"name":"Create Pool Account Reference","id":"b23ded43-1742-4b10-856e-cc90f0984cb8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"customer_name\": \"Don Alpha\",\n    \"customer_email\": \"donalpha@gmail.com\",\n    \"currency\": \"KES\",\n    \"account_type\": \"bank_account\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/pool-accounts","description":"<h2 id=\"endpoint-description\">Endpoint Description</h2>\n<p>This API endpoint allows the creation of a new pool account for a customer. It requires specific customer information and currency details to successfully create the account.</p>\n<h2 id=\"request-body\">Request Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Required?</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>customer_name</td>\n<td>String</td>\n<td>True</td>\n<td>The name of your customer.</td>\n</tr>\n<tr>\n<td>customer_email</td>\n<td>String</td>\n<td>True</td>\n<td>The email of your customer.</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>String</td>\n<td>True</td>\n<td>Currency Code of desired currency</td>\n</tr>\n<tr>\n<td>account_type</td>\n<td>string</td>\n<td>false</td>\n<td>Type of Account for Pool Account(mobile_money or bank_account)</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"successful-response-body\">Successful Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n<th><strong>Required</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>Request status.</td>\n<td>True</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>Request status message.</td>\n<td>True</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>The object containing pool account reference details.</td>\n<td>True</td>\n</tr>\n<tr>\n<td>data.currency</td>\n<td>string</td>\n<td>The currency code of the reference generated.</td>\n<td>True</td>\n</tr>\n<tr>\n<td>data.reference</td>\n<td>string</td>\n<td>Generated pool account reference to be shared with your customer. The Reference will follow the format:  <br /><strong>{MerchantPrefix} + KP + {RandomAlphaNumeric} + {Currency}.</strong></td>\n<td>True</td>\n</tr>\n<tr>\n<td>data.customer_name</td>\n<td>string</td>\n<td>The name of your customer.</td>\n<td>True</td>\n</tr>\n<tr>\n<td>data.customer_email</td>\n<td>string</td>\n<td>The email address of your customer.</td>\n<td>True</td>\n</tr>\n<tr>\n<td>data.date_created</td>\n<td>string</td>\n<td>The date reference was created.</td>\n<td>True</td>\n</tr>\n<tr>\n<td>data.account_details</td>\n<td>object</td>\n<td>Object containing account details where payment should be made.</td>\n<td>True</td>\n</tr>\n<tr>\n<td>data.account_details.bank_code</td>\n<td>string</td>\n<td>Bank code of the account for payment.</td>\n<td>false</td>\n</tr>\n<tr>\n<td>data.account_details.bank_name</td>\n<td>string</td>\n<td>Bank name of the account for payment.</td>\n<td>True</td>\n</tr>\n<tr>\n<td>data.account_details.account_name</td>\n<td>object</td>\n<td>Name of the account holder for payment.</td>\n<td>True</td>\n</tr>\n<tr>\n<td>data.account_details.account_number</td>\n<td>string</td>\n<td>Account number of the account for payment.</td>\n<td>True</td>\n</tr>\n<tr>\n<td>data.account_details.swift_code</td>\n<td>string</td>\n<td>SWIFT code of the bank</td>\n<td>false</td>\n</tr>\n<tr>\n<td>data.account_details.bank_address</td>\n<td>string</td>\n<td>Address of the bank or branch associated with the account.</td>\n<td>false</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"failed-response-body\">Failed Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>Request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>Request status message</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>object containing extra information.</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","pool-accounts"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"a5bad4de-ad0a-47a8-9d99-86d60917f462","name":"Success Bank Account","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"customer_name\": \"Don Alpha\",\n    \"customer_email\": \"donalpha@gmail.com\",\n    \"currency\": \"KES\",\n    \"account_type\": \"bank_account\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/api/v1/pool-accounts"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Content-Length","value":"437"},{"key":"ETag","value":"W/\"1b5-u5Edebn7dyWlUqLbo5YhAXlW07E\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Date","value":"Mon, 18 Aug 2025 11:24:55 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Pool account reference has been created successfully\",\n    \"data\": {\n        \"reference\": \"MIKP1E7WNNLJKES\",\n        \"customer_name\": \"Don Alpha\",\n        \"customer_email\": \"donalpha@gmail.com\",\n        \"currency\": \"KES\",\n        \"date_created\": \"2025-08-18T11:24:55.172Z\",\n        \"account_details\": {\n            \"currency\": \"KES\",\n            \"bank_code\": \"123456\",\n            \"bank_name\": \"Kora KES Bank\",\n            \"swift_code\": \"KORABANK123\",\n            \"account_number\": \"1234567890\",\n            \"account_name\": \"Kora Technologies Ltd\",\n            \"bank_address\": \"123 Kora Street, City, Country\"\n        }\n    }\n}"},{"id":"fb7d95a4-255f-4295-bf75-81ad6e2cb48c","name":"Success Mobile Money","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"customer_name\": \"Don Alpha\",\n    \"customer_email\": \"donalpha2@gmail.com\",\n    \"currency\": \"GHS\",\n    \"account_type\": \"mobile_money\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/pool-accounts"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 24 Sep 2025 09:35:45 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"},{"key":"access-control-allow-origin","value":"*"},{"key":"www-environment","value":"live"},{"key":"etag","value":"W/\"153-kieixFg+dkI5VzGCTnnOu9CieT4\""},{"key":"vary","value":"Accept-Encoding"},{"key":"X-Robots-Tag","value":"noindex"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"98414b25cf05ef4d-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Pool account reference has been created successfully\",\n    \"data\": {\n        \"reference\": \"PRKPMODPQL8PGHS\",\n        \"customer_name\": \"Don Alpha\",\n        \"customer_email\": \"donalpha2@gmail.com\",\n        \"currency\": \"GHS\",\n        \"date_created\": \"2025-09-24T09:35:45.736Z\",\n        \"account_details\": {\n            \"currency\": \"GHS\",\n            \"account_name\": \"Kora 2342\",\n            \"mobile_number\": \"233812343\"\n        }\n    }\n}"},{"id":"7aadf65a-3917-4937-b324-a04c64d43cf1","name":"Existing Reference Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"customer_name\": \"Don Alpha\",\n    \"customer_email\": \"donalpha@gmail.com\",\n    \"currency\": \"KES\",\n    \"account_type\": \"bank_account\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/api/v1/pool-accounts"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Content-Length","value":"430"},{"key":"ETag","value":"W/\"1ae-CRJJtpVi5D2+RAqVWEgCJnZaj4E\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Date","value":"Tue, 19 Aug 2025 21:17:23 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"A reference already exists for this customer\",\n    \"data\": {\n        \"reference\": \"MIKP1E7WNNLJKES\",\n        \"customer_name\": \"Don Alpha\",\n        \"customer_email\": \"donalpha@gmail.com\",\n        \"currency\": \"KES\",\n        \"date_created\": \"2025-08-18T11:24:55.000Z\",\n        \"account_details\": {\n            \"currency\": \"KES\",\n            \"bank_code\": \"123456\",\n            \"bank_name\": \"Kora KES Bank\",\n            \"swift_code\": \"KORABANK123\",\n            \"account_number\": \"1234567890\",\n            \"account_name\": \"Kora Technologies Ltd\",\n            \"bank_address\": \"123 Kora Street, City, Country\"\n        }\n    }\n}"},{"id":"5b12ed7b-8550-4bf2-96e2-ce0ea0df0fa8","name":"Not Authorized","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"customer_name\": \"Don Alpha\",\n    \"customer_email\": \"donalpha@gmail.com\",\n    \"currency\": \"KES\",\n    \"account_type\": \"bank_account\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/api/v1/pool-accounts"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Content-Length","value":"83"},{"key":"ETag","value":"W/\"53-ofkHxrxmhFlU1V+hZWnaXuJhiaQ\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Date","value":"Tue, 19 Aug 2025 21:22:06 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"You are not authorized to use this service\",\n    \"data\": null\n}"}],"_postman_id":"b23ded43-1742-4b10-856e-cc90f0984cb8"},{"name":"Credit Sandbox Pool Account","id":"96a8640f-a01a-43aa-9ad7-2ebc0986babf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"DEKP3NPGBXJWXAF\",\n    \"amount\": 10,\n    \"currency\": \"XAF\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/pool-accounts/sandbox/credit","description":"<h2 id=\"endpoint-description\">Endpoint Description</h2>\n<p>This API endpoint allows credit your pool account with certain amount. This API is only available on the sandbox environment</p>\n<h2 id=\"request-body\">Request Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Required?</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>reference</td>\n<td>String</td>\n<td>True</td>\n<td>Pool account reference</td>\n</tr>\n<tr>\n<td>amount</td>\n<td>Number</td>\n<td>True</td>\n<td>The amount to credit the pool account</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>String</td>\n<td>True</td>\n<td>Currency code of the pool accont</td>\n</tr>\n<tr>\n<td></td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n</tbody>\n</table>\n</div><div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n<th><strong>Required</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>Request status.</td>\n<td>True</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>Request status message.</td>\n<td>True</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>The object containing pool account reference details.</td>\n<td>True</td>\n</tr>\n<tr>\n<td>data.currency</td>\n<td>string</td>\n<td>The currency code of amount credited</td>\n<td>True</td>\n</tr>\n<tr>\n<td>data.amount_paid</td>\n<td>string</td>\n<td>The amount credited into the pool account</td>\n<td>True</td>\n</tr>\n<tr>\n<td>data.transaction_reference</td>\n<td>string</td>\n<td>A reference that can be used to query the transaction</td>\n<td>True</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["merchant","api","v1","pool-accounts","sandbox","credit"],"host":["api","korapay","com"],"query":[],"variable":[]}},"response":[{"id":"c6cb1ad4-01de-496b-b0cf-a6c37f5a8aac","name":"Credit Pool Account (Sandbox Only) - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"DEKP3NPGBXJWXAF\",\n    \"amount\": 10,\n    \"currency\": \"XAF\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/pool-accounts/sandbox/credit"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 18 Oct 2025 13:20:28 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"d1-lN+gURsy+YvX7UcQixaPjVoTtfA\""},{"key":"vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"content-security-policy","value":"frame-ancestors 'none'"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"990855513c28f653-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Pool account has been credited successfully\",\n    \"data\": {\n        \"currency\": \"XAF\",\n        \"amount_paid\": 10,\n        \"transaction_reference\": \"KPY-PA-7aChjefcCp9PWeQ\",\n        \"transaction_date\": \"2025-10-18T13:20:28.426Z\"\n    }\n}"}],"_postman_id":"96a8640f-a01a-43aa-9ad7-2ebc0986babf"},{"name":"Get Pool Account Reference Details","id":"34c42114-21b0-4042-9e08-eb2def8a9665","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.korapay.com/api/v1/pool-accounts/:reference","urlObject":{"path":["api","v1","pool-accounts",":reference"],"host":["https://api.korapay.com"],"query":[{"disabled":true,"key":"","value":""}],"variable":[{"type":"any","value":"MIKPUUFHMY4DKES","key":"reference"}]}},"response":[{"id":"adfe6dd7-a2ec-4c4a-8acc-5d25c8c2f652","name":"Success Response","originalRequest":{"method":"GET","header":[],"url":"https://api.korapay.com/merchant/api/v1/pool-accounts/MIKPUUFHMY4CKES"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"kora-request-id","value":"REQ-ID-uQBBaiY921sOyeB"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"412"},{"key":"ETag","value":"W/\"19c-4KtepB1B2tEFLhvHpFtbL38mtcg\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Date","value":"Fri, 29 May 2026 15:40:43 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Pool account retrieved successfully\",\n    \"data\": {\n        \"reference\": \"MIKPUUFHMY4CKES\",\n        \"customer_name\": \"test1\",\n        \"customer_email\": \"test33@gmail.com\",\n        \"currency\": \"KES\",\n        \"account_details\": {\n            \"currency\": \"KES\",\n            \"bank_code\": \"123456\",\n            \"bank_name\": \"Kora KES Bank\",\n            \"swift_code\": \"KORABANK123\",\n            \"account_number\": \"1234567890\",\n            \"branch_address\": \"123 Kora Street, City, Country\"\n        },\n        \"created_at\": \"2026-05-27T21:56:04.000Z\"\n    }\n}"},{"id":"c2444531-f876-4a10-836e-723529ab1725","name":"Not Found","originalRequest":{"method":"GET","header":[],"url":"https://api.korapay.com/merchant/api/v1/pool-accounts/MIKPUUFHMY4DKES"},"status":"Not Found","code":404,"_postman_previewlanguage":null,"header":[{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"kora-request-id","value":"REQ-ID-CgXLgADcOmuKd0w"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"63"},{"key":"ETag","value":"W/\"3f-PoBIvLU51LnMqB33AovzR6QTERc\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Date","value":"Fri, 29 May 2026 15:45:21 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Pool account not found\",\n    \"data\": null\n}"}],"_postman_id":"34c42114-21b0-4042-9e08-eb2def8a9665"}],"id":"ba76b415-5fa6-4fa1-896f-6dcc2797b3b3","_postman_id":"ba76b415-5fa6-4fa1-896f-6dcc2797b3b3","description":"","auth":{"type":"noauth","isInherited":true,"source":{"_postman_id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","name":"Pay-ins","type":"folder"}}},{"name":"Voucher","item":[{"name":"Charge","id":"ff323986-4375-476f-bb8f-f06f54947186","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 100,\n    \"currency\": \"ZAR\",\n    \"merchant_bears_cost\": true,\n    \"notification_url\": \"https://secure.example.com/api/v1/callback/deposit\",\n    \"description\": \"This is a voucher payment\",\n    \"reference\": \"example-unique-reference\",\n    \"voucher\": {\n        \"pin\": \"1168648096792943\",\n        \"phone_number\": \"+270576847568\",\n        \"provider_code\": \"0001\"\n    },\n    \"customer\": {\n        \"email\": \"johndoe@example.com\",\n        \"name\": \"John Doe\"\n    },\n    \"metadata\": {\n        \"key\": \"Value 1\"\n    }\n}\n\n","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/charge/voucher","urlObject":{"path":["merchant","api","v1","charge","voucher"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"ee646967-f995-475e-a5c7-c8fb2415369c","name":"Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 100,\n    \"currency\": \"ZAR\",\n    \"merchant_bears_cost\": true,\n    \"notification_url\": \"https://secure.example.com/api/v1/callback/deposit\",\n    \"description\": \"This is a voucher payment\",\n    \"reference\": \"example-unique-reference\",\n    \"voucher\": {\n        \"pin\": \"1168648096792943\",\n        \"phone_number\": \"+270576847568\",\n        \"provider_code\": \"0001\"\n    },\n    \"customer\": {\n        \"email\": \"johndoe@example.com\",\n        \"name\": \"John Doe\"\n    },\n    \"metadata\": {\n        \"key\": \"Value 1\"\n    }\n}\n\n","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.comapi/v1/charge/voucher"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Charge Successful\",\n    \"data\": {\n        \"currency\": \"ZAR\",\n        \"amount\": 10,\n        \"fee\": 0,\n        \"vat\": 0,\n        \"transaction_reference\": \"KPY-CA-qFNr4bXheKr6\",\n        \"payment_reference\": \"CR-FAGSHHH23737b\",\n        \"status\": \"success\",\n        \"voucher\": {\n            \"serial_number\": \"20251024103152983020\",\n            \"balance\": 10,\n            \"pin\": \"1168648096792943\",\n            \"expiry_date\": \"2026-10-24 10:31:26\"\n        },\n        \"customer\": {\n            \"name\": \"John Doe\",\n            \"email\": \"johndoe@example.com\"\n        }\n    }\n}"},{"id":"90939909-3ad2-4bbd-b0a8-fc39b451edf8","name":"Voucher already used error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 100,\n    \"currency\": \"ZAR\",\n    \"merchant_bears_cost\": true,\n    \"notification_url\": \"https://secure.example.com/api/v1/callback/deposit\",\n    \"description\": \"This is a voucher payment\",\n    \"reference\": \"example-unique-reference\",\n    \"voucher\": {\n        \"pin\": \"1168648096792943\",\n        \"phone_number\": \"+270576847568\",\n        \"provider_code\": \"0001\"\n    },\n    \"customer\": {\n        \"email\": \"johndoe@example.com\",\n        \"name\": \"John Doe\"\n    },\n    \"metadata\": {\n        \"key\": \"Value 1\"\n    }\n}\n\n","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.comapi/v1/charge/voucher"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"The voucher has already been used\",\n    \"data\": null\n}"},{"id":"02acc10a-1af8-4a73-98a4-4a3d8aee8521","name":"Amount exceeded error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 100,\n    \"currency\": \"ZAR\",\n    \"merchant_bears_cost\": true,\n    \"notification_url\": \"https://secure.example.com/api/v1/callback/deposit\",\n    \"description\": \"This is a voucher payment\",\n    \"reference\": \"example-unique-reference\",\n    \"voucher\": {\n        \"pin\": \"1168648096792943\",\n        \"phone_number\": \"+270576847568\",\n        \"provider_code\": \"0001\"\n    },\n    \"customer\": {\n        \"email\": \"johndoe@example.com\",\n        \"name\": \"John Doe\"\n    },\n    \"metadata\": {\n        \"key\": \"Value 1\"\n    }\n}\n\n","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.comapi/v1/charge/voucher"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"The amount provided exceeds the required amount\",\n    \"data\": null\n}"},{"id":"d3b61ebe-852b-4f24-bedb-dc4ebbaac7e5","name":"Duplicate payment reference error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 100,\n    \"currency\": \"ZAR\",\n    \"merchant_bears_cost\": true,\n    \"notification_url\": \"https://secure.example.com/api/v1/callback/deposit\",\n    \"description\": \"This is a voucher payment\",\n    \"reference\": \"example-unique-reference\",\n    \"voucher\": {\n        \"pin\": \"1168648096792943\",\n        \"phone_number\": \"+270576847568\",\n        \"provider_code\": \"0001\"\n    },\n    \"customer\": {\n        \"email\": \"johndoe@example.com\",\n        \"name\": \"John Doe\"\n    },\n    \"metadata\": {\n        \"key\": \"Value 1\"\n    }\n}\n\n","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.comapi/v1/charge/voucher"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Duplicate payment reference\",\n    \"data\": null\n}"},{"id":"3affcdfa-a6d4-400d-80b0-7519c95efcf9","name":"Provider not supported error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 100,\n    \"currency\": \"ZAR\",\n    \"merchant_bears_cost\": true,\n    \"notification_url\": \"https://secure.example.com/api/v1/callback/deposit\",\n    \"description\": \"This is a voucher payment\",\n    \"reference\": \"example-unique-reference\",\n    \"voucher\": {\n        \"pin\": \"1168648096792943\",\n        \"phone_number\": \"+270576847568\",\n        \"provider_code\": \"0001\"\n    },\n    \"customer\": {\n        \"email\": \"johndoe@example.com\",\n        \"name\": \"John Doe\"\n    },\n    \"metadata\": {\n        \"key\": \"Value 1\"\n    }\n}\n\n","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.comapi/v1/charge/voucher"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"The selected provider is not supported\",\n    \"data\": null\n}"},{"id":"6d37b01d-e541-47b3-97a7-ff6372ca6dca","name":"Invalid voucher PIN error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 100,\n    \"currency\": \"ZAR\",\n    \"merchant_bears_cost\": true,\n    \"notification_url\": \"https://secure.example.com/api/v1/callback/deposit\",\n    \"description\": \"This is a voucher payment\",\n    \"reference\": \"example-unique-reference\",\n    \"voucher\": {\n        \"pin\": \"1168648096792943\",\n        \"phone_number\": \"+270576847568\",\n        \"provider_code\": \"0001\"\n    },\n    \"customer\": {\n        \"email\": \"johndoe@example.com\",\n        \"name\": \"John Doe\"\n    },\n    \"metadata\": {\n        \"key\": \"Value 1\"\n    }\n}\n\n","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.comapi/v1/charge/voucher"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"The voucher pin you have entered is invalid\",\n    \"data\": null\n}"}],"_postman_id":"ff323986-4375-476f-bb8f-f06f54947186"}],"id":"80224829-91f1-45b6-8016-e82569bb6577","description":"<p>Kora’s Voucher Payments allow merchants to accept payments from customers using prepaid voucher codes or PINs. This solution is specifically designed to reach unbanked and underbanked customers in markets with low card penetration, enabling them to purchase vouchers through offline or alternative digital channels.</p>\n","_postman_id":"80224829-91f1-45b6-8016-e82569bb6577","auth":{"type":"noauth","isInherited":true,"source":{"_postman_id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","name":"Pay-ins","type":"folder"}}},{"name":"Direct Debit","item":[{"name":"Initialize Direct Debit Authorization","id":"a9338871-d77c-4db1-85b0-2e2675cd7015","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 100,\n    \"currency\": \"NGN\",\n    \"debit_type\": \"fixed\",\n    \"description\": \"Monthly subscription for premium plan\",\n    \"start_date\": \"2026-04-19\",\n    \"end_date\": \"2026-05-19\",\n    \"customer\": {\n        \"name\": \"Jane Doe\",\n        \"email\": \"janedoe@gmail.com\",\n        \"account_number\": \"0112345678\",\n        \"bank_code\": \"058\",\n        \"billing_address\": \"123 Victoria Island, Lagos\",\n        \"phone_number\": \"08012345678\"\n    },\n    //   for fixed\n      \"retrial_frequency\": 2,\n      \"frequency\": \"days\",\n      \"initial_debit_date\": \"2026-04-19\",\n      \"interval\": 1\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/direct-debit/initiate","description":"<h2 id=\"initialize-direct-debit-authorization\">Initialize Direct Debit Authorization</h2>\n<p>Sets up a direct debit mandate on a customer's bank account, allowing the merchant to debit the account automatically on a defined schedule.</p>\n<hr />\n<h3 id=\"endpoint\">Endpoint</h3>\n<p><code>POST https://api.korapay.com/merchant/api/v1/direct-debit/initiate</code></p>\n<hr />\n<h3 id=\"authentication\">Authentication</h3>\n<p>Bearer token — pass your secret key as a Bearer token in the <code>Authorization</code> header.</p>\n<hr />\n<h3 id=\"request-body\">Request Body</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Type</th>\n<th>Required</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>amount</code></td>\n<td>number</td>\n<td>Yes</td>\n<td>Amount to be debited.</td>\n</tr>\n<tr>\n<td><code>currency</code></td>\n<td>string</td>\n<td>Yes</td>\n<td>Currency code. Currently supported: <code>NGN</code>.</td>\n</tr>\n<tr>\n<td><code>debit_type</code></td>\n<td>string</td>\n<td>Yes</td>\n<td>Type of debit mandate. Accepted values: <code>fixed</code>, <code>variable</code>.</td>\n</tr>\n<tr>\n<td><code>description</code></td>\n<td>string</td>\n<td>Yes</td>\n<td>A human-readable description of the debit mandate (e.g. \"Monthly subscription for premium plan\").</td>\n</tr>\n<tr>\n<td><code>start_date</code></td>\n<td>string</td>\n<td>Yes</td>\n<td>The date the mandate becomes active. Format: <code>YYYY-MM-DD</code>.</td>\n</tr>\n<tr>\n<td><code>end_date</code></td>\n<td>string</td>\n<td>Yes</td>\n<td>The date the mandate expires. Format: <code>YYYY-MM-DD</code>.</td>\n</tr>\n<tr>\n<td><code>customer</code></td>\n<td>object</td>\n<td>Yes</td>\n<td>Customer details. See <a href=\"#customer-object\">Customer Object</a> below.</td>\n</tr>\n<tr>\n<td><code>initial_debit_date</code></td>\n<td>string</td>\n<td>No (required for <code>fixed</code>)</td>\n<td>The date of the first debit. Format: <code>YYYY-MM-DD</code>.</td>\n</tr>\n<tr>\n<td><code>frequency</code></td>\n<td>string</td>\n<td>No (required for <code>fixed</code>)</td>\n<td>Frequency unit for recurring debits. Accepted values: <code>days</code>, <code>weeks</code>, <code>months</code>.</td>\n</tr>\n<tr>\n<td><code>interval</code></td>\n<td>number</td>\n<td>No (required for <code>fixed</code>)</td>\n<td>Interval between debits, relative to <code>frequency</code> (e.g. <code>1</code> with <code>days</code> = daily).</td>\n</tr>\n<tr>\n<td><code>retrial_frequency</code></td>\n<td>number</td>\n<td>No (required for <code>fixed</code>)</td>\n<td>Number of retry attempts if a debit fails.</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"customer-object\">Customer Object</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Type</th>\n<th>Required</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>name</code></td>\n<td>string</td>\n<td>Yes</td>\n<td>Full name of the customer.</td>\n</tr>\n<tr>\n<td><code>email</code></td>\n<td>string</td>\n<td>Yes</td>\n<td>Customer's email address.</td>\n</tr>\n<tr>\n<td><code>account_number</code></td>\n<td>string</td>\n<td>Yes</td>\n<td>Customer's bank account number.</td>\n</tr>\n<tr>\n<td><code>bank_code</code></td>\n<td>string</td>\n<td>Yes</td>\n<td>CBN bank code for the customer's bank (e.g. <code>033</code> for UBA, <code>058</code> for GTBank).</td>\n</tr>\n<tr>\n<td><code>billing_address</code></td>\n<td>string</td>\n<td>No</td>\n<td>Customer's billing address.</td>\n</tr>\n<tr>\n<td><code>phone_number</code></td>\n<td>string</td>\n<td>No</td>\n<td>Customer's phone number.</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"debit-types\">Debit Types</h3>\n<p><strong><code>fixed</code></strong> — Debits a fixed amount on a recurring schedule defined by <code>frequency</code>, <code>interval</code>, and <code>initial_debit_date</code>. The <code>retrial_frequency</code> field controls how many times a failed debit is retried.</p>\n<p><strong><code>variable</code></strong> — Debits a variable amount. The schedule fields (<code>frequency</code>, <code>interval</code>, <code>initial_debit_date</code>, <code>retrial_frequency</code>) are not required.</p>\n<hr />\n<h3 id=\"example-request-body-fixed\">Example Request Body (Fixed)</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"amount\": 300,\n  \"currency\": \"NGN\",\n  \"debit_type\": \"fixed\",\n  \"description\": \"Monthly subscription for premium plan\",\n  \"start_date\": \"2026-02-26\",\n  \"end_date\": \"2026-02-28\",\n  \"retrial_frequency\": 2,\n  \"frequency\": \"days\",\n  \"initial_debit_date\": \"2026-02-26\",\n  \"interval\": 1,\n  \"customer\": {\n    \"name\": \"Jane Doe\",\n    \"email\": \"janedoe@gmail.com\",\n    \"account_number\": \"0123456789\",\n    \"bank_code\": \"033\",\n    \"billing_address\": \"123 Victoria Island, Lagos\",\n    \"phone_number\": \"08012345678\"\n  }\n}\n\n</code></pre>\n<h3 id=\"example-request-body-variable\">Example Request Body (Variable)</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"amount\": 100,\n  \"currency\": \"NGN\",\n  \"debit_type\": \"variable\",\n  \"description\": \"Monthly subscription for premium plan\",\n  \"start_date\": \"2026-04-19\",\n  \"end_date\": \"2026-05-19\",\n  \"customer\": {\n    \"name\": \"Jane Doe\",\n    \"email\": \"janedoe@gmail.com\",\n    \"account_number\": \"0112345678\",\n    \"bank_code\": \"058\",\n    \"billing_address\": \"123 Victoria Island, Lagos\",\n    \"phone_number\": \"08012345678\"\n  }\n}\n\n</code></pre>\n<hr />\n<h3 id=\"response-body\">Response Body</h3>\n<p>A successful request returns HTTP <code>200</code> with the following structure:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>status</code></td>\n<td>boolean</td>\n<td><code>true</code> if the request was successful.</td>\n</tr>\n<tr>\n<td><code>message</code></td>\n<td>string</td>\n<td>Human-readable status message.</td>\n</tr>\n<tr>\n<td><code>data</code></td>\n<td>object</td>\n<td>The authorization details. See <a href=\"#data-object\">Data Object</a> below.</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"data-object\">Data Object</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>status</code></td>\n<td>string</td>\n<td>Current status of the authorization. Initial value is <code>pending</code>.</td>\n</tr>\n<tr>\n<td><code>reference</code></td>\n<td>string</td>\n<td>Unique reference for the direct debit authorization (e.g. <code>KPY-DD-AUTH-xxxxxxxx</code>).</td>\n</tr>\n<tr>\n<td><code>authorization_code</code></td>\n<td>string</td>\n<td>Unique authorization code for the mandate (e.g. <code>KPY-AUTH-xxxxxxxxxxxxxxx</code>). use to debit in Variable ,amdate</td>\n</tr>\n<tr>\n<td><code>amount</code></td>\n<td>number</td>\n<td>Amount to be debited.</td>\n</tr>\n<tr>\n<td><code>currency</code></td>\n<td>string</td>\n<td>Currency code (e.g. <code>NGN</code>).</td>\n</tr>\n<tr>\n<td><code>debit_type</code></td>\n<td>string</td>\n<td>Type of debit mandate: <code>fixed</code> or <code>variable</code>.</td>\n</tr>\n<tr>\n<td><code>description</code></td>\n<td>string</td>\n<td>Description of the mandate, including e-mandate activation instructions and token payment account details provided by NIBSS.</td>\n</tr>\n<tr>\n<td><code>customer_account_number</code></td>\n<td>string</td>\n<td>Customer's bank account number.</td>\n</tr>\n<tr>\n<td><code>customer_bank_code</code></td>\n<td>string</td>\n<td>CBN bank code for the customer's bank.</td>\n</tr>\n<tr>\n<td><code>customer_account_name</code></td>\n<td>string</td>\n<td>Resolved name on the customer's bank account.</td>\n</tr>\n<tr>\n<td><code>customer_bank_name</code></td>\n<td>string</td>\n<td>Name of the customer's bank.</td>\n</tr>\n<tr>\n<td><code>start_date</code></td>\n<td>string</td>\n<td>The date the mandate becomes active. Format: <code>YYYY-MM-DD</code>.</td>\n</tr>\n<tr>\n<td><code>end_date</code></td>\n<td>string</td>\n<td>The date the mandate expires. Format: <code>YYYY-MM-DD</code>.</td>\n</tr>\n<tr>\n<td><code>created_at</code></td>\n<td>string</td>\n<td>ISO 8601 timestamp of when the authorization was created.</td>\n</tr>\n<tr>\n<td><code>updated_at</code></td>\n<td>string</td>\n<td>ISO 8601 timestamp of the last update to the authorization.</td>\n</tr>\n</tbody>\n</table>\n</div><blockquote>\n<p><strong>Note:</strong> The <code>description</code> field in the response contains e-mandate activation instructions from NIBSS, including token payment account numbers. The customer must make a small token payment from their registered bank account (via Mobile Banking or Internet Banking) to activate the mandate. </p>\n</blockquote>\n<h4 id=\"example-response\">Example Response</h4>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"status\": true,\n  \"message\": \"Direct debit authorization initiated successfully\",\n  \"data\": {\n    \"status\": \"pending\",\n    \"reference\": \"KPY-DD-AUTH-bLXjf71O2rDSL1r\",\n    \"authorization_code\": \"KPY-AUTH-3D3F9VBTUHBIKJ5\",\n    \"amount\": 100,\n    \"currency\": \"NGN\",\n    \"debit_type\": \"fixed\",\n    \"description\": \"To complete your e-mandate activation, please make a token payment...\",\n    \"customer_account_number\": \"0112345678\",\n    \"customer_bank_code\": \"058\",\n    \"customer_account_name\": \"vee Test\",\n    \"customer_bank_name\": \"GTBank Plc\",\n    \"start_date\": \"2026-04-19\",\n    \"end_date\": \"2026-05-19\",\n    \"created_at\": \"2026-04-19T13:20:31.391Z\",\n    \"updated_at\": \"2026-04-19T13:20:31.391Z\"\n  }\n}\n\n</code></pre>\n","urlObject":{"protocol":"https","path":["merchant","api","v1","direct-debit","initiate"],"host":["api","korapay","com"],"query":[],"variable":[]}},"response":[{"id":"5ee0a0c5-8b90-4511-b087-883c4170fe58","name":"success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n  \"amount\": 100,\n  \"currency\": \"NGN\",\n  \"debit_type\": \"fixed\",\n  \"description\": \"Monthly subscription for premium plan\",\n  \"start_date\": \"2026-03-19\",\n  \"end_date\": \"2026-05-19\",\n  \"customer\": {\n    \"name\": \"Jane Doe\",\n    \"email\": \"janedoe@gmail.com\",\n    \"account_number\": \"0112345678\",\n    \"bank_code\": \"058\",\n    \"billing_address\": \"123 Victoria Island, Lagos\",\n    \"phone_number\": \"08012345678\"\n  },\n  //   for fixed\n  \"retrial_frequency\": 2,\n  \"frequency\": \"days\",\n  \"initial_debit_date\": \"2026-04-19\",\n  \"interval\": 1\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/direct-debit/initiate"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":":status","value":200},{"key":"date","value":"Sun, 19 Apr 2026 13:20:31 GMT"},{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"server","value":"cloudflare"},{"key":"access-control-allow-origin","value":"*"},{"key":"www-environment","value":"live"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"access-control-allow-credentials","value":"true"},{"key":"kora-request-id","value":"REQ-ID-kmpNlmOfkDqBzWN"},{"key":"etag","value":"W/\"4a3-q1iQA+vTKuKD3RgSijJxComVx4A\""},{"key":"content-encoding","value":"br"},{"key":"x-robots-tag","value":"noindex"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"cf-ray","value":"9eec34fc98ca79c5-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Direct debit authorization initiated successfully\",\n    \"data\": {\n        \"status\": \"pending\",\n        \"reference\": \"KPY-DD-AUTH-bLXjf71O2rDSL1r\",\n        \"authorization_code\": \"KPY-AUTH-3D3F9VBTUHBIKJ5\",\n        \"amount\": 100,\n        \"currency\": \"NGN\",\n        \"debit_type\": \"fixed\",\n        \"description\": \"To complete your e-mandate activation, please make a token payment of ₦50.00 to the account number provided below\",\n        \"customer_account_number\": \"0112345678\",\n        \"customer_bank_code\": \"058\",\n        \"customer_account_name\": \"vee Test\",\n        \"customer_bank_name\": \"GTBank Plc\",\n        \"start_date\": \"2026-04-19\",\n        \"end_date\": \"2026-05-19\",\n        \"created_at\": \"2026-04-19T13:20:31.391Z\",\n        \"updated_at\": \"2026-04-19T13:20:31.391Z\"\n    }\n}"}],"_postman_id":"a9338871-d77c-4db1-85b0-2e2675cd7015"},{"name":"Debiting A Variable Direct Debit Authorization","id":"48ca9e82-3021-47dd-98df-a3e2ea81d4b6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 100,\n    \"currency\": \"NGN\",\n    \"narration\": \"test\",\n    \"reference\": \"test-referenbwsshs\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/direct-debit/authorizations/KPY-AUTH-VJCT7BSSSCALR6F/debits","description":"<h2 id=\"debiting-a-variable-direct-debit-authorization\">Debiting A Variable Direct Debit Authorization</h2>\n<p>This endpoint initiates a debit against an existing <strong>variable</strong> direct debit authorization. Unlike fixed authorizations, variable authorizations allow the debit amount to differ between transactions, giving flexibility to charge the customer for varying amounts within the agreed authorization limits.</p>\n<hr />\n<h3 id=\"path-parameter\">Path Parameter</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Parameter</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>authorization_reference</code></td>\n<td><code>string</code></td>\n<td>The unique reference ID of the direct debit authorization to debit (e.g., <code>KPY-AUTH-VJCT7BSSSCALR6F</code>). This is embedded in the URL path.</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"request-body\">Request Body</h3>\n<p>The request body must be sent as raw JSON.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Type</th>\n<th>Required</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>amount</code></td>\n<td><code>number</code></td>\n<td>Yes</td>\n<td>The amount to debit from the customer's account for this transaction.</td>\n</tr>\n<tr>\n<td><code>narration</code></td>\n<td><code>string</code></td>\n<td>Yes</td>\n<td>A short description or note for the debit transaction (e.g., <code>\"Monthly subscription\"</code>).</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"example-request-body\">Example Request Body</h4>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"amount\": 100,\n    \"currency\": \"NGN\"\n    \"narration\": \"test\"\n}\n\n</code></pre>\n<hr />\n<h3 id=\"response\">Response</h3>\n<p>A successful response confirms that the debit has been initiated against the specified variable direct debit authorization. Check the <code>success</code> example for the expected response shape, and the <code>failed- debiting a fixed authorization</code> example to understand error handling when an incorrect authorization type is targeted.</p>\n","urlObject":{"protocol":"https","path":["merchant","api","v1","direct-debit","authorizations","KPY-AUTH-VJCT7BSSSCALR6F","debits"],"host":["api","korapay","com"],"query":[],"variable":[]}},"response":[{"id":"17c2919e-1e26-4fc4-b610-6f43edd08382","name":"failed- debiting a fixed authorization","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 300,\n    \"narration\": \"test\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/direct-debit/authorizations/KPY-AUTH-3D3F9VBTUHBIKJ5/debits"},"status":"Bad Request","code":400,"_postman_previewlanguage":null,"header":[{"key":":status","value":400},{"key":"date","value":"Sun, 19 Apr 2026 14:21:05 GMT"},{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"content-length","value":"96"},{"key":"server","value":"cloudflare"},{"key":"access-control-allow-origin","value":"*"},{"key":"www-environment","value":"live"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"access-control-allow-credentials","value":"true"},{"key":"kora-request-id","value":"REQ-ID-NivsakvA7KMdmOm"},{"key":"etag","value":"W/\"60-mAu4+5a0S4xoZop3z7/vxzc/sLI\""},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"cf-ray","value":"9eec8db9ce27b86a-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Authorization must be of type variable for variable debit\",\n    \"data\": {}\n}"},{"id":"cbadf708-3ee3-418c-bfac-afacf264ff44","name":"success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 100,\n    \"currency\": \"NGN\",\n    \"narration\": \"test\",\n    \"reference\": \"test-reference\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/direct-debit/authorizations/KPY-AUTH-VJCT7BSSSCALR6F/debits"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":":status","value":200},{"key":"date","value":"Thu, 23 Apr 2026 10:06:38 GMT"},{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"server","value":"cloudflare"},{"key":"access-control-allow-origin","value":"*"},{"key":"www-environment","value":"live"},{"key":"kora-request-id","value":"REQ-ID-3BCoh7dqg2g78SI"},{"key":"etag","value":"W/\"13f-0gqn4Xz5KCLB2YP2Xe7oxtqkXSo\""},{"key":"vary","value":"Accept-Encoding"},{"key":"x-robots-tag","value":"noindex"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"content-encoding","value":"gzip"},{"key":"cf-ray","value":"9f0c0e77cad8df88-CPT"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Variable authorization debited successfully\",\n    \"data\": {\n        \"reference\": \"test-reference\",\n        \"transaction_reference\": \"KPY-DD-W9nrDM2orILrobD\",\n        \"authorization_code\": \"KPY-AUTH-VJCT7BSSSCALR6F\",\n        \"status\": \"pending\",\n        \"amount\": 100,\n        \"fee\": 11.8,\n        \"vat\": 0.89,\n        \"currency\": \"NGN\",\n        \"processed_at\": \"2026-04-23T10:06:38.000Z\"\n    }\n}"}],"_postman_id":"48ca9e82-3021-47dd-98df-a3e2ea81d4b6"},{"name":"Get Single Direct Debit Autorization","id":"21b8c42d-77e9-421c-ba68-12742c326d31","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.korapay.com/merchant/api/v1/direct-debit/authorizations/KPY-DD-AUTH-bLXjf71O2rDSL1r","description":"<h2 id=\"get-single-direct-debit-authorization\">Get Single Direct Debit Authorization</h2>\n<p>Retrieves the details of a specific Direct Debit Authorization using its unique authorization reference.</p>\n<p>This endpoint is useful for checking the current status of an authorization, reviewing its configuration (e.g., whether it is fixed or variable), and confirming mandate details before initiating a debit.</p>\n<hr />\n<h3 id=\"path-parameters\">Path Parameters</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Parameter</th>\n<th>Type</th>\n<th>Required</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>authorization_reference</code></td>\n<td>string</td>\n<td>Yes</td>\n<td>The unique reference of the Direct Debit Authorization to retrieve. Example: <code>KPY-DD-AUTH-bLXjf71O2rDSL1r</code></td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"request-headers\">Request Headers</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Header</th>\n<th>Value</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>Authorization</code></td>\n<td><code>Bearer sk_******</code></td>\n<td>Your Kora secret key for authenticating the request.</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"response\">Response</h3>\n<p>A successful request returns a <code>200 OK</code> response with the authorization object.</p>\n<h4 id=\"response-fields\">Response Fields</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>status</code></td>\n<td>boolean</td>\n<td>Indicates whether the request was successful.</td>\n</tr>\n<tr>\n<td><code>message</code></td>\n<td>string</td>\n<td>A human-readable message describing the result.</td>\n</tr>\n<tr>\n<td><code>data</code></td>\n<td>object</td>\n<td>The Direct Debit Authorization object.</td>\n</tr>\n<tr>\n<td><code>data.reference</code></td>\n<td>string</td>\n<td>The unique reference for this authorization.</td>\n</tr>\n<tr>\n<td><code>data.status</code></td>\n<td>string</td>\n<td>Current status of the authorization (e.g., <code>active</code>, <code>inactive</code>, <code>cancelled</code>).</td>\n</tr>\n<tr>\n<td><code>data.type</code></td>\n<td>string</td>\n<td>The authorization type — <code>fixed</code> or <code>variable</code>.</td>\n</tr>\n<tr>\n<td><code>data.amount</code></td>\n<td>number</td>\n<td>The authorized debit amount (applicable for fixed authorizations).</td>\n</tr>\n<tr>\n<td><code>data.currency</code></td>\n<td>string</td>\n<td>The currency of the authorization (e.g., <code>NGN</code>).</td>\n</tr>\n<tr>\n<td><code>data.customer</code></td>\n<td>object</td>\n<td>Details of the customer who owns the authorization.</td>\n</tr>\n<tr>\n<td><code>data.bank_account</code></td>\n<td>object</td>\n<td>The bank account linked to this authorization.</td>\n</tr>\n<tr>\n<td><code>data.created_at</code></td>\n<td>string</td>\n<td>ISO 8601 timestamp of when the authorization was created.</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"error-responses\">Error Responses</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Status Code</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>401 Unauthorized</code></td>\n<td>Missing or invalid API key.</td>\n</tr>\n<tr>\n<td><code>404 Not Found</code></td>\n<td>The specified authorization reference does not exist.</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"https","path":["merchant","api","v1","direct-debit","authorizations","KPY-DD-AUTH-bLXjf71O2rDSL1r"],"host":["api","korapay","com"],"query":[],"variable":[]}},"response":[{"id":"62e0ebb3-cbff-408f-8d58-6741d9379420","name":"success","originalRequest":{"method":"GET","header":[],"url":"https://api.korapay.com/merchant/api/v1/direct-debit/authorizations/KPY-DD-AUTH-bLXjf71O2rDSL1r"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":":status","value":200},{"key":"date","value":"Thu, 23 Apr 2026 10:07:57 GMT"},{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"server","value":"cloudflare"},{"key":"access-control-allow-origin","value":"*"},{"key":"www-environment","value":"live"},{"key":"kora-request-id","value":"REQ-ID-yWVlaq5Yo6Wt1Hf"},{"key":"etag","value":"W/\"175-qn/v12TiiJ9noMYiRaEwr0bFx+w\""},{"key":"vary","value":"Accept-Encoding"},{"key":"x-robots-tag","value":"noindex"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"content-encoding","value":"gzip"},{"key":"cf-ray","value":"9f0c106cf9907a78-LOS"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Direct debit authorization retrieved successfully\",\n    \"data\": {\n        \"reference\": \"KPY-DD-AUTH-bLXjf71O2rDSL1r\",\n        \"status\": \"active\",\n        \"amount\": \"100.00\",\n        \"currency\": \"NGN\",\n        \"type\": \"fixed\",\n        \"account_name\": \"vee Test\",\n        \"account_number\": \"0112345678\",\n        \"bank_code\": \"058\",\n        \"bank_name\": \"GTBank Plc\",\n        \"status_update_reason\": null,\n        \"start_date\": \"2026-04-19\",\n        \"end_date\": \"2026-05-19\"\n    }\n}"}],"_postman_id":"21b8c42d-77e9-421c-ba68-12742c326d31"}],"id":"3f70e6b7-428d-43e2-a18f-8f4a7b2fe2f0","_postman_id":"3f70e6b7-428d-43e2-a18f-8f4a7b2fe2f0","description":"","auth":{"type":"noauth","isInherited":true,"source":{"_postman_id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","name":"Pay-ins","type":"folder"}}},{"name":"Stablecoins","item":[{"name":"Create Customer Stablecoin Wallet","id":"1898782c-2d07-4c89-9573-c7914a4f0de4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"IHC_369b35e9-1f04-4e88-9a89-745ead139cd8\",\n    \"currency\": \"USDT\",\n    \"network\": \"SOL\",\n    \"customer\": {\n        \"name\": \"Rhianna Russel\",\n        \"email\": \"korapay@gmail.com\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/crypto/wallets","description":"<h2 id=\"create-customer-wallet\">Create Customer Wallet</h2>\n<p>Creates a new stablecoin wallet for a customer on a specified blockchain network.</p>\n<hr />\n<h2 id=\"authentication\">Authentication</h2>\n<p>This request requires a <code>secret_key</code> for authentication, <code>Bearer {secretKey}</code></p>\n<hr />\n<h2 id=\"request-body\">Request Body</h2>\n<p>The request body must be sent as JSON.</p>\n<ul>\n<li><p><code>reference</code> (string , required): A unique identifier for the wallet creation request.</p>\n</li>\n<li><p><code>currency</code> (string , required): The cryptocurrency to use for the wallet (e.g., <code>USDT</code>).</p>\n</li>\n<li><p><code>network</code> (string , optional): The blockchain network for the wallet</p>\n</li>\n<li><p><code>customer</code> (object , required)</p>\n<ul>\n<li><p><code>customer.name</code> (string , required): Full name of the customer.</p>\n</li>\n<li><p><code>customer.email</code> (string , required): Email address of the customer.</p>\n</li>\n</ul>\n</li>\n</ul>\n<hr />\n<h2 id=\"notes\">Notes</h2>\n<p>The available currencies are USDT and USDC. The supported networks for each currency are:</p>\n<ul>\n<li><p>USDT</p>\n<ul>\n<li><p>SOL</p>\n</li>\n<li><p>ETH</p>\n</li>\n<li><p>TRX</p>\n</li>\n</ul>\n</li>\n<li><p>USDC</p>\n<ul>\n<li><p>SOL</p>\n</li>\n<li><p>ETH</p>\n</li>\n<li><p>TRX</p>\n</li>\n</ul>\n</li>\n</ul>\n","auth":{"type":"noauth","isInherited":true,"source":{"_postman_id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","name":"Pay-ins","type":"folder"}},"urlObject":{"path":["merchant","api","v1","crypto","wallets"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"e1d1490b-d2d0-4616-b425-37fecbf8114c","name":"success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"IHC_c6e1ba57-fb28-4364-9b8d-910d8ced6be9\",\n    \"currency\": \"USDT\",\n    \"network\": \"SOL\",\n    \"customer\": {\n        \"name\": \"Rhianna Russel\",\n        \"email\": \"korapay@gmail.com\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/crypto/wallets"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Wallet successfully created\",\n    \"data\": {\n        \"wallet_reference\": \"tre-cry-d90174a85bfb8b3f9781d0587ab652848b341d746bff2083f08aad9f12c01aff\",\n        \"reference\": \"IHC_46fdc18d-9c86-4350-8ffb-f7f89d367a18\",\n        \"address\": \"6ePqcT2tbwFYyYdmktCVmaxptMDdhoqz2n8Wkivtb7\",\n        \"network\": \"SOL\",\n        \"currency\": \"USDT\",\n        \"customer\": {\n            \"name\": \"Rhianna Russel\",\n            \"email\": \"korapay@gmail.com\"\n        },\n        \"status\": \"active\"\n    }\n}"},{"id":"9a8b5ad1-1ed0-404b-8258-0f9cbf26f103","name":"failure - duplicate reference","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"IHC_3e8895f6-2352-4e1c-9528-670b8783febb\",\n    \"currency\": \"USDT\",\n    \"network\": \"SOL\",\n    \"customer\": {\n        \"name\": \"Rhianna Russel\",\n        \"email\": \"korapay@gmail.com\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/crypto/wallets"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Wallet with reference IHC_3e8895f6-2352-4e1c-9528-670b8783febb already exists\",\n    \"data\": null\n}"}],"_postman_id":"1898782c-2d07-4c89-9573-c7914a4f0de4"},{"name":"Get Customer Stablecoin Wallet","id":"f7025383-0b95-4aa5-9e01-47eb7997c3cc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.korapay.com/merchant/api/v1/crypto/wallets/:reference","description":"<h2 id=\"get-customer-wallet\">Get Customer Wallet</h2>\n<p>Retrieves the details of a specific customer's stablecoin wallet using its unique reference. This endpoint returns wallet information including the blockchain address, network, currency, associated customer details, and current wallet status.</p>\n<hr />\n<h3 id=\"path-parameters\">Path Parameters</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Parameter</th>\n<th>Type</th>\n<th>Required</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>reference</code></td>\n<td>string</td>\n<td>Yes</td>\n<td>The unique reference identifier for the customer's wallet.</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"authentication\">Authentication</h3>\n<p>This request requires a <code>secret_key</code> for authentication, <code>Bearer {secretKey}</code></p>\n<hr />\n<h3 id=\"response-fields-http-200\">Response Fields (HTTP 200)</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>status</code></td>\n<td>boolean</td>\n<td>Indicates whether the request was successful.</td>\n</tr>\n<tr>\n<td><code>message</code></td>\n<td>string</td>\n<td>A human-readable message describing the result (e.g., <code>\"Wallet successfully retrieved\"</code>).</td>\n</tr>\n<tr>\n<td><code>data.wallet_reference</code></td>\n<td>string</td>\n<td>The internal wallet reference generated by the system.</td>\n</tr>\n<tr>\n<td><code>data.reference</code></td>\n<td>string</td>\n<td>The unique reference provided when the wallet was created (mirrors the path parameter).</td>\n</tr>\n<tr>\n<td><code>data.address</code></td>\n<td>string</td>\n<td>The blockchain address associated with this wallet.</td>\n</tr>\n<tr>\n<td><code>data.network</code></td>\n<td>string</td>\n<td>The blockchain network the wallet operates on (e.g., <code>SOL</code> for Solana).</td>\n</tr>\n<tr>\n<td><code>data.currency</code></td>\n<td>string</td>\n<td>The currency supported by this wallet (e.g., <code>USDT</code>).</td>\n</tr>\n<tr>\n<td><code>data.customer.name</code></td>\n<td>string</td>\n<td>The full name of the customer who owns the wallet.</td>\n</tr>\n<tr>\n<td><code>data.customer.email</code></td>\n<td>string</td>\n<td>The email address of the customer who owns the wallet.</td>\n</tr>\n<tr>\n<td><code>data.status</code></td>\n<td>string</td>\n<td>The current status of the wallet (e.g., <code>active</code>).</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"noauth","isInherited":true,"source":{"_postman_id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","name":"Pay-ins","type":"folder"}},"urlObject":{"path":["merchant","api","v1","crypto","wallets",":reference"],"host":["https://api.korapay.com"],"query":[],"variable":[{"id":"b187bc70-6515-4b6a-bf46-446dcfe2dbd3","type":"any","value":"","key":"reference"}]}},"response":[{"id":"71f8d1c7-0681-4252-b012-a081a8b7b3fe","name":"success","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/merchant/api/v1/crypto/wallets/:reference","host":["https://api.korapay.com"],"path":["merchant","api","v1","crypto","wallets",":reference"],"variable":[{"key":"reference","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Wallet successfully retrieved\",\n    \"data\": {\n        \"wallet_reference\": \"tre-cry-1a603a7820c43a42b6f47832a46c62ccc2affe21cf3cf55ab435a519d60d4cad\",\n        \"reference\": \"IHC_2bd78263-95b2-423d-a8eb-b83b3d344bbb\",\n        \"address\": \"PB9Tj8HSSm6hcx3M8bwqgsvucrQ6xBWHnAMYEM41BV\",\n        \"network\": \"SOL\",\n        \"currency\": \"USDT\",\n        \"customer\": {\n            \"name\": \"Rhianna Russel\",\n            \"email\": \"korapay@gmail.com\"\n        },\n        \"status\": \"active\"\n    }\n}"}],"_postman_id":"f7025383-0b95-4aa5-9e01-47eb7997c3cc"}],"id":"e7b56c7b-426c-4ecc-a1a2-8b1bdcc9b295","_postman_id":"e7b56c7b-426c-4ecc-a1a2-8b1bdcc9b295","description":"","auth":{"type":"noauth","isInherited":true,"source":{"_postman_id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","name":"Pay-ins","type":"folder"}}},{"name":"Query Charge","id":"8a602daa-6e83-4118-9ff3-ba8c09ab6f48","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.korapay.com/merchant/api/v1/charges/:reference","description":"<p>This endpoint returns the status and details of a charge through the reference.</p>\n<h2 id=\"url-parameters\">URL Parameters</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>reference</td>\n<td>string</td>\n<td>the unique charge reference</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"successful-response-body\">Successful Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>request status message</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>object containing transaction details</td>\n</tr>\n<tr>\n<td>data.reference</td>\n<td>string</td>\n<td>the transaction unique reference</td>\n</tr>\n<tr>\n<td>data.amount</td>\n<td>money</td>\n<td>transaction amount</td>\n</tr>\n<tr>\n<td>data.amount_paid</td>\n<td>money</td>\n<td>the amount paid by the customer</td>\n</tr>\n<tr>\n<td>data.amount_accepted</td>\n<td>money</td>\n<td>the amount accepted by Kora.  <br />  <br />Its value is based on the configuration for overpayment and underpayment.  <br />  <br />For pay with bank transfer, this is the amount that must be credited to your customer.</td>\n</tr>\n<tr>\n<td>money</td>\n<td>transaction fee</td>\n<td></td>\n</tr>\n<tr>\n<td>data.currency</td>\n<td>string</td>\n<td>transaction currency e.g. NGN</td>\n</tr>\n<tr>\n<td>data.status</td>\n<td>string</td>\n<td>gives an overview status of the transaction ie. was the payment made successfully or not. It can be <strong>success</strong>, <strong>pending</strong>, <strong>processing</strong>, <strong>expired</strong> or <strong>failed</strong></td>\n</tr>\n<tr>\n<td>data.description</td>\n<td>string</td>\n<td>the transaction description</td>\n</tr>\n<tr>\n<td>data.created_at</td>\n<td>datetime</td>\n<td>the date the transaction was created</td>\n</tr>\n<tr>\n<td>data.metadata</td>\n<td>object</td>\n<td>the metadata information passed</td>\n</tr>\n<tr>\n<td>data.payer_bank_account</td>\n<td>object</td>\n<td>object containing the bank account details of the payer</td>\n</tr>\n<tr>\n<td>data.payer_bank_account.account_number</td>\n<td>string</td>\n<td>the account number of the payer</td>\n</tr>\n<tr>\n<td>data.payer_bank_account.account_name</td>\n<td>string</td>\n<td>the account name of the payer</td>\n</tr>\n<tr>\n<td>data.payer_bank_account.bank_name</td>\n<td>string</td>\n<td>the name of the payer's bank</td>\n</tr>\n<tr>\n<td>data.payment_attempts</td>\n<td>array</td>\n<td>an array holding the list of attempts for each payments. Only available when status is <code>failed</code> or <code>expired</code></td>\n</tr>\n<tr>\n<td>data.payment_attempts[n].reference</td>\n<td>string</td>\n<td>the attempt's reference</td>\n</tr>\n<tr>\n<td>data.payment_attempts[n].status</td>\n<td>string</td>\n<td>the attempt's status</td>\n</tr>\n<tr>\n<td>data.payment_attempts[n].channel</td>\n<td>string</td>\n<td>the attempt's channel</td>\n</tr>\n<tr>\n<td>data.payment_attempts[n].message</td>\n<td>string</td>\n<td>the failure reason for the attempt</td>\n</tr>\n<tr>\n<td>data.card</td>\n<td>object</td>\n<td><code>optional</code> object containing the card details of the payer</td>\n</tr>\n<tr>\n<td>data.card.card_type</td>\n<td>string</td>\n<td>the type of card used by the payer. eg. mastercard</td>\n</tr>\n<tr>\n<td>data.card.first_six</td>\n<td>string</td>\n<td>the first six digit of the payer's card</td>\n</tr>\n<tr>\n<td>data.card.last_four</td>\n<td>string</td>\n<td>the last four digit of the payer's card</td>\n</tr>\n<tr>\n<td>data.card.expiry</td>\n<td>string</td>\n<td>the expiry month and year of the payer's card</td>\n</tr>\n<tr>\n<td>data.mobile_money</td>\n<td>string</td>\n<td><code>optional</code> object containing the mobile money details of the payer</td>\n</tr>\n<tr>\n<td>data.mobile_money.mobile_number</td>\n<td>string</td>\n<td>the payer's mobile money number</td>\n</tr>\n<tr>\n<td>data.mobile_money.operator</td>\n<td>string</td>\n<td>the operator for the mobile money charge</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"failed-response-body\">Failed Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>request status true/false</td>\n</tr>\n<tr>\n<td>error</td>\n<td>string</td>\n<td>error returned</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>request status description</td>\n</tr>\n<tr>\n<td>data</td>\n<td>string</td>\n<td>error data</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","charges",":reference"],"host":["https://api.korapay.com"],"query":[],"variable":[{"type":"any","value":"your-transaction-reference-001","key":"reference"}]}},"response":[{"id":"7d624c2a-a64d-47d9-8151-87d562836106","name":"Query Charge - Successful Pay-In","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer sk_***"}],"url":{"raw":"https://api.korapay.com/merchant/api/v1/charges/:reference","host":["https://api.korapay.com"],"path":["merchant","api","v1","charges",":reference"],"variable":[{"key":"reference","value":"your-transaction-reference-001"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"Sucuri/Cloudproxy"},{"key":"Date","value":"Mon, 16 Nov 2020 13:59:21 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"247"},{"key":"Connection","value":"keep-alive"},{"key":"X-Sucuri-ID","value":"19002"},{"key":"access-control-allow-origin","value":"*"},{"key":"www-environment","value":"test"},{"key":"etag","value":"W/\"f7-doO7UXR8fK4BdjfPzU4T91VEK1U\""},{"key":"vary","value":"Accept-Encoding"},{"key":"cache-control","value":"no-store"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"content-security-policy","value":"frame-ancestors 'none'"},{"key":"X-Sucuri-Cache","value":"MISS"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Charge retrieved successfully\",\n    \"data\": {\n        \"reference\": \"your-transaction-reference-001\",\n        \"status\": \"success\",\n        \"amount\": \"100.00\",\n        \"amount_paid\": \"100.00\",\n        \"fee\": \"25.00\",\n        \"currency\": \"NGN\",\n        \"description\": \"Payment for Product Y\",\n        \"payer_bank_account\": {\n            \"account_number\": \"******2468\",\n            \"account_name\": \"John Doe\",\n            \"bank_name\": \"WEMA BANK\"\n        }\n    }\n}"},{"id":"41dd027c-2fed-4435-be11-fa59de03f6ab","name":"Query Charge - Failed Pay-in","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/merchant/api/v1/charges/:reference","host":["https://api.korapay.com"],"path":["merchant","api","v1","charges",":reference"],"variable":[{"key":"reference","value":"your-transaction-reference-001"}]}},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Charge retrieved successfully\",\n    \"data\": {\n        \"reference\": \"your-transaction-reference-001\",\n        \"status\": \"failed\",\n        \"amount\": \"100.00\",\n        \"amount_paid\": \"0.00\",\n        \"fee\": \"25.00\",\n        \"currency\": \"NGN\",\n        \"description\": \"Card Payment\",\n        \"created_at\": \"2021-10-28 07:28:59\",\n        \"payment_attempts\": [\n            {\n                \"reference\": \"KPY-CM-unEr27sJ616S\",\n                \"status\": \"failed\",\n                \"channel\": \"card\",\n                \"message\": \"Insufficient funds\"\n            }\n        ],\n        \"card\": {\n            \"card_type\": \"mastercard\",\n            \"first_six\": \"539983\",\n            \"last_four\": \"8381\",\n            \"expiry\": \"10/31\"\n        }\n    }\n}"},{"id":"cd10d11f-66e6-4e87-b6d2-c14e3e1e756b","name":"Query Charge - Expired Pay-in","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/merchant/api/v1/charges/:reference","host":["https://api.korapay.com"],"path":["merchant","api","v1","charges",":reference"],"variable":[{"key":"reference","value":"your-transaction-reference-001"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Charge retrieved successfully\",\n    \"data\": {\n        \"reference\": \"your-transaction-reference-001\",\n        \"status\": \"expired\",\n        \"amount\": \"100.00\",\n        \"amount_paid\": \"0.00\",\n        \"fee\": \"25.00\",\n        \"currency\": \"NGN\",\n        \"description\": \"Payment for Product X\",\n        \"created_at\": \"2021-10-28 07:28:59\",\n        \"payment_attempts\": [\n            {\n                \"reference\": \"KPY-CM-unE13asJ0154\",\n                \"status\": \"expired\",\n                \"channel\": \"bank_transfer\",\n                \"message\": \"Action required\"\n            }\n        ]\n    }\n}"},{"id":"a23f6e85-aa98-4210-ba17-786462025a73","name":"Query Charge - Not Found","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/merchant/api/v1/charges/:reference","host":["https://api.korapay.com"],"path":["merchant","api","v1","charges",":reference"],"variable":[{"key":"reference","value":"your-transaction-reference-001"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Charge not found\",\n    \"data\": null\n}"},{"id":"758c56c2-a050-4f04-8d5a-4508ee50b61a","name":"Query Charge: Mobile Money - Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/merchant/api/v1/charges/:reference","host":["https://api.korapay.com"],"path":["merchant","api","v1","charges",":reference"],"variable":[{"key":"reference","value":"your-transaction-reference-001"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Charge retrieved successfully\",\n    \"data\": {\n        \"reference\": \"your-transaction-reference-001\",\n        \"status\": \"success\",\n        \"amount\": \"100.00\",\n        \"amount_paid\": \"100.00\",\n        \"fee\": \"25.00\",\n        \"currency\": \"NGN\",\n        \"description\": \"Payment for Product Y\",\n        \"mobile_money\": {\n            \"mobile_number\": \"+25490******268\",\n            \"netwprk_provuder\": \"M-Pesa\"\n        }\n    }\n}"},{"id":"8cc05748-6ac5-47f2-ab80-3311ff382eb4","name":"Query charge Pool Account","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/merchant/api/v1/charges/:reference","host":["https://api.korapay.com"],"path":["merchant","api","v1","charges",":reference"],"variable":[{"key":"reference","value":"KPY-PAY-DDWYJxN0ttCrN9Z"}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"496"},{"key":"ETag","value":"W/\"1f0-DX5CbAOqxIYHRROfi9bh5ND/JZA\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Date","value":"Wed, 05 Nov 2025 07:49:27 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Charge retrieved successfully\",\n    \"data\": {\n        \"reference\": \"KPY-PAY-DDWYJxN0ttCrN9Z\",\n        \"status\": \"success\",\n        \"amount\": \"30.00\",\n        \"amount_paid\": \"30.00\",\n        \"fee\": 2.32,\n        \"currency\": \"KES\",\n        \"description\": \"Pool account transfer from tobe\",\n        \"customer\": {\n            \"name\": \"tobe\",\n            \"email\": \"tobe12@gmail.com\"\n        },\n        \"pool_account\": {\n            \"pool_account_reference\": \"MIKP7DXSJGRZKES\",\n            \"account_details\": {\n                \"currency\": \"KES\",\n                \"bank_code\": \"mobile_money\",\n                \"bank_name\": \"Kora kes mobile money\"\n            },\n            \"payer_details\": {\n                \"payer_name\": \"Test Payer\"\n            }\n        }\n    }\n}"}],"_postman_id":"8a602daa-6e83-4118-9ff3-ba8c09ab6f48"},{"name":"Get All Pay-ins","id":"69f19d70-7c9d-4f0b-902a-1c7624a15cc1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"GET","header":[],"url":"{{base_url}}/merchant/api/v1/pay-ins?limit=10","description":"<p>This API allows you to retrieve the history of your pay-ins. The maximum amount of records that can be retrieved per request is 50</p>\n<h2 id=\"successful-response-body\">Successful Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>request status message</td>\n</tr>\n<tr>\n<td>data.has_more</td>\n<td>boolean</td>\n<td>This signifies whether there are still more items that can be retrieved on the next page</td>\n</tr>\n<tr>\n<td>data.payins</td>\n<td>array</td>\n<td>This contains the list of pay-in records. The array contains objects where each object has the information of the pay-in information</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","pay-ins"],"host":["{{base_url}}"],"query":[{"key":"limit","value":"10"},{"disabled":true,"key":"currency","value":"NGN"},{"disabled":true,"key":"ending_before","value":"cus_9C1"},{"disabled":true,"key":"starting_after","value":"cus_9CB"},{"disabled":true,"key":"date_from","value":"2021-04-23"},{"disabled":true,"key":"date_to","value":"2022-01-28"}],"variable":[]}},"response":[{"id":"fe171682-462b-4f0d-b729-d5707054fd4c","name":"Get All Pay-ins - Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/api/v1/pay-ins?limit=10&currency=NGN&ending_before=cus_9C1&starting_after=cus_9CB&date_from=2021-04-23&date_to=2022-01-28","host":["https://api.korapay.com"],"path":["api","v1","pay-ins"],"query":[{"key":"limit","value":"10"},{"key":"currency","value":"NGN"},{"key":"ending_before","value":"cus_9C1"},{"key":"starting_after","value":"cus_9CB"},{"key":"date_from","value":"2021-04-23"},{"key":"date_to","value":"2022-01-28"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Transactions retrieved successfully\",\n    \"data\": {\n        \"has_more\": false,\n        \"payins\": [\n            {\n                \"pointer\": \"cus_9CB\",\n                \"reference\": \"KPY-PAY-B67oB4gCLFSM\",\n                \"status\": \"processing\",\n                \"amount\": \"2000.00\",\n                \"amount_paid\": \"1973.12\",\n                \"fee\": null,\n                \"currency\": \"NGN\",\n                \"description\": \"pay me my money!\",\n                \"payment_method\": \"bank_transfer\",\n                \"message\": \"Action required\",\n                \"date_created\": \"2022-01-28 14:45:48\",\n                \"date_completed\": null,\n                \"payment_sources\": {\n                    \"amount_paid\": \"1973.12\",\n                    \"narration\": \"pay me my money!\",\n                    \"payment_source_type\": \"bank_transfer\",\n                    \"message\": \"Action required\",\n                    \"status\": \"processing\"\n                }\n            },\n            {\n                \"pointer\": \"cus_9C8\",\n                \"reference\": \"KPY-PAY-TuZG54uCY8dk\",\n                \"status\": \"complete\",\n                \"amount\": \"100.00\",\n                \"amount_paid\": \"-10.19\",\n                \"fee\": \"102.50\",\n                \"currency\": \"NGN\",\n                \"description\": \"payment for a book oo\",\n                \"payment_method\": \"bank_transfer\",\n                \"message\": \"Successful\",\n                \"date_created\": \"2021-03-03 05:21:57\",\n                \"date_completed\": null,\n                \"payment_sources\": {\n                    \"amount_paid\": \"-10.19\",\n                    \"narration\": \"payment for a book oo\",\n                    \"payment_source_type\": \"bank_transfer\",\n                    \"message\": \"Successful\",\n                    \"status\": \"success\"\n                }\n            }\n        ]\n    }\n}"}],"_postman_id":"69f19d70-7c9d-4f0b-902a-1c7624a15cc1"}],"id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7","description":"<p><strong>Pay-ins</strong> (also called Collections) are inbound payments or fund transfers that you receive into your merchant account. These APIs allow you to collect funds from your customers through bank transfers and card APIs.</p>\n","auth":{"type":"noauth","isInherited":false},"event":[{"listen":"prerequest","script":{"id":"a3eaadcf-48f1-4b77-8ced-59c5816a89a0","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"843f09d7-766f-4bf2-bdaf-a63e2c089e05","type":"text/javascript","exec":[""]}}],"_postman_id":"c2706727-6109-4e37-b96a-08d2bf1c3ad7"},{"name":"Reversals","item":[{"name":"Refunds","item":[{"name":"Initiate Refund","id":"43bb3373-bacb-4566-90a0-06cbdc03741a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 100,\n    \"payment_reference\": \"KPY-PAY-YgPf9qBlmUeG\",\n    \"reference\": \"RFD-2025010101\",\n    \"reason\": \"Customer request\",\n    \"webhook_url\": \"https://webhook.site/886fe05e-5944-4975-a2f7-0d1616bc39d5\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/refunds/initiate","description":"<h3 id=\"initiate-a-refund\">Initiate a Refund</h3>\n<p>This endpoint is used to initiate a refund for a payment.</p>\n<h4 id=\"request-body\">Request Body</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>amount</td>\n<td>Number</td>\n<td><code>Optional</code> The amount to be refunded</td>\n</tr>\n<tr>\n<td>payment_reference</td>\n<td>String</td>\n<td><code>Required</code> The reference of the original payment</td>\n</tr>\n<tr>\n<td>reference</td>\n<td>String</td>\n<td><code>Required</code> The reference for the refund</td>\n</tr>\n<tr>\n<td>reason</td>\n<td>String</td>\n<td><code>Optional</code> The reason for the refund</td>\n</tr>\n<tr>\n<td>webhook_url</td>\n<td>String</td>\n<td><code>Optional</code> The URL for webhook notifications</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"response\">Response</h4>\n<p>The API responds with the following fields:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>data.refund_reference</td>\n<td>string</td>\n<td>Reference for the refund</td>\n</tr>\n<tr>\n<td>data.refund_date</td>\n<td>string</td>\n<td>Date of the refund</td>\n</tr>\n<tr>\n<td>data.status</td>\n<td>string</td>\n<td>Status of the refund</td>\n</tr>\n<tr>\n<td>data.payment_reference</td>\n<td>string</td>\n<td>Reference for the original payment</td>\n</tr>\n<tr>\n<td>data.reason</td>\n<td>string</td>\n<td>Reason for the refund</td>\n</tr>\n<tr>\n<td>data.amount_returned</td>\n<td>number</td>\n<td>Amount returned for the refund</td>\n</tr>\n<tr>\n<td>data.channel</td>\n<td>string</td>\n<td>Channel used for the refund</td>\n</tr>\n<tr>\n<td>data.currency</td>\n<td>string</td>\n<td>Currency of the refund</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","refunds","initiate"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"8b6b5e5a-e8e8-48ba-b9c9-c4b4486c05fc","name":"Successful","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 100,\n    \"payment_reference\": \"KPY-PAY-YgPf9qBlmUeG\",\n    \"reference\": \"RFD-2025010101\",\n    \"reason\": \"Customer request\",\n    \"webhook_url\": \"https://webhook.site/886fe05e-5944-4975-a2f7-0d1616bc39d5\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/refunds/initiate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 15 Apr 2025 17:30:12 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"125-iYY+ZLFKkENgehtV1Ofsyf1MFzU\""},{"key":"vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"content-security-policy","value":"frame-ancestors 'none'"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"930d2b60ad41e643-IAD"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Refund successfully initiated\",\n    \"data\": {\n        \"refund_reference\": \"RFD-2025010101\",\n        \"refund_date\": \"2025-04-15T17:30:12.272Z\",\n        \"status\": \"processing\",\n        \"payment_reference\": \"KPY-PAY-YgPf9qBlmUeG\",\n        \"reason\": \"Customer request\",\n        \"amount_returned\": 100,\n        \"channel\": \"modal\",\n        \"currency\": \"NGN\"\n    }\n}"},{"id":"d3bb6dd4-3953-4fe1-b224-ae6ffca42fe6","name":"Invalid Transaction","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 10,\n    \"payment_reference\": \"KPY-PAY-YgPf9qBlmUeG\",\n    \"reference\": \"RFD-20250101\",\n    \"reason\": \"Customer request\",\n    \"webhook_url\": \"https://webhook.site/886fe05e-5944-4975-a2f7-0d1616bc39d5\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/refunds/initiate"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 15 Apr 2025 17:25:19 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"4d-GKeL3xo71YF9Ij2UktMnHtSGvfI\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Set-Cookie","value":"__cf_bm=gkGDtzRa5jA0udkw9Vj3NYbeMsmgFky.goIrr.wiV8I-1744737919-1.0.1.1-0mwQl7sO7jKo8Dv9AMNJA_4S4viRPzZyJGZsnO7YDL1yhsaHE27PGwvObd0aBSnAHQ.ONPyDSnMrGOsCGcL7XL2yJmrMZAMjaUDrmpNen4k; path=/; expires=Tue, 15-Apr-25 17:55:19 GMT; domain=.korapay.com; HttpOnly; Secure; SameSite=None"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"930d24369eecd638-IAD"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Transaction not found\",\n    \"data\": null\n}"}],"_postman_id":"43bb3373-bacb-4566-90a0-06cbdc03741a"},{"name":"Get Refund Details","id":"77586dbf-79a1-4ebb-820b-f22c4e5cf351","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.korapay.com/merchant/api/v1/refunds/:reference","urlObject":{"path":["merchant","api","v1","refunds",":reference"],"host":["https://api.korapay.com"],"query":[],"variable":[{"id":"2327cbcc-7b66-45a0-99f4-d0501f3ed71a","type":"any","value":"RFD-2025010102","key":"reference"}]}},"response":[{"id":"92a2984d-d82f-4f0b-84cd-cd001607aeda","name":"Successful","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/merchant/api/v1/refunds/:reference","host":["https://api.korapay.com"],"path":["merchant","api","v1","refunds",":reference"],"variable":[{"key":"reference","value":"RFD-2025010101"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 15 Apr 2025 17:31:44 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"176-Uv2/eXGBdA7lITfFzElis3jkoqg\""},{"key":"vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"content-security-policy","value":"frame-ancestors 'none'"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"930d2da18eeb059f-IAD"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Refund details retrieved successfully\",\n    \"data\": {\n        \"amount\": \"100.00\",\n        \"status\": \"processing\",\n        \"currency\": \"NGN\",\n        \"destination\": \"customer\",\n        \"reference\": \"RFD-2025010101\",\n        \"reason\": \"Customer request\",\n        \"payment_reference\": \"KPY-PAY-YgPf9qBlmUeG\",\n        \"transaction_amount\": \"100.00\",\n        \"payment_method\": \"bank_transfer\",\n        \"created_at\": \"2025-04-15 18:30:12\",\n        \"completed_at\": null\n    }\n}"},{"id":"ba97d40f-8ee7-4ef0-81e1-2963d777cbc1","name":"Refund not found","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/merchant/api/v1/refunds/:reference","host":["https://api.korapay.com"],"path":["merchant","api","v1","refunds",":reference"],"variable":[{"key":"reference","value":"RFD-2025010102"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 15 Apr 2025 17:32:07 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"48-+cQ8uLk0EWX43FZl4uX1O8fP4kc\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"930d2e2f3f202418-IAD"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Refund not found\",\n    \"data\": null\n}"}],"_postman_id":"77586dbf-79a1-4ebb-820b-f22c4e5cf351"},{"name":"Get Refunds History","id":"6b1c594d-20d2-468c-8968-023d215e0eb1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.korapay.com/merchant/api/v1/refunds?starting_after=cus_01","urlObject":{"path":["merchant","api","v1","refunds"],"host":["https://api.korapay.com"],"query":[{"disabled":true,"key":"ending_before","value":"cus_48"},{"disabled":true,"key":"currency","value":"NGN"},{"disabled":true,"key":"limit","value":"10"},{"disabled":true,"key":"Date_from","value":"07-02-2025"},{"disabled":true,"key":"Date_to","value":"07-02-2025"},{"disabled":true,"key":"status[]","value":"processing"},{"key":"starting_after","value":"cus_01"}],"variable":[]}},"response":[{"id":"1165ab6b-f551-4234-9374-5bddf753b820","name":"Successful","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/merchant/api/v1/refunds","host":["https://api.korapay.com"],"path":["merchant","api","v1","refunds"],"query":[{"key":"ending_before","value":"cus_48","disabled":true},{"key":"currency","value":"NGN","disabled":true},{"key":"limit","value":"10","disabled":true},{"key":"Date_from","value":"07-02-2025","disabled":true},{"key":"Date_to","value":"07-02-2025","disabled":true},{"key":"status[]","value":"processing","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 15 Apr 2025 17:33:13 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"495-ym2q3diriwGi9uuZ7dQ3yMp5lEQ\""},{"key":"vary","value":"Accept-Encoding"},{"key":"Content-Encoding","value":"gzip"},{"key":"Cache-Control","value":"no-store"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"content-security-policy","value":"frame-ancestors 'none'"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"930d2fcf4c41d70b-IAD"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Refunds retrieved successfully\",\n    \"data\": {\n        \"has_more\": false,\n        \"refunds\": [\n            {\n                \"pointer\": \"cus_21\",\n                \"reference\": \"RFD-2025010101\",\n                \"status\": \"processing\",\n                \"amount\": \"100.00\",\n                \"currency\": \"NGN\",\n                \"payment_reference\": \"KPY-PAY-YgPf9qBlmUeG\",\n                \"reason\": \"Customer request\",\n                \"transaction_amount\": \"100.00\",\n                \"created_at\": \"2025-04-15 18:30:12\",\n                \"completed_at\": null\n            },\n            {\n                \"pointer\": \"cus_1A\",\n                \"reference\": \"Gtcio7NEATi23\",\n                \"status\": \"processing\",\n                \"amount\": \"50.00\",\n                \"currency\": \"NGN\",\n                \"payment_reference\": \"KPY-PAY-AkCr9FZ7BkaQ\",\n                \"reason\": \"Unfufilled obligation\",\n                \"transaction_amount\": \"1111.00\",\n                \"created_at\": \"2025-04-14 10:07:08\",\n                \"completed_at\": null\n            },\n            {\n                \"pointer\": \"cus_19\",\n                \"reference\": \"Gtcio7NEATi2\",\n                \"status\": \"processing\",\n                \"amount\": \"100.00\",\n                \"currency\": \"NGN\",\n                \"payment_reference\": \"KPY-PAY-kmZyWbkSm7Wf\",\n                \"reason\": \"Customer overpayment\",\n                \"transaction_amount\": \"100.00\",\n                \"created_at\": \"2025-04-14 10:03:55\",\n                \"completed_at\": null\n            },\n            {\n                \"pointer\": \"cus_5\",\n                \"reference\": \"KPY-RFD-2wDSxm0myBY6\",\n                \"status\": \"success\",\n                \"amount\": \"2000.00\",\n                \"currency\": \"KES\",\n                \"payment_reference\": \"KPY-PAY-8wmMWe3cBAdP\",\n                \"reason\": \"Cancelled Transaction\",\n                \"transaction_amount\": \"5000.00\",\n                \"created_at\": \"2023-07-17 09:08:10\",\n                \"completed_at\": \"2023-07-17 09:08:10\"\n            }\n        ]\n    }\n}"}],"_postman_id":"6b1c594d-20d2-468c-8968-023d215e0eb1"}],"id":"55145360-e23d-4244-b52e-6a51e90ad2ae","description":"<p>The Refunds API allows merchants to refund successful transactions via API. The API enables merchants to automate refunds and retrieve refund details when needed.</p>\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"_postman_id":"55145360-e23d-4244-b52e-6a51e90ad2ae"}],"id":"5502b400-a33f-4198-a5ef-6bbdc4e5ee24","_postman_id":"5502b400-a33f-4198-a5ef-6bbdc4e5ee24","description":""},{"name":"Payouts","item":[{"name":"Single Payout","item":[{"name":"Single Payout to Bank Account","id":"9e0b5372-ba48-49f6-ae90-c5d66903bed0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"your-unique-transaction-reference-001\",\n    \"destination\": {\n        \"type\": \"bank_account\",\n        \"amount\": \"100\",\n        \"currency\": \"NGN\",\n        \"narration\": \"Test Transfer Payment\",\n        \"bank_account\": {\n            \"bank\": \"033\",\n            \"account\": \"0000000000\"\n        },\n        \"customer\": {\n            \"name\": \"John Doe\",\n            \"email\": \"johndoe@email.com\"\n        }\n    }\n}\n","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse","description":"<p>This endpoint is used to initiate a single disbursement to bank account.</p>\n<h2 id=\"request-body\">Request Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>reference</td>\n<td>string</td>\n<td><code>Optional</code> — unique transaction reference</td>\n</tr>\n<tr>\n<td>destination</td>\n<td>object</td>\n<td><code>Required</code></td>\n</tr>\n<tr>\n<td>destination.type</td>\n<td>string</td>\n<td><code>Required</code> — can be <code>bank_account</code> or <code>mobile_money</code></td>\n</tr>\n<tr>\n<td>destination.amount</td>\n<td>number</td>\n<td><code>Required</code> — transaction amount (two decimal places)</td>\n</tr>\n<tr>\n<td>destination.currency</td>\n<td>string</td>\n<td><code>Required</code> — transaction currency e.g. <code>NGN</code>, <code>KES</code>, <code>GHS</code>, <code>XOF</code>, <code>XAF</code>, <code>EGP</code>, <code>ZAR</code>, <code>USD</code>, or <code>GBP</code></td>\n</tr>\n<tr>\n<td>destination.narration</td>\n<td>string</td>\n<td><code>Optional</code> — transaction narration or description</td>\n</tr>\n<tr>\n<td>destination.customer</td>\n<td>object</td>\n<td><code>Required</code></td>\n</tr>\n<tr>\n<td>destination.customer.name</td>\n<td>string</td>\n<td><code>Optional</code> — customer name</td>\n</tr>\n<tr>\n<td>destination.customer.email</td>\n<td>string</td>\n<td><code>Required</code> — customer email</td>\n</tr>\n<tr>\n<td>destination.bank_account</td>\n<td>object</td>\n<td><code>Required</code> if destination type is <code>bank_account</code></td>\n</tr>\n<tr>\n<td>destination.mobile_money</td>\n<td>object</td>\n<td><code>Required</code> if destination type is <code>mobile_money</code></td>\n</tr>\n<tr>\n<td>destination.supporting_documents</td>\n<td>array</td>\n<td><code>Required</code> if destination currency is <code>USD</code></td>\n</tr>\n<tr>\n<td>destination.purpose_of_payment</td>\n<td>string</td>\n<td><code>Optional</code> Used with <code>USD</code>, <code>GBP</code> <code>Non African Currencies</code>. See docs for list of payment purposes at <strong>Miscellaneous/List Payout Payment Purposes</strong> on the postman documentation</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"bank-account-non-usdgbp-currencies\">Bank Account (Non-USD/GBP Currencies)</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>destination.bank_account.bank</td>\n<td>string</td>\n<td><code>Required</code> — recipient bank code. Use <code>044</code>, <code>033</code>, or <code>058</code> (Access, UBA, GTCO respectively) to simulate successful test transactions.</td>\n</tr>\n<tr>\n<td>destination.bank_account.account</td>\n<td>string</td>\n<td><code>Required</code> — recipient account number</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"bank-account-usd-or-gbp\">Bank Account (USD or GBP)</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>destination.bank_account.account_name</td>\n<td>string</td>\n<td><code>Required</code></td>\n</tr>\n<tr>\n<td>destination.bank_account.bank_name</td>\n<td>string</td>\n<td><code>Required</code></td>\n</tr>\n<tr>\n<td>destination.bank_account.beneficiary_type</td>\n<td>string</td>\n<td><code>Required</code> — can be <code>individual</code> or <code>corporate</code></td>\n</tr>\n<tr>\n<td>destination.bank_account.first_name</td>\n<td>string</td>\n<td><code>Required</code> if <code>beneficiary_type</code> is <code>individual</code></td>\n</tr>\n<tr>\n<td>destination.bank_account.last_name</td>\n<td>string</td>\n<td><code>Required</code> if <code>beneficiary_type</code> is <code>individual</code></td>\n</tr>\n<tr>\n<td>destination.bank_account.business_name</td>\n<td>string</td>\n<td><code>Required</code> if <code>beneficiary_type</code> is <code>corporate</code></td>\n</tr>\n<tr>\n<td>destination.bank_account.account_type</td>\n<td>string</td>\n<td><code>Required</code> — can be <code>savings</code> or <code>checking</code></td>\n</tr>\n<tr>\n<td>destination.bank_account.account_number_type</td>\n<td>string</td>\n<td><code>Required</code> — can be <code>account_number</code> or <code>iban</code></td>\n</tr>\n<tr>\n<td>destination.bank_account.payment_method</td>\n<td>string</td>\n<td><code>Required</code> — for <strong>USD:</strong> <code>AbaRouting</code> (Local) or <code>BicSwift</code> (International); for <strong>GBP:</strong> <code>Faster payments service</code> (Local) or <code>BIC/Swift</code> (International)</td>\n</tr>\n<tr>\n<td>destination.bank_account.routing_number</td>\n<td>string</td>\n<td><code>Required</code> — for <strong>USD:</strong> routing number (Local) or Swift code (International); for <strong>GBP:</strong> sort code (Local) or Swift code (International)</td>\n</tr>\n<tr>\n<td>destination.bank_account.intermediary_routing_number</td>\n<td>string</td>\n<td><code>Required</code> if <code>payment_method</code> is <code>BicSwift</code></td>\n</tr>\n<tr>\n<td>destination.bank_account.address_information</td>\n<td>object</td>\n<td><code>Required</code> — full address information</td>\n</tr>\n<tr>\n<td>destination.bank_country</td>\n<td>string</td>\n<td><code>Required</code> — The country of the destination bank, see docs for list of all supported destination bank country at <strong>Miscellaneous/List Payout Bank Country</strong> on the postman documentation</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"destinationbank_accountaddress_information\">destination.bank_account.address_information</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>destination.bank_account.address_information.country</td>\n<td>string</td>\n<td><code>Required</code></td>\n</tr>\n<tr>\n<td>destination.bank_account.address_information.state</td>\n<td>string</td>\n<td><code>Required</code></td>\n</tr>\n<tr>\n<td>destination.bank_account.address_information.city</td>\n<td>string</td>\n<td><code>Required</code></td>\n</tr>\n<tr>\n<td>destination.bank_account.address_information.zip_code</td>\n<td>string</td>\n<td><code>Required</code></td>\n</tr>\n<tr>\n<td>destination.bank_account.address_information.street</td>\n<td>string</td>\n<td><code>Required</code></td>\n</tr>\n<tr>\n<td>destination.bank_account.address_information.full_address</td>\n<td>string</td>\n<td><code>Required</code></td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"mobile-money-if-destinationtype--mobile_money\">Mobile Money (If destination.type = mobile_money)</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>destination.mobile_money.operator</td>\n<td>string</td>\n<td><code>Required</code> — mobile money operator slug (e.g. <code>safaricom-ke</code>)</td>\n</tr>\n<tr>\n<td>destination.mobile_money.mobile_number</td>\n<td>string</td>\n<td><code>Required</code> — mobile number linked to the mobile money account</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"metadata-optional\">Metadata (Optional)</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>metadata</td>\n<td>object</td>\n<td><code>Optional</code> — JSON object with a maximum of <strong>5 fields</strong>. Field names ≤ 20 characters, allowed characters: A–Z, a–z, 0–9, <code>-</code>. Empty objects are not allowed.</td>\n</tr>\n</tbody>\n</table>\n</div><h3 id=\"supporting-document-required-if-destinationcurrency--usd\">Supporting Document (Required if destination.currency = USD)</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>title</td>\n<td>string</td>\n<td>Name of the document, <em>e.g Invoice</em></td>\n</tr>\n<tr>\n<td>file_reference</td>\n<td>string</td>\n<td>File reference gotten from uploading the document. <a href=\"https://docs.korapay.com/#7b363689-d976-417b-bb45-88266056f1a7\">Click here!</a></td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"successful-response-body\">Successful Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>request status message</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>object containing transaction details:amount, fee, narration, currency, status, reference, customer</td>\n</tr>\n<tr>\n<td>amount</td>\n<td>string</td>\n<td>transaction amount</td>\n</tr>\n<tr>\n<td>fee</td>\n<td>string</td>\n<td>transaction fee</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>string</td>\n<td>transaction currency</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>transaction status. Note that this would be <code>processing</code> upon initiating the transfer and eventually updated to <code>success</code> or <code>failed</code> once we process the transfer</td>\n</tr>\n<tr>\n<td>reference</td>\n<td>string</td>\n<td>transaction reference</td>\n</tr>\n<tr>\n<td>narration</td>\n<td>string</td>\n<td>transaction narration</td>\n</tr>\n<tr>\n<td>customer</td>\n<td>object</td>\n<td>object containing name, email and phone</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","transactions","disburse"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"2fe15288-c6a7-4b23-95f0-77a47514d230","name":"Single USD Payout to Bank Account - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"your-unique-transaction-reference-001\",\n    \"destination\": {\n        \"bank_account\": {\n            \"bank_country\": \"US\",\n            \"bank_name\": \"JP Morgan\",\n            \"account\": \"12345678\",\n            \"account_name\": \"Bella Taylor\",\n            \"beneficiary_type\": \"individual\",\n            \"first_name\": \"Bella\",\n            \"last_name\": \"Taylor\",\n            \"business_name\": \"Business Name\",\n            \"account_number_type\": \"account_number\",\n            \"payment_method\": \"AbaRouting\",\n            \"routing_number\": \"067014822\",\n            \"address_information\": {\n                \"country\": \"US\",\n                \"city\": \"city\",\n                \"state\": \"state\",\n                \"zip_code\": \"123456\",\n                \"street\": \"street\",\n                \"full_address\": \"street, city, state, 123456, US\"\n            }\n        },\n        \"type\": \"bank_account\",\n        \"amount\": 10,\n        \"currency\": \"USD\",\n        \"narration\": \"Payout\",\n        \"customer\": {\n            \"name\": \"Bella Taylor\",\n            \"email\": \"bellataylor@gmail.com\"\n        },\n        \"supporting_documents\": [\n            {\n                \"title\": \"payout supporting document\",\n                \"file_reference\": \"test-ref-01\"\n            }\n        ],\n        \"purpose_of_payment\": \"Charity\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"transfer initiated successfully\",\n    \"data\": {\n        \"amount\": \"10\",\n        \"fee\": \"2.50\",\n        \"currency\": \"USD\",\n        \"status\": \"processing\",\n        \"reference\": \"your-unique-transaction-reference-001\",\n        \"narration\": \"Payout\",\n        \"customer\": {\n            \"name\": \"Bella Taylor\",\n            \"email\": \"bellataylor@gmail.com\",\n            \"phone\": null\n        }\n    }\n}"},{"id":"6e6f5309-b42c-4338-910c-d14473149388","name":"Single GBP Payout to Bank Account - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"your-unique-transaction-reference-001\",\n    \"destination\": {\n        \"bank_account\": {\n            \"bank_country\": \"GB\",\n            \"bank_name\": \"ABN AMRO BANK\",\n            \"account\": \"12345678\",\n            \"account_name\": \"Bella Taylor\",\n            \"beneficiary_type\": \"individual\",\n            \"first_name\": \"Bella\",\n            \"last_name\": \"Taylor\",\n            \"business_name\": \"Business Name\",\n            \"account_number_type\": \"account_number\",\n            \"payment_method\": \"SortCode\",\n            \"routing_number\": \"067014822\",\n            \"address_information\": {\n                \"country\": \"GB\",\n                \"city\": \"city\",\n                \"state\": \"state\",\n                \"zip_code\": \"123456\",\n                \"street\": \"street\",\n                \"full_address\": \"street, city, state, 123456, GB\"\n            }\n        },\n        \"type\": \"bank_account\",\n        \"amount\": 10,\n        \"currency\": \"GBP\",\n        \"narration\": \"Payout\",\n        \"customer\": {\n            \"name\": \"Bella Taylor\",\n            \"email\": \"bellataylor@gmail.com\"\n        },\n        \"supporting_documents\": [\n            {\n                \"title\": \"payout supporting document\",\n                \"file_reference\": \"test-ref-01\"\n            }\n        ],\n        \"purpose_of_payment\": \"Charity\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"transfer initiated successfully\",\n    \"data\": {\n        \"amount\": \"10\",\n        \"fee\": \"2.50\",\n        \"currency\": \"USD\",\n        \"status\": \"processing\",\n        \"reference\": \"your-unique-transaction-reference-001\",\n        \"narration\": \"Payout\",\n        \"customer\": {\n            \"name\": \"Bella Taylor\",\n            \"email\": \"bellataylor@gmail.com\",\n            \"phone\": null\n        }\n    }\n}"},{"id":"d7bd1b83-cc9d-41e1-8c4d-a909c6b3ed7e","name":"Single Payout to Bank Account - Success","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"reference\": \"your-unique-transaction-reference-001\",\n\t\"destination\": {\n\t\t\"type\": \"bank_account\",\n\t\t\"amount\": \"100\",\n\t\t\"currency\": \"NGN\",\n\t\t\"narration\": \"Test Transfer Payment\",\n\t\t\"bank_account\": {\n\t\t\t\"bank\": \"033\",\n\t\t\t\"account\": \"0000000000\"\n\t\t},\n\t\t\"customer\": {\n\t\t\t\"name\": \"John Doe\",\n\t\t\t\"email\": \"johndoe@email.com\"\n\t\t}\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"transfer initiated successfully\",\n    \"data\": {\n        \"amount\": \"100.00\",\n        \"fee\": \"2.50\",\n        \"currency\": \"NGN\",\n        \"status\": \"processing\",\n        \"reference\": \"your-unique-transaction-reference-001\",\n        \"narration\": \"Test Transfer Payment\",\n        \"customer\": {\n            \"name\": \"John Doe\",\n            \"email\": \"johndoe@email.com\",\n            \"phone\": null\n        }\n    }\n}"},{"id":"0cb2b01b-b6fb-4eab-9179-594fcd195502","name":"Single Payout to Bank Account - Insufficient Funds","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"reference\": \"your-unique-transaction-reference-001\",\n\t\"destination\": {\n\t\t\"type\": \"bank_account\",\n\t\t\"amount\": \"100\",\n\t\t\"currency\": \"NGN\",\n\t\t\"narration\": \"Test Transfer Payment\",\n\t\t\"bank_account\": {\n\t\t\t\"bank\": \"033\",\n\t\t\t\"account\": \"0000000000\"\n\t\t},\n\t\t\"customer\": {\n\t\t\t\"name\": \"john doe\",\n\t\t\t\"email\": \"johndoe@email.com\"\n\t\t}\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Insufficient funds in disbursement wallet\",\n    \"data\": null\n}"},{"id":"8a9a781f-08b0-45c9-a00e-a15e3c91e74f","name":"Single Payout to Bank Account - Bank not Found","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"reference\": \"your-unique-transaction-reference-001\",\n\t\"destination\": {\n\t\t\"type\": \"bank_account\",\n\t\t\"amount\": \"100\",\n\t\t\"currency\": \"NGN\",\n\t\t\"narration\": \"Test Transfer Payment\",\n\t\t\"bank_account\": {\n\t\t\t\"bank\": \"033\",\n\t\t\t\"account\": \"0000000000\"\n\t\t},\n\t\t\"customer\": {\n\t\t\t\"name\": \"john doe\",\n\t\t\t\"email\": \"johndoe@email.com\"\n\t\t}\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"bank not found\",\n    \"data\": null\n}"},{"id":"34a80290-53ec-477c-a844-b8bfa43552dc","name":"Single Payout to Bank Account - Request Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"your-unique-transaction-reference-001\",\n    \"destination\": {\n        \"type\": \"bank_account\",\n        \"amount\": \"100\",\n        \"currency\": \"NGN\",\n        \"narration\": \"Test Transfer Payment\",\n        \"bank_account\": {\n            \"bank\": \"033\",\n            \"account\": \"0000000000\"\n        },\n        \"customer\": {\n            \"name\": \"John Doe\",\n            \"email\": \"johndoe@email.com\"\n        }\n    }\n}\n","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"bad_request\",\n    \"message\": \"invalid request data\",\n    \"data\": {\n        \"amount\": {\n            \"message\": \"reference is required\",\n            \"customErrorMessage\": \"reference is required\"\n        }\n    }\n}"}],"_postman_id":"9e0b5372-ba48-49f6-ae90-c5d66903bed0"},{"name":"Single Payout to Mobile Money","event":[{"listen":"prerequest","script":{"id":"4a42ccf0-5cdc-4611-9418-cadc47b9ff92","exec":[""],"type":"text/javascript"}}],"id":"9ce5bc96-cd9b-4431-97eb-86e7f6bbeed5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"your-unique-transaction-reference-002\",\n\t\"destination\": {\n\t\t\"type\": \"mobile_money\",\n\t\t\"amount\": \"100\",\n\t\t\"currency\": \"KES\",\n\t\t\"narration\": \"Test Transfer Payment 008\",\n\t\t\"mobile_money\": {\n\t\t\t\"operator\": \"safaricom-ke\",\n            \"mobile_number\": \"256700000000\"\n\t\t},\n\t\t\"customer\": {\n\t\t\t\"name\": \"John Doe\",\n\t\t\t\"email\": \"johndoe@email.com\"\n\t\t}\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse","description":"<p>This endpoint is used to initiate single disbursement to mobile money.</p>\n<h2 id=\"request-body\">Request Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>reference</td>\n<td>string</td>\n<td><code>Required</code> unique transaction reference</td>\n</tr>\n<tr>\n<td>destination</td>\n<td>object</td>\n<td><code>Required</code></td>\n</tr>\n<tr>\n<td>destination.type</td>\n<td>string</td>\n<td><code>Required</code> This should be <code>mobile_money</code></td>\n</tr>\n<tr>\n<td>destination.amount</td>\n<td>number</td>\n<td><code>Required</code> transaction amount</td>\n</tr>\n<tr>\n<td>destination.currency</td>\n<td>string</td>\n<td><code>Required</code> transaction currency e.g. KES, GHS</td>\n</tr>\n<tr>\n<td>destination.narration</td>\n<td>string</td>\n<td><code>Optional</code> transaction narration or description</td>\n</tr>\n<tr>\n<td>destination.mobile_money</td>\n<td>object</td>\n<td><code>Required</code> if destination type is <code>mobile_money</code></td>\n</tr>\n<tr>\n<td>destination.mobile_money.operator</td>\n<td>string</td>\n<td><code>Required</code> the recipient's mobile money operator</td>\n</tr>\n<tr>\n<td>destination.mobile_money.mobile_number</td>\n<td>string</td>\n<td><code>Required</code> recipient mobile money number</td>\n</tr>\n<tr>\n<td>destination.customer</td>\n<td>object</td>\n<td><code>Required</code></td>\n</tr>\n<tr>\n<td>destination.customer.name</td>\n<td>string</td>\n<td><code>Optional</code> Customer Name</td>\n</tr>\n<tr>\n<td>destination.customer.email</td>\n<td>string</td>\n<td><code>Required</code> Customer Email</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"successful-response-body\">Successful Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>request status message</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>object containing transaction details: amount, fee, narration, currency, status, reference, customer</td>\n</tr>\n<tr>\n<td>amount</td>\n<td>string</td>\n<td>transaction amount</td>\n</tr>\n<tr>\n<td>fee</td>\n<td>string</td>\n<td>transaction fee</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>string</td>\n<td>transaction currency</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>transaction status.  <br />Note that this would be <code>processing</code> upon initiating the transfer and eventually updated to <code>success</code> or <code>failed</code> once we complete the transfer</td>\n</tr>\n<tr>\n<td>reference</td>\n<td>string</td>\n<td>transaction reference</td>\n</tr>\n<tr>\n<td>narration</td>\n<td>string</td>\n<td>transaction narration</td>\n</tr>\n<tr>\n<td>customer</td>\n<td>object</td>\n<td>an object containing name and email</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","transactions","disburse"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"65c73094-3444-45cd-a4f1-7f582d2468c4","name":"Single Payout to Mobile Money - Initiated Successfully","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"reference\": \"your-unique-transaction-reference-002\",\n\t\"destination\": {\n\t\t\"type\": \"mobile_money\",\n\t\t\"amount\": \"100\",\n\t\t\"currency\": \"KES\",\n\t\t\"narration\": \"Test Transfer Payment\",\n\t\t\"mobile_money\": {\n\t\t\t\"operator\": \"safaricom-ke\",\n            \"mobile_number\": \"256700000000\"\n\t\t},\n\t\t\"customer\": {\n\t\t\t\"name\": \"John Doe\",\n\t\t\t\"email\": \"johndoe@email.com\"\n\t\t}\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"transfer initiated successfully\",\n    \"data\": {\n        \"amount\": \"100.00\",\n        \"fee\": \"2.50\",\n        \"currency\": \"KES\",\n        \"status\": \"processing\",\n        \"reference\": \"your-unique-transaction-reference-001\",\n        \"narration\": \"Test Transfer Payment\",\n        \"customer\": {\n            \"name\": \"John Doe\",\n            \"email\": \"johndoe@email.com\",\n            \"phone\": null\n        }\n    }\n}"},{"id":"bff594e1-0ca0-4c5a-891d-b351d5d86113","name":"Single Payout to Mobile Money - Insufficient Funds","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"reference\": \"your-unique-transaction-reference-002\",\n\t\"destination\": {\n\t\t\"type\": \"mobile_money\",\n\t\t\"amount\": \"100\",\n\t\t\"currency\": \"KES\",\n\t\t\"narration\": \"Test Transfer Payment\",\n\t\t\"mobile_money\": {\n\t\t\t\"operator\": \"safaricom-ke\",\n            \"mobile_number\": \"256700000000\"\n\t\t},\n\t\t\"customer\": {\n\t\t\t\"name\": \"john doe\",\n\t\t\t\"email\": \"johndoe@email.com\"\n\t\t}\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Insufficient funds in disbursement wallet\",\n    \"data\": null\n}"},{"id":"f42a439a-556a-4a6d-8829-60e0480a04bf","name":"Single Payout to Mobile Money - Mobile Money Account not Found","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"reference\": \"your-unique-transaction-reference-002\",\n\t\"destination\": {\n\t\t\"type\": \"mobile_money\",\n\t\t\"amount\": \"100\",\n\t\t\"currency\": \"KES\",\n\t\t\"narration\": \"Test Transfer Payment\",\n\t\t\"mobile_money\": {\n\t\t\t\"operator\": \"safaricom-ke\",\n            \"mobile_number\": \"256700000000\"\n\t\t},\n\t\t\"customer\": {\n\t\t\t\"name\": \"john doe\",\n\t\t\t\"email\": \"johndoe@email.com\"\n\t\t}\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Mobile money operator is not available for this currency or does not exist\",\n    \"data\": null\n}"},{"id":"9b48978e-f696-435b-8058-2d9950124248","name":"Single Payout to Mobile Money - Request Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n\t\"destination\": {\n\t\t\"type\": \"mobile_money\",\n\t\t\"amount\": \"100\",\n\t\t\"currency\": \"KES\",\n\t\t\"narration\": \"Test Transfer Payment 008\",\n\t\t\"mobile_money\": {\n\t\t\t\"operator\": \"safaricom-ke\",\n            \"mobile_number\": \"256700000000\"\n\t\t},\n\t\t\"customer\": {\n\t\t\t\"name\": \"John Doe\",\n\t\t\t\"email\": \"johndoe@email.com\"\n\t\t}\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"bad_request\",\n    \"message\": \"invalid request data\",\n    \"data\": {\n        \"amount\": {\n            \"message\": \"reference is required\",\n            \"customErrorMessage\": \"reference is required\"\n        }\n    }\n}"}],"_postman_id":"9ce5bc96-cd9b-4431-97eb-86e7f6bbeed5"},{"name":"Single Payout to Crypto","id":"d3dbcc70-f60d-4a5d-b36d-ad2129a884b3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"your-unique-transaction-reference-003\",\n\t\"destination\": {\n\t\t\"type\": \"crypto\",\n\t\t\"amount\": \"100\",\n\t\t\"currency\": \"USDT\",\n\t\t\"narration\": \"Test Transfer Payment 008\",\n\t\t\"crypto\": {\n            \"network\": \"ETH\",\n            \"destination_address\": \"0x6f730bd13c38966b44f3c6a06955085b1485e39c\"\n        },\n\t\t\"customer\": {\n\t\t\t\"name\": \"John Doe\",\n\t\t\t\"email\": \"johndoe@email.com\"\n\t\t}\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse","description":"<p>This endpoint is used to initiate single disbursement to crypto.</p>\n<h2 id=\"request-body\">Request Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>reference</td>\n<td>string</td>\n<td><code>Required</code> unique transaction reference</td>\n</tr>\n<tr>\n<td>destination</td>\n<td>object</td>\n<td><code>Required</code></td>\n</tr>\n<tr>\n<td>destination.type</td>\n<td>string</td>\n<td><code>Required</code> This should be <code>crypto</code></td>\n</tr>\n<tr>\n<td>destination.amount</td>\n<td>number</td>\n<td><code>Required</code> transaction amount</td>\n</tr>\n<tr>\n<td>destination.currency</td>\n<td>string</td>\n<td><code>Required</code> transaction currency e.g. USDT, USDC</td>\n</tr>\n<tr>\n<td>destination.narration</td>\n<td>string</td>\n<td><code>Optional</code> transaction narration or description</td>\n</tr>\n<tr>\n<td>destination.crypto</td>\n<td>object</td>\n<td><code>Required</code> if destination type is <code>crypto</code></td>\n</tr>\n<tr>\n<td>destination.crypto.network</td>\n<td>string</td>\n<td><code>Required</code> the recipient's crypto network code</td>\n</tr>\n<tr>\n<td>destination.crypto.destination_address</td>\n<td>string</td>\n<td><code>Required</code> recipient crypto wallet address</td>\n</tr>\n<tr>\n<td>destination.customer</td>\n<td>object</td>\n<td><code>Required</code></td>\n</tr>\n<tr>\n<td>destination.customer.name</td>\n<td>string</td>\n<td><code>Optional</code> Customer Name</td>\n</tr>\n<tr>\n<td>destination.customer.email</td>\n<td>string</td>\n<td><code>Required</code> Customer Email</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"successful-response-body\">Successful Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>request status message</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>object containing transaction details: amount, fee, narration, currency, status, reference, customer</td>\n</tr>\n<tr>\n<td>amount</td>\n<td>string</td>\n<td>transaction amount</td>\n</tr>\n<tr>\n<td>fee</td>\n<td>string</td>\n<td>transaction fee</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>string</td>\n<td>transaction currency</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>transaction status.  <br />Note that this would be <code>processing</code> upon initiating the transfer and eventually updated to <code>success</code> or <code>failed</code> once we complete the transfer</td>\n</tr>\n<tr>\n<td>reference</td>\n<td>string</td>\n<td>transaction reference</td>\n</tr>\n<tr>\n<td>narration</td>\n<td>string</td>\n<td>transaction narration</td>\n</tr>\n<tr>\n<td>customer</td>\n<td>object</td>\n<td>an object containing name and email</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","transactions","disburse"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"d707386e-307f-4a45-8f40-c4389b73f4ab","name":"Single Payout to Crypto - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"your-unique-transaction-reference-003\",\n\t\"destination\": {\n\t\t\"type\": \"crypto\",\n\t\t\"amount\": \"100\",\n\t\t\"currency\": \"USDT\",\n\t\t\"narration\": \"Test Transfer Payment 009\",\n\t\t\"crypto\": {\n            \"network\": \"ETH\",\n            \"destination_address\": \"0x6f730bd13c38966b44f3c6a06955085b1485e39c\"\n        },\n\t\t\"customer\": {\n\t\t\t\"name\": \"John Doe\",\n\t\t\t\"email\": \"johndoe@email.com\"\n\t\t}\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"transfer initiated successfully\",\n    \"data\": {\n        \"amount\": \"100.00\",\n        \"fee\": \"2.50\",\n        \"currency\": \"USDT\",\n        \"status\": \"processing\",\n        \"reference\": \"your-unique-transaction-reference-003\",\n        \"narration\": \"Test Transfer Payment 009\",\n        \"customer\": {\n            \"name\": \"John Doe\",\n            \"email\": \"johndoe@email.com\",\n            \"phone\": null\n        }\n    }\n}"},{"id":"ca1de95d-81af-47a1-b90b-4fa742a4cd86","name":"Single Payout to Crypto - Insufficient Funds","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"your-unique-transaction-reference-003\",\n\t\"destination\": {\n\t\t\"type\": \"crypto\",\n\t\t\"amount\": \"100\",\n\t\t\"currency\": \"USDT\",\n\t\t\"narration\": \"Test Transfer Payment 008\",\n\t\t\"crypto\": {\n            \"network\": \"ETH\",\n            \"destination_address\": \"0x6f730bd13c38966b44f3c6a06955085b1485e39c\"\n        },\n\t\t\"customer\": {\n\t\t\t\"name\": \"John Doe\",\n\t\t\t\"email\": \"johndoe@email.com\"\n\t\t}\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Insufficient funds in disbursement wallet\",\n    \"data\": null\n}"},{"id":"edce2a5d-2177-4544-b053-4a06aac3696f","name":"Single Payout to Crypto - Request Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n\t\"destination\": {\n\t\t\"type\": \"crypto\",\n\t\t\"amount\": \"100\",\n\t\t\"currency\": \"USDT\",\n\t\t\"narration\": \"Test Transfer Payment 008\",\n\t\t\"crypto\": {\n            \"network\": \"ETH\",\n            \"destination_address\": \"0x6f730bd13c38966b44f3c6a06955085b1485e39c\"\n        },\n\t\t\"customer\": {\n\t\t\t\"name\": \"John Doe\",\n\t\t\t\"email\": \"johndoe@email.com\"\n\t\t}\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"bad_request\",\n    \"message\": \"invalid request data\",\n    \"data\": {\n        \"amount\": {\n            \"message\": \"reference is required\",\n            \"customErrorMessage\": \"reference is required\"\n        }\n    }\n}"},{"id":"cb24f9ac-9de5-4d7f-a4e1-d97a33723453","name":"Single Payout to Crypto - Crypto Network Not Found","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"your-unique-transaction-reference-003\",\n\t\"destination\": {\n\t\t\"type\": \"crypto\",\n\t\t\"amount\": \"100\",\n\t\t\"currency\": \"USDT\",\n\t\t\"narration\": \"Test Transfer Payment 008\",\n\t\t\"crypto\": {\n            \"network\": \"ETH\",\n            \"destination_address\": \"0x6f730bd13c38966b44f3c6a06955085b1485e39c\"\n        },\n\t\t\"customer\": {\n\t\t\t\"name\": \"John Doe\",\n\t\t\t\"email\": \"johndoe@email.com\"\n\t\t}\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Crypto network is not available\",\n    \"data\": null\n}"},{"id":"b5a6f749-96aa-45c7-a432-dd0ea96d1cc3","name":"Single Payout to Crypto - Beneficiary Wallet Address Not Found","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"your-unique-transaction-reference-003\",\n\t\"destination\": {\n\t\t\"type\": \"crypto\",\n\t\t\"amount\": \"100\",\n\t\t\"currency\": \"USDT\",\n\t\t\"narration\": \"Test Transfer Payment 008\",\n\t\t\"crypto\": {\n            \"network\": \"ETH\",\n            \"destination_address\": \"0x6f730bd13c38966b44f3c6a06955085b1485e39c\"\n        },\n\t\t\"customer\": {\n\t\t\t\"name\": \"John Doe\",\n\t\t\t\"email\": \"johndoe@email.com\"\n\t\t}\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Beneficiary does not exist or is invalid\",\n    \"data\": null\n}"}],"_postman_id":"d3dbcc70-f60d-4a5d-b36d-ad2129a884b3"}],"id":"137a8214-f650-4d66-9c97-770058c11a99","_postman_id":"137a8214-f650-4d66-9c97-770058c11a99","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":true,"source":{"_postman_id":"34814774-3f6c-4608-b0a4-21c3f3560c77","id":"34814774-3f6c-4608-b0a4-21c3f3560c77","name":"Payouts","type":"folder"}}},{"name":"Single Remittance Payout","item":[{"name":"Single Remittance Payout to Bank Account","id":"fa30a74b-1d5f-4583-98d7-8893a13bc4e8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"your-unique-transaction-reference-001\",\n    \"destination\": {\n        \"type\": \"bank_account\",\n        \"amount\": 100,\n        \"currency\": \"NGN\",\n        \"narration\": \"Test Transfer Payment\",\n        \"bank_account\": {\n            \"bank\": \"033\",\n            \"account\": \"0000000000\"\n        },\n        \"customer\": {\n            \"name\": \"John Doe\",\n            \"email\": \"johndoe@email.com\"\n        }\n    },\n    \"remittance_data\": {\n        \"sender_name\": \"Jeremiah Doe\",\n        \"sender_phone_number\": \"086778899010\",\n        \"sender_dob\": \"1990-05-15\",\n        \"sender_country_iso\": \"NG\",\n        \"sender_nationality\": \"Nigerian\",\n        \"sender_id_type\": \"Passport\",\n        \"sender_id_number\": \"A12345678\",\n        \"sender_service_provider_name\": \"ABC Bank\",\n        \"remittance_purpose\": \"Family Support\",\n        \"sender_recipient_relationship\": \"Brother\",\n        \"source_of_funds\": \"Salary\",\n        \"sender_occupation\": \"Software Engineer\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse/remittance","description":"<p>This endpoint is used to initiate a single disbursement to bank account.</p>\n<h2 id=\"request-body\">Request Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>reference</td>\n<td>string</td>\n<td><code>Required</code> unique transaction reference</td>\n</tr>\n<tr>\n<td>destination</td>\n<td>object</td>\n<td><code>Required</code></td>\n</tr>\n<tr>\n<td>destination.type</td>\n<td>string</td>\n<td><code>Required</code> can be bank_account</td>\n</tr>\n<tr>\n<td>destination.amount</td>\n<td>number</td>\n<td><code>Required</code> transaction amount</td>\n</tr>\n<tr>\n<td>destination.currency</td>\n<td>string</td>\n<td><code>Required</code> transaction amount currency e.g. NGN</td>\n</tr>\n<tr>\n<td>destination.narration</td>\n<td>string</td>\n<td><code>Optional</code> transaction narration or description</td>\n</tr>\n<tr>\n<td>destination.bank_account</td>\n<td>object</td>\n<td><code>Required</code> if destination type is <code>bank_account</code></td>\n</tr>\n<tr>\n<td>destination.bank_account.bank</td>\n<td>string</td>\n<td><code>Required</code> recipient bank code. Bank_codes on testmode with Test keys to simulate a successful transaction are <code>044</code>, <code>033</code>, <code>058</code> i.e. Access, UBA and GTB respectively other banks would simulate a failed transaction on testmode with testkeys</td>\n</tr>\n<tr>\n<td>destination.bank_account.account</td>\n<td>string</td>\n<td><code>Required</code> recipient account number</td>\n</tr>\n<tr>\n<td>destination.customer</td>\n<td>object</td>\n<td><code>Required</code></td>\n</tr>\n<tr>\n<td>destination.customer.name</td>\n<td>string</td>\n<td><code>Optional</code> Customer Name</td>\n</tr>\n<tr>\n<td>destination.customer.email</td>\n<td>string</td>\n<td><code>Required</code> Customer Email</td>\n</tr>\n<tr>\n<td>remittance_data</td>\n<td>object</td>\n<td><code>Required</code></td>\n</tr>\n<tr>\n<td>remittance_data.sender_name</td>\n<td>string</td>\n<td><code>Required</code> full name of the sender</td>\n</tr>\n<tr>\n<td>remittance_data.sender_phone_number</td>\n<td>string</td>\n<td><code>Optional</code> phone number of the sender</td>\n</tr>\n<tr>\n<td>remittance_data.sender_dob</td>\n<td>string</td>\n<td><code>Optional</code> date of birth of the sender, e.g. <code>1990-05-15</code></td>\n</tr>\n<tr>\n<td>remittance_data.sender_country_iso</td>\n<td>string</td>\n<td><code>Optional</code> 2-digit Country ISO code of sender, e.g. <code>NG</code></td>\n</tr>\n<tr>\n<td>remittance_data.sender_nationality</td>\n<td>string</td>\n<td><code>Optional</code> nationality of the sender, e.g. <code>Nigerian</code></td>\n</tr>\n<tr>\n<td>remittance_data.sender_id_type</td>\n<td>string</td>\n<td><code>Optional</code> identification type of the sender, e.g. <code>Passport</code></td>\n</tr>\n<tr>\n<td>remittance_data.sender_id_number</td>\n<td>string</td>\n<td><code>Optional</code> identification type number of the sender, e.g. <code>A12345678</code></td>\n</tr>\n<tr>\n<td>remittance_data.sender_service_provider_name</td>\n<td>string</td>\n<td><code>Optional</code> name of the provider, e.g. <code>ABC Bank</code></td>\n</tr>\n<tr>\n<td>remittance_data.remittance_purpose</td>\n<td>string</td>\n<td><code>Optional</code> purpose of the remittance, e.g. <code>Family Support</code></td>\n</tr>\n<tr>\n<td>remittance_data.sender_recipient_relationship</td>\n<td>string</td>\n<td><code>Optional</code> relationship the sender has with the recipient, e.g. <code>Brother</code></td>\n</tr>\n<tr>\n<td>remittance_data.sender_occupation</td>\n<td>string</td>\n<td><code>Optional</code> occupation of the sender, e.g. <code>Software Engineer</code></td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"successful-response-body\">Successful Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>request status message</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>object containing transaction details:amount, fee, narration, currency, status, reference, customer</td>\n</tr>\n<tr>\n<td>amount</td>\n<td>string</td>\n<td>transaction amount</td>\n</tr>\n<tr>\n<td>fee</td>\n<td>string</td>\n<td>transaction fee</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>string</td>\n<td>transaction currency</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>transaction status. Note that this would be <code>processing</code> upon initiating the transfer and eventually updated to <code>success</code> or <code>failed</code> once we process the transfer</td>\n</tr>\n<tr>\n<td>reference</td>\n<td>string</td>\n<td>transaction reference</td>\n</tr>\n<tr>\n<td>narration</td>\n<td>string</td>\n<td>transaction narration</td>\n</tr>\n<tr>\n<td>customer</td>\n<td>object</td>\n<td>object containing name, email and phone</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","transactions","disburse","remittance"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"4632793f-6d06-495e-833f-d901babf1a3f","name":"Single Remittance Payout to Bank Account - Success","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n    \"reference\": \"your-unique-transaction-reference-001\",\n    \"destination\": {\n        \"type\": \"bank_account\",\n        \"amount\": 100,\n        \"currency\": \"NGN\",\n        \"narration\": \"Test Transfer Payment\",\n        \"bank_account\": {\n            \"bank\": \"033\",\n            \"account\": \"0000000000\"\n        },\n        \"customer\": {\n            \"name\": \"John Doe\",\n            \"email\": \"johndoe@email.com\"\n        }\n    },\n    \"remittance_data\": {\n        \"sender_name\": \"Jeremiah Doe\",\n        \"sender_phone_number\": \"086778899010\",\n        \"sender_dob\": \"1990-05-15\",\n        \"sender_country_iso\": \"NG\",\n        \"sender_nationality\": \"Nigerian\",\n        \"sender_id_type\": \"Passport\",\n        \"sender_id_number\": \"A12345678\",\n        \"sender_service_provider_name\": \"ABC Bank\",\n        \"remittance_purpose\": \"Family Support\",\n        \"sender_recipient_relationship\": \"Brother\",\n        \"source_of_funds\": \"Salary\",\n        \"sender_occupation\": \"Software Engineer\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse/remittance"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Remittance transfer initiated successfully\",\n    \"data\": {\n        \"amount\": \"100.00\",\n        \"fee\": \"2.50\",\n        \"currency\": \"NGN\",\n        \"status\": \"processing\",\n        \"reference\": \"your-unique-transaction-reference-001\",\n        \"narration\": \"Test Transfer Payment\",\n        \"customer\": {\n            \"name\": \"John Doe\",\n            \"email\": \"johndoe@email.com\",\n            \"phone\": null\n        }\n    }\n}"},{"id":"0b581c7f-6f1e-48df-bda3-eaab70847c43","name":"Single Remittance Payout to Bank Account - Insufficient Funds","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n    \"reference\": \"your-unique-transaction-reference-001\",\n    \"destination\": {\n        \"type\": \"bank_account\",\n        \"amount\": 100,\n        \"currency\": \"NGN\",\n        \"narration\": \"Test Transfer Payment\",\n        \"bank_account\": {\n            \"bank\": \"033\",\n            \"account\": \"0000000000\"\n        },\n        \"customer\": {\n            \"name\": \"John Doe\",\n            \"email\": \"johndoe@email.com\"\n        }\n    },\n    \"remittance_data\": {\n        \"sender_name\": \"Jeremiah Doe\",\n        \"sender_phone_number\": \"086778899010\",\n        \"sender_dob\": \"1990-05-15\",\n        \"sender_country_iso\": \"NG\",\n        \"sender_nationality\": \"Nigerian\",\n        \"sender_id_type\": \"Passport\",\n        \"sender_id_number\": \"A12345678\",\n        \"sender_service_provider_name\": \"ABC Bank\",\n        \"remittance_purpose\": \"Family Support\",\n        \"sender_recipient_relationship\": \"Brother\",\n        \"source_of_funds\": \"Salary\",\n        \"sender_occupation\": \"Software Engineer\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse/remittance"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Insufficient funds in disbursement wallet\",\n    \"data\": null\n}"},{"id":"35e3c027-3bb5-4f62-8626-54a7500d2595","name":"Single Remittance Payout to Bank Account - Bank not Found","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n    \"reference\": \"your-unique-transaction-reference-001\",\n    \"destination\": {\n        \"type\": \"bank_account\",\n        \"amount\": 100,\n        \"currency\": \"NGN\",\n        \"narration\": \"Test Transfer Payment\",\n        \"bank_account\": {\n            \"bank\": \"093\",\n            \"account\": \"0000000000\"\n        },\n        \"customer\": {\n            \"name\": \"John Doe\",\n            \"email\": \"johndoe@email.com\"\n        }\n    },\n    \"remittance_data\": {\n        \"sender_name\": \"Jeremiah Doe\",\n        \"sender_phone_number\": \"086778899010\",\n        \"sender_dob\": \"1990-05-15\",\n        \"sender_country_iso\": \"NG\",\n        \"sender_nationality\": \"Nigerian\",\n        \"sender_id_type\": \"Passport\",\n        \"sender_id_number\": \"A12345678\",\n        \"sender_service_provider_name\": \"ABC Bank\",\n        \"remittance_purpose\": \"Family Support\",\n        \"sender_recipient_relationship\": \"Brother\",\n        \"source_of_funds\": \"Salary\",\n        \"sender_occupation\": \"Software Engineer\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse/remittance"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"bank not found\",\n    \"data\": null\n}"},{"id":"980603b6-89cc-4377-95b3-fd37091568d2","name":"Single Remittance Payout to Bank Account - Request Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"destination\": {\n        \"type\": \"bank_account\",\n        \"amount\": 100,\n        \"currency\": \"NGN\",\n        \"narration\": \"Test Transfer Payment\",\n        \"bank_account\": {\n            \"bank\": \"033\",\n            \"account\": \"0000000000\"\n        },\n        \"customer\": {\n            \"name\": \"John Doe\",\n            \"email\": \"johndoe@email.com\"\n        }\n    },\n    \"remittance_data\": {\n        \"sender_name\": \"Jeremiah Doe\",\n        \"sender_phone_number\": \"086778899010\",\n        \"sender_dob\": \"1990-05-15\",\n        \"sender_country_iso\": \"NG\",\n        \"sender_nationality\": \"Nigerian\",\n        \"sender_id_type\": \"Passport\",\n        \"sender_id_number\": \"A12345678\",\n        \"sender_service_provider_name\": \"ABC Bank\",\n        \"remittance_purpose\": \"Family Support\",\n        \"sender_recipient_relationship\": \"Brother\",\n        \"source_of_funds\": \"Salary\",\n        \"sender_occupation\": \"Software Engineer\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse/remittance"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"bad_request\",\n    \"message\": \"invalid request data\",\n    \"data\": {\n        \"reference\": {\n            \"message\": \"reference is required\",\n            \"customErrorMessage\": \"reference is required\"\n        }\n    }\n}"},{"id":"f7f0588c-5c0e-4074-9d47-7bd2c30e1b20","name":"Single Remittance Payout to Bank Account - Request Validation Error Remittance Data","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"your-unique-transaction-reference-001\",\n    \"destination\": {\n        \"type\": \"bank_account\",\n        \"amount\": 100,\n        \"currency\": \"NGN\",\n        \"narration\": \"Test Transfer Payment\",\n        \"bank_account\": {\n            \"bank\": \"033\",\n            \"account\": \"0000000000\"\n        },\n        \"customer\": {\n            \"name\": \"John Doe\",\n            \"email\": \"johndoe@email.com\"\n        }\n    },\n    \"remittance_data\": {}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse/remittance"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"validation_error\",\n    \"message\": \"It seems there`s an issue with your input. Please correct it and try again.\",\n    \"data\": {\n        \"remittance_data.sender_name\": {\n            \"message\": \"remittance_data.sender_name is required\",\n            \"customErrorMessage\": \"remittance_data.sender_name is required\"\n        }\n    }\n}"}],"_postman_id":"fa30a74b-1d5f-4583-98d7-8893a13bc4e8"},{"name":"Single Remittance Payout to Mobile Money","id":"9fb5c907-5e93-451a-83d9-5d3a74fa6b7e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"your-unique-transaction-reference-002\",\n    \"destination\": {\n        \"type\": \"mobile_money\",\n        \"amount\": 100,\n        \"currency\": \"KES\",\n        \"narration\": \"Test Transfer Payment 008\",\n        \"mobile_money\": {\n            \"operator\": \"safaricom-ke\",\n            \"mobile_number\": \"256700000000\"\n        },\n        \"customer\": {\n            \"name\": \"John Doe\",\n            \"email\": \"johndoe@email.com\"\n        }\n    },\n    \"remittance_data\": {\n        \"sender_name\": \"Jeremiah Doe\",\n        \"sender_phone_number\": \"086778899010\",\n        \"sender_dob\": \"1990-05-15\",\n        \"sender_country_iso\": \"NG\",\n        \"sender_nationality\": \"Nigerian\",\n        \"sender_id_type\": \"Passport\",\n        \"sender_id_number\": \"A12345678\",\n        \"sender_service_provider_name\": \"ABC Bank\",\n        \"remittance_purpose\": \"Family Support\",\n        \"sender_recipient_relationship\": \"Brother\",\n        \"source_of_funds\": \"Salary\",\n        \"sender_occupation\": \"Software Engineer\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse/remittance","description":"<p>This endpoint is used to initiate single disbursement to mobile money.</p>\n<h2 id=\"request-body\">Request Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>reference</td>\n<td>string</td>\n<td><code>Required</code> unique transaction reference</td>\n</tr>\n<tr>\n<td>destination</td>\n<td>object</td>\n<td><code>Required</code></td>\n</tr>\n<tr>\n<td>destination.type</td>\n<td>string</td>\n<td><code>Required</code> This should be <code>mobile_money</code></td>\n</tr>\n<tr>\n<td>destination.amount</td>\n<td>number</td>\n<td><code>Required</code> transaction amount</td>\n</tr>\n<tr>\n<td>destination.currency</td>\n<td>string</td>\n<td><code>Required</code> transaction currency e.g. KES, GHS</td>\n</tr>\n<tr>\n<td>destination.narration</td>\n<td>string</td>\n<td><code>Optional</code> transaction narration or description</td>\n</tr>\n<tr>\n<td>destination.mobile_money</td>\n<td>object</td>\n<td><code>Required</code> if destination type is <code>mobile_money</code></td>\n</tr>\n<tr>\n<td>destination.mobile_money.operator</td>\n<td>string</td>\n<td><code>Required</code> the recipient's mobile money operator</td>\n</tr>\n<tr>\n<td>destination.mobile_money.mobile_number</td>\n<td>string</td>\n<td><code>Required</code> recipient mobile money number</td>\n</tr>\n<tr>\n<td>destination.customer</td>\n<td>object</td>\n<td><code>Required</code></td>\n</tr>\n<tr>\n<td>destination.customer.name</td>\n<td>string</td>\n<td><code>Optional</code> Customer Name</td>\n</tr>\n<tr>\n<td>destination.customer.email</td>\n<td>string</td>\n<td><code>Required</code> Customer Email</td>\n</tr>\n<tr>\n<td>remittance_data</td>\n<td>object</td>\n<td><code>Required</code></td>\n</tr>\n<tr>\n<td>remittance_data.sender_name</td>\n<td>string</td>\n<td><code>Required</code> full name of the sender</td>\n</tr>\n<tr>\n<td>remittance_data.sender_phone_number</td>\n<td>string</td>\n<td><code>Optional</code> phone number of the sender</td>\n</tr>\n<tr>\n<td>remittance_data.sender_dob</td>\n<td>string</td>\n<td><code>Optional</code> date of birth of the sender, e.g. <code>1990-05-15</code></td>\n</tr>\n<tr>\n<td>remittance_data.sender_country_iso</td>\n<td>string</td>\n<td><code>Optional</code> 2-digit Country ISO code of sender, e.g. <code>NG</code></td>\n</tr>\n<tr>\n<td>remittance_data.sender_nationality</td>\n<td>string</td>\n<td><code>Optional</code> nationality of the sender, e.g. <code>Nigerian</code></td>\n</tr>\n<tr>\n<td>remittance_data.sender_id_type</td>\n<td>string</td>\n<td><code>Optional</code> identification type of the sender, e.g. <code>Passport</code></td>\n</tr>\n<tr>\n<td>remittance_data.sender_id_number</td>\n<td>string</td>\n<td><code>Optional</code> identification type number of the sender, e.g. <code>A12345678</code></td>\n</tr>\n<tr>\n<td>remittance_data.sender_service_provider_name</td>\n<td>string</td>\n<td><code>Optional</code> name of the provider, e.g. <code>ABC Bank</code></td>\n</tr>\n<tr>\n<td>remittance_data.remittance_purpose</td>\n<td>string</td>\n<td><code>Optional</code> purpose of the remittance, e.g. <code>Family Support</code></td>\n</tr>\n<tr>\n<td>remittance_data.sender_recipient_relationship</td>\n<td>string</td>\n<td><code>Optional</code> relationship the sender has with the recipient, e.g. <code>Brother</code></td>\n</tr>\n<tr>\n<td>remittance_data.sender_occupation</td>\n<td>string</td>\n<td><code>Optional</code> occupation of the sender, e.g. <code>Software Engineer</code></td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"successful-response-body\">Successful Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>request status message</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>object containing transaction details: amount, fee, narration, currency, status, reference, customer</td>\n</tr>\n<tr>\n<td>amount</td>\n<td>string</td>\n<td>transaction amount</td>\n</tr>\n<tr>\n<td>fee</td>\n<td>string</td>\n<td>transaction fee</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>string</td>\n<td>transaction currency</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>transaction status.  <br />Note that this would be <code>processing</code> upon initiating the transfer and eventually updated to <code>success</code> or <code>failed</code> once we complete the transfer</td>\n</tr>\n<tr>\n<td>reference</td>\n<td>string</td>\n<td>transaction reference</td>\n</tr>\n<tr>\n<td>narration</td>\n<td>string</td>\n<td>transaction narration</td>\n</tr>\n<tr>\n<td>customer</td>\n<td>object</td>\n<td>an object containing name and email</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","transactions","disburse","remittance"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"d663acf3-4925-4731-8584-278f3cd42a04","name":"Single Remittance Payout to Mobile Money - Initiated Successfully","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n    \"reference\": \"your-unique-transaction-reference-002\",\n    \"destination\": {\n        \"type\": \"mobile_money\",\n        \"amount\": 100,\n        \"currency\": \"KES\",\n        \"narration\": \"Test Transfer Payment 008\",\n        \"mobile_money\": {\n            \"operator\": \"safaricom-ke\",\n            \"mobile_number\": \"256700000000\"\n        },\n        \"customer\": {\n            \"name\": \"John Doe\",\n            \"email\": \"johndoe@email.com\"\n        }\n    },\n    \"remittance_data\": {\n        \"sender_name\": \"Jeremiah Doe\",\n        \"sender_phone_number\": \"086778899010\",\n        \"sender_dob\": \"1990-05-15\",\n        \"sender_country_iso\": \"NG\",\n        \"sender_nationality\": \"Nigerian\",\n        \"sender_id_type\": \"Passport\",\n        \"sender_id_number\": \"A12345678\",\n        \"sender_service_provider_name\": \"ABC Bank\",\n        \"remittance_purpose\": \"Family Support\",\n        \"sender_recipient_relationship\": \"Brother\",\n        \"source_of_funds\": \"Salary\",\n        \"sender_occupation\": \"Software Engineer\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse/remittance"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"transfer initiated successfully\",\n    \"data\": {\n        \"amount\": \"100.00\",\n        \"fee\": \"2.50\",\n        \"currency\": \"KES\",\n        \"status\": \"processing\",\n        \"reference\": \"your-unique-transaction-reference-001\",\n        \"narration\": \"Test Transfer Payment\",\n        \"customer\": {\n            \"name\": \"John Doe\",\n            \"email\": \"johndoe@email.com\",\n            \"phone\": null\n        }\n    }\n}"},{"id":"973745af-5981-46fa-a763-2b0436547618","name":"Single Remittance Payout to Mobile Money - Insufficient Funds","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n    \"reference\": \"your-unique-transaction-reference-002\",\n    \"destination\": {\n        \"type\": \"mobile_money\",\n        \"amount\": 100,\n        \"currency\": \"KES\",\n        \"narration\": \"Test Transfer Payment 008\",\n        \"mobile_money\": {\n            \"operator\": \"safaricom-ke\",\n            \"mobile_number\": \"256700000000\"\n        },\n        \"customer\": {\n            \"name\": \"John Doe\",\n            \"email\": \"johndoe@email.com\"\n        }\n    },\n    \"remittance_data\": {\n        \"sender_name\": \"Jeremiah Doe\",\n        \"sender_phone_number\": \"086778899010\",\n        \"sender_dob\": \"1990-05-15\",\n        \"sender_country_iso\": \"NG\",\n        \"sender_nationality\": \"Nigerian\",\n        \"sender_id_type\": \"Passport\",\n        \"sender_id_number\": \"A12345678\",\n        \"sender_service_provider_name\": \"ABC Bank\",\n        \"remittance_purpose\": \"Family Support\",\n        \"sender_recipient_relationship\": \"Brother\",\n        \"source_of_funds\": \"Salary\",\n        \"sender_occupation\": \"Software Engineer\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse/remittance"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Insufficient funds in disbursement wallet\",\n    \"data\": null\n}"},{"id":"310a1e24-4e93-42ae-a1db-3b365105fa2f","name":"Single Remittance Payout to Mobile Money - Mobile Money Account not Found","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n    \"reference\": \"your-unique-transaction-reference-002\",\n    \"destination\": {\n        \"type\": \"mobile_money\",\n        \"amount\": 100,\n        \"currency\": \"KES\",\n        \"narration\": \"Test Transfer Payment 008\",\n        \"mobile_money\": {\n            \"operator\": \"safaricom-ke\",\n            \"mobile_number\": \"256700000000\"\n        },\n        \"customer\": {\n            \"name\": \"John Doe\",\n            \"email\": \"johndoe@email.com\"\n        }\n    },\n    \"remittance_data\": {\n        \"sender_name\": \"Jeremiah Doe\",\n        \"sender_phone_number\": \"086778899010\",\n        \"sender_dob\": \"1990-05-15\",\n        \"sender_country_iso\": \"NG\",\n        \"sender_nationality\": \"Nigerian\",\n        \"sender_id_type\": \"Passport\",\n        \"sender_id_number\": \"A12345678\",\n        \"sender_service_provider_name\": \"ABC Bank\",\n        \"remittance_purpose\": \"Family Support\",\n        \"sender_recipient_relationship\": \"Brother\",\n        \"source_of_funds\": \"Salary\",\n        \"sender_occupation\": \"Software Engineer\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse/remittance"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Mobile money operator is not available for this currency or does not exist\",\n    \"data\": null\n}"},{"id":"ee81c8b8-f002-421b-9606-f17deb804bba","name":"Single Remittance Payout to Mobile Money - Request Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"destination\": {\n        \"type\": \"mobile_money\",\n        \"amount\": 100,\n        \"currency\": \"KES\",\n        \"narration\": \"Test Transfer Payment 008\",\n        \"mobile_money\": {\n            \"operator\": \"safaricom-ke\",\n            \"mobile_number\": \"256700000000\"\n        },\n        \"customer\": {\n            \"name\": \"John Doe\",\n            \"email\": \"johndoe@email.com\"\n        }\n    },\n    \"remittance_data\": {\n        \"sender_name\": \"Jeremiah Doe\",\n        \"sender_phone_number\": \"086778899010\",\n        \"sender_dob\": \"1990-05-15\",\n        \"sender_country_iso\": \"NG\",\n        \"sender_nationality\": \"Nigerian\",\n        \"sender_id_type\": \"Passport\",\n        \"sender_id_number\": \"A12345678\",\n        \"sender_service_provider_name\": \"ABC Bank\",\n        \"remittance_purpose\": \"Family Support\",\n        \"sender_recipient_relationship\": \"Brother\",\n        \"source_of_funds\": \"Salary\",\n        \"sender_occupation\": \"Software Engineer\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse/remittance"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"bad_request\",\n    \"message\": \"invalid request data\",\n    \"data\": {\n        \"reference\": {\n            \"message\": \"reference is required\",\n            \"customErrorMessage\": \"reference is required\"\n        }\n    }\n}"},{"id":"815c757b-c0be-433d-ac6e-7e2a74668b21","name":"Single Remittance Payout to Mobile Money - Request Validation Error Remittance Data","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"your-unique-transaction-reference-002\",\n    \"destination\": {\n        \"type\": \"mobile_money\",\n        \"amount\": 100,\n        \"currency\": \"KES\",\n        \"narration\": \"Test Transfer Payment 008\",\n        \"mobile_money\": {\n            \"operator\": \"safaricom-ke\",\n            \"mobile_number\": \"256700000000\"\n        },\n        \"customer\": {\n            \"name\": \"John Doe\",\n            \"email\": \"johndoe@email.com\"\n        }\n    },\n    \"remittance_data\": {}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse/remittance"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"validation_error\",\n    \"message\": \"It seems there`s an issue with your input. Please correct it and try again.\",\n    \"data\": {\n        \"remittance_data.sender_name\": {\n            \"message\": \"remittance_data.sender_name is required\",\n            \"customErrorMessage\": \"remittance_data.sender_name is required\"\n        }\n    }\n}"}],"_postman_id":"9fb5c907-5e93-451a-83d9-5d3a74fa6b7e"}],"id":"37b29def-1dd3-447d-92fa-66b2e61ab419","_postman_id":"37b29def-1dd3-447d-92fa-66b2e61ab419","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":true,"source":{"_postman_id":"34814774-3f6c-4608-b0a4-21c3f3560c77","id":"34814774-3f6c-4608-b0a4-21c3f3560c77","name":"Payouts","type":"folder"}}},{"name":"Bulk Payout","item":[{"name":"Disburse to Multiple Bank Accounts","id":"8284ae5d-d733-4b0a-81f8-7af2c28500d0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"batch_reference\": \"payout_batch_reference\",\n    \"description\": \"test bulk transfer\",\n    \"merchant_bears_cost\":true,\n    \"currency\": \"NGN\",\n    \"payouts\": [\n        {\n            \"reference\": \"001_bulktransfer_b\",\n            \"amount\": 1500,\n            \"type\": \"bank_account\",\n            \"narration\": \"Test transfer to F4B Developers\",\n            \"bank_account\": {\n                \"bank_code\": \"044\",\n                \"account_number\": \"0000000000\"\n            },\n            \"customer\": {\n                \"name\": \"Chijioke\",\n                \"email\": \"cjaytechguy@gmail.com\"\n            }\n        },\n        {\n            \"reference\": \"002_bulktransfer_b\",\n            \"amount\": 2000,\n            \"type\": \"bank_account\",\n            \"narration\": \"Test transfer to F4B Developers\",\n            \"bank_account\": {\n                \"bank_code\": \"033\",\n                \"account_number\": \"0000000000\"\n            },\n            \"customer\": {\n                \"name\": \"Chijioke\",\n                \"email\": \"cjaytechguy@gmail.com\"\n            }\n        },\n        {\n            \"reference\": \"003_bulktransfer_b\",\n            \"amount\": 3000,\n            \"type\": \"bank_account\",\n            \"narration\": \"Test transfer to F4B Developers\",\n            \"bank_account\": {\n                \"bank_code\": \"044\",\n                \"account_number\": \"0000000000\"\n            },\n            \"customer\": {\n                \"name\": \"Chijioke\",\n                \"email\": \"cjaytechguy@gmail.com\"\n            }\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse/bulk","description":"<p>This endpoint is used when initiating a bulk payout</p>\n","urlObject":{"path":["merchant","api","v1","transactions","disburse","bulk"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"ee7c4ae6-db98-43c0-80c4-3e4085b7e18d","name":"Disburse to Multiple Bank Accounts - Initiated","originalRequest":{"method":"POST","header":[{"key":"cf-connecting-ip","value":"localhost:7300/api/v1/transactions/disburse/bulk","disabled":true}],"body":{"mode":"raw","raw":"{\n    \"batch_reference\": \"BULK_01_KSEOKAIEOOSO\",\n    \"description\": \"test bulk transfer\",\n    \"merchant_bears_cost\":true,\n    \"currency\": \"NGN\",\n    \"payouts\": [\n        {\n            \"reference\": \"001_bulktransfer_b\",\n            \"amount\": 1500,\n            \"type\": \"bank_account\",\n            \"narration\": \"Test transfer to F4B Developers\",\n            \"bank_account\": {\n                \"bank_code\": \"044\",\n                \"account_number\": \"0000000000\"\n            },\n            \"customer\": {\n                \"name\": \"John\",\n                \"email\": \"jdoe@gmail.com\"\n            }\n        },\n        {\n            \"reference\": \"002_bulktransfer_b\",\n            \"amount\": 2000,\n            \"type\": \"bank_account\",\n            \"narration\": \"Test transfer to F4B Developers\",\n            \"bank_account\": {\n                \"bank_code\": \"033\",\n                \"account_number\": \"0000000000\"\n            },\n            \"customer\": {\n                \"name\": \"Jane\",\n                \"email\": \"janedoe@gmail.com\"\n            }\n        },\n        {\n            \"reference\": \"003_bulktransfer_b\",\n            \"amount\": 3000,\n            \"type\": \"bank_account\",\n            \"narration\": \"Test transfer to F4B Developers\",\n            \"bank_account\": {\n                \"bank_code\": \"044\",\n                \"account_number\": \"0000000000\"\n            },\n            \"customer\": {\n                \"name\": \"Smith\",\n                \"email\": \"smith@gmail.com\"\n            }\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse/bulk"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Bulk payout initiated successfully\",\n    \"data\": {\n        \"status\": \"pending\",\n        \"total_chargeable_amount\": 6674.69,\n        \"merchant_bears_cost\": true,\n        \"currency\": \"NGN\",\n        \"reference\": \"BULK_01_KSEOKAIEOOSO\",\n        \"description\": \"test bulk transfer\",\n        \"created_at\": \"2023-06-25T22:26:43.141Z\"\n    }\n}"},{"id":"0960fd11-4e28-4cec-b8bb-caba432514cf","name":"Disburse to Multiple Bank Accounts - Request Validation Error","originalRequest":{"method":"POST","header":[{"key":"cf-connecting-ip","value":"localhost:7300/api/v1/transactions/disburse/bulk","disabled":true}],"body":{"mode":"raw","raw":"{\n    \"description\": \"test bulk transfer\",\n    \"merchant_bears_cost\":true,\n    \"currency\": \"NGN\",\n    \"payouts\": [\n        {\n            \"reference\": \"001_bulktransfer_b\",\n            \"amount\": 1500,\n            \"type\": \"bank_account\",\n            \"narration\": \"Test transfer to F4B Developers\",\n            \"bank_account\": {\n                \"bank_code\": \"044\",\n                \"account_number\": \"0000000000\"\n            },\n            \"customer\": {\n                \"name\": \"John\",\n                \"email\": \"jdoe@gmail.com\"\n            }\n        },\n        {\n            \"reference\": \"002_bulktransfer_b\",\n            \"amount\": 2000,\n            \"type\": \"bank_account\",\n            \"narration\": \"Test transfer to F4B Developers\",\n            \"bank_account\": {\n                \"bank_code\": \"033\",\n                \"account_number\": \"0000000000\"\n            },\n            \"customer\": {\n                \"name\": \"Jane\",\n                \"email\": \"janedoe@gmail.com\"\n            }\n        },\n        {\n            \"reference\": \"003_bulktransfer_b\",\n            \"amount\": 3000,\n            \"type\": \"bank_account\",\n            \"narration\": \"Test transfer to F4B Developers\",\n            \"bank_account\": {\n                \"bank_code\": \"044\",\n                \"account_number\": \"0000000000\"\n            },\n            \"customer\": {\n                \"name\": \"Smith\",\n                \"email\": \"smith@gmail.com\"\n            }\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse/bulk"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"bad_request\",\n    \"message\": \"invalid request data\",\n    \"data\": {\n        \"batch_reference\": {\n            \"message\": \"batch_reference is required\",\n            \"customErrorMessage\": \"batch_reference is required\"\n        }\n    }\n}"},{"id":"6a6e67ed-634b-404e-a311-408f85037382","name":"Disburse to Multiple Bank Accounts - Insufficient Funds","originalRequest":{"method":"POST","header":[{"key":"cf-connecting-ip","value":"localhost:7300/api/v1/transactions/disburse/bulk","disabled":true}],"body":{"mode":"raw","raw":"{\n    \"batch_reference\": \"BULK_01_KSEOKAIEOOSO\",\n    \"description\": \"test bulk transfer\",\n    \"merchant_bears_cost\":true,\n    \"currency\": \"NGN\",\n    \"payouts\": [\n        {\n            \"reference\": \"001_bulktransfer_b\",\n            \"amount\": 1500,\n            \"type\": \"bank_account\",\n            \"narration\": \"Test transfer to F4B Developers\",\n            \"bank_account\": {\n                \"bank_code\": \"044\",\n                \"account_number\": \"0000000000\"\n            },\n            \"customer\": {\n                \"name\": \"John\",\n                \"email\": \"jdoe@gmail.com\"\n            }\n        },\n        {\n            \"reference\": \"002_bulktransfer_b\",\n            \"amount\": 2000,\n            \"type\": \"bank_account\",\n            \"narration\": \"Test transfer to F4B Developers\",\n            \"bank_account\": {\n                \"bank_code\": \"033\",\n                \"account_number\": \"0000000000\"\n            },\n            \"customer\": {\n                \"name\": \"Jane\",\n                \"email\": \"janedoe@gmail.com\"\n            }\n        },\n        {\n            \"reference\": \"003_bulktransfer_b\",\n            \"amount\": 3000,\n            \"type\": \"bank_account\",\n            \"narration\": \"Test transfer to F4B Developers\",\n            \"bank_account\": {\n                \"bank_code\": \"044\",\n                \"account_number\": \"0000000000\"\n            },\n            \"customer\": {\n                \"name\": \"Smith\",\n                \"email\": \"smith@gmail.com\"\n            }\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/transactions/disburse/bulk"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"code\": \"AA021\",\n    \"message\": \"insufficient funds in disbursement wallet.\",\n    \"data\": null\n}"}],"_postman_id":"8284ae5d-d733-4b0a-81f8-7af2c28500d0"},{"name":"Query Payouts in a Batch","id":"ea68a204-e50a-4906-b969-276e02098fbe","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.korapay.com/merchant/api/v1/transactions/bulk/:bulk_reference/payout","description":"<p>You can also fetch all the payouts in a batch with this endpoint. It returns an array of payouts.</p>\n","urlObject":{"path":["merchant","api","v1","transactions","bulk",":bulk_reference","payout"],"host":["https://api.korapay.com"],"query":[],"variable":[{"description":{"content":"<p>The bulk reference</p>\n","type":"text/plain"},"type":"any","value":null,"key":"bulk_reference"}]}},"response":[{"id":"93578c00-2268-4b09-b5ca-e781bf45b6b7","name":"Query Payouts in a Batch - Successful","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/merchant/api/v1/transactions/bulk/:bulk_reference/payout","host":["https://api.korapay.com"],"path":["merchant","api","v1","transactions","bulk",":bulk_reference","payout"],"query":[{"key":"status","value":"failed","disabled":true},{"key":"limit","value":"50","disabled":true},{"key":"page","value":"1","disabled":true}],"variable":[{"key":"bulk_reference","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"ETag","value":"W/\"4ec-tvGCGz7IJCeHKyPmxoi9Fbk7ePs\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Content-Encoding","value":"gzip"},{"key":"Date","value":"Tue, 23 May 2023 13:42:18 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Payouts retrieved successfully\",\n    \"data\": {\n        \"data\": [\n            {\n                \"reference\": \"001_bulktransfer\",\n                \"amount\": \"1500.00\",\n                \"currency\": \"NGN\",\n                \"narration\": \"Test transfer to F4B Developers\",\n                \"status\": \"success\",\n                \"batch_reference\": \"Test_Bulk_reference_Y\",\n                \"type\": \"bank_account\",\n                \"customer\": {\n                    \"name\": \"John\",\n                    \"email\": \"johndoe@gmail.com\"\n                },\n                \"bank_account\": {\n                    \"bank_code\": \"044\",\n                    \"account_number\": \"0000000000\"\n                }\n            },\n            {\n                \"reference\": \"002_bulktransfer\",\n                \"amount\": \"2000.00\",\n                \"currency\": \"NGN\",\n                \"narration\": \"Test transfer to F4B Developers\",\n                \"status\": \"failed\",\n                \"batch_reference\": \"Test_Bulk_reference_Y\",\n                \"type\": \"bank_account\",\n                \"customer\": {\n                    \"name\": \"Jane\",\n                    \"email\": \"janedoe@gmail.com\"\n                },\n                \"bank_account\": {\n                    \"bank_code\": null,\n                    \"account_number\": null\n                }\n            },\n            {\n                \"reference\": \"003_bulktransfer\",\n                \"amount\": \"3000.00\",\n                \"currency\": \"NGN\",\n                \"narration\": \"Test transfer to F4B Developers\",\n                \"status\": \"success\",\n                \"batch_reference\": \"Test_Bulk_reference_Y\",\n                \"type\": \"bank_account\",\n                \"customer\": {\n                    \"name\": \"Smith\",\n                    \"email\": \"smith@gmail.com\"\n                },\n                \"bank_account\": {\n                    \"bank_code\": \"044\",\n                    \"account_number\": \"0000000000\"\n                }\n            }\n        ],\n        \"paging\": {\n            \"total_items\": 3,\n            \"page_size\": 10,\n            \"current\": 1,\n            \"count\": 3\n        }\n    }\n}"}],"_postman_id":"ea68a204-e50a-4906-b969-276e02098fbe"},{"name":"Query Bulk Transaction Details","id":"fcf27807-bdf0-434e-b93e-d9820131e86f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.korapay.com/merchant/api/v1/transactions/bulk/:bulk_reference","description":"<p>This endpoint is used to fetch the details of an initiated bulk payout. It also returns the status of the bulk payout which could be <code>pending</code>, <code>failed</code>, or <code>complete</code></p>\n","urlObject":{"path":["merchant","api","v1","transactions","bulk",":bulk_reference"],"host":["https://api.korapay.com"],"query":[],"variable":[{"description":{"content":"<p>The bulk reference</p>\n","type":"text/plain"},"type":"any","value":null,"key":"bulk_reference"}]}},"response":[{"id":"70a8aa6f-07f2-4911-8ff6-cb09bbf05144","name":"Query Bulk Transaction Details - Successful","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/merchant/api/v1/transactions/bulk/:bulk_reference","host":["https://api.korapay.com"],"path":["merchant","api","v1","transactions","bulk",":bulk_reference"],"variable":[{"key":"bulk_reference","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"308"},{"key":"ETag","value":"W/\"134-ByjgpJlPT75+6kzNJSfcoVUOvww\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Date","value":"Tue, 23 May 2023 13:56:02 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Bulk transaction retrieved successfully\",\n    \"data\": {\n        \"amount\": \"4500.00\",\n        \"currency\": \"NGN\",\n        \"reference\": \"Test_Bulk_reference_B\",\n        \"status\": \"complete\",\n        \"description\": \"test bulk transfer\",\n        \"failed_transactions\": 1,\n        \"successful_transactions\": 2,\n        \"pending_transactions\": 0,\n        \"processing_transactions\": 0\n    }\n}"}],"_postman_id":"fcf27807-bdf0-434e-b93e-d9820131e86f"}],"id":"7c3e791f-ece0-4b56-85a2-6c839cee966f","description":"<p>Similar to making a single payout to a bank account via API, you can also use our API to make payouts to multiple bank accounts.</p>\n<p>When you initiate a bulk payout request, the disbursement is made from your balance. We send a webhook notification after each individual payout in the batch is completed. In addition, we send an email notification when the bulk payout is initiated, and another when it is complete. For more details, see <a href=\"https://developers.korapay.com/docs/bulk-payouts-via-api\">here</a></p>\n","_postman_id":"7c3e791f-ece0-4b56-85a2-6c839cee966f","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":true,"source":{"_postman_id":"34814774-3f6c-4608-b0a4-21c3f3560c77","id":"34814774-3f6c-4608-b0a4-21c3f3560c77","name":"Payouts","type":"folder"}}},{"name":"Verify Payout Transaction","id":"ce2440eb-4576-4106-ba6f-bda9e8f4e06a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.korapay.com/merchant/api/v1/transactions/:transactionReference","description":"<p>This endpoints returns the status and details of a disbursement through the reference.</p>\n<h2 id=\"url-parameters\">URL Parameters</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>transactionReference</td>\n<td>string</td>\n<td>unique reference</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"successful-response-body\">Successful Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>request status message</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>object containing transaction details: amount, fee, narration, currency, status, reference, customer etc.</td>\n</tr>\n<tr>\n<td>data.fee</td>\n<td>money</td>\n<td>transaction fee</td>\n</tr>\n<tr>\n<td>data.reference</td>\n<td>string</td>\n<td>unique transaction identifier</td>\n</tr>\n<tr>\n<td>data.amount</td>\n<td>money</td>\n<td>transaction amount</td>\n</tr>\n<tr>\n<td>data.narration</td>\n<td>string</td>\n<td>purpose of transaction</td>\n</tr>\n<tr>\n<td>data.currency</td>\n<td>string</td>\n<td>transaction currency e.g. NGN</td>\n</tr>\n<tr>\n<td>data.status</td>\n<td>string</td>\n<td>gives an overview status of the transaction ie. was the payment made successfully or not. It can be <strong>processing</strong>, <strong>failed</strong> or <strong>success</strong></td>\n</tr>\n<tr>\n<td>data.trace_id</td>\n<td>string</td>\n<td>Trace ID can be shared with the bank to trace a transaction. Session ID is a type of trace ID</td>\n</tr>\n<tr>\n<td>data.customer</td>\n<td>object</td>\n<td>object containing name, email and phone</td>\n</tr>\n<tr>\n<td>customer.name</td>\n<td>string</td>\n<td>name of sender/recipient</td>\n</tr>\n<tr>\n<td>customer.email</td>\n<td>string</td>\n<td>email of sender/recipient</td>\n</tr>\n<tr>\n<td>customer.phone</td>\n<td>string</td>\n<td>phone of sender/recipient</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"conditional-field-remittance_data-only-for-remittance-payout-api-requests\">Conditional Field: <code>remittance_data</code> (Only for Remittance Payout API Requests)</h4>\n<p>This section will only be present in the response body if the request is made via the remittance payout API.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>remittance_data</code></td>\n<td><code>object</code></td>\n<td>Contains additional sender details required for remittance transactions.</td>\n</tr>\n<tr>\n<td><code>remittance_data.sender_dob</code></td>\n<td><code>string (ISO 8601)</code></td>\n<td>Sender's date of birth (YYYY-MM-DD).</td>\n</tr>\n<tr>\n<td><code>remittance_data.sender_name</code></td>\n<td><code>string</code></td>\n<td>Full name of the sender.</td>\n</tr>\n<tr>\n<td><code>remittance_data.sender_id_type</code></td>\n<td><code>string</code></td>\n<td>Type of ID used by the sender (e.g., Passport, National ID, Driver’s License).</td>\n</tr>\n<tr>\n<td><code>remittance_data.source_of_funds</code></td>\n<td><code>string</code></td>\n<td>Source of the funds (e.g., Salary, Business Income).</td>\n</tr>\n<tr>\n<td><code>remittance_data.sender_id_number</code></td>\n<td><code>string</code></td>\n<td>Identification number of the sender.</td>\n</tr>\n<tr>\n<td><code>remittance_data.sender_occupation</code></td>\n<td><code>string</code></td>\n<td>Sender's occupation.</td>\n</tr>\n<tr>\n<td><code>remittance_data.remittance_purpose</code></td>\n<td><code>string</code></td>\n<td>Purpose of the remittance (e.g., Family Support, Education).</td>\n</tr>\n<tr>\n<td><code>remittance_data.sender_country_iso</code></td>\n<td><code>string</code></td>\n<td>Sender's country in ISO 3166-1 alpha-2 format (e.g., NG for Nigeria).</td>\n</tr>\n<tr>\n<td><code>remittance_data.sender_nationality</code></td>\n<td><code>string</code></td>\n<td>Nationality of the sender.</td>\n</tr>\n<tr>\n<td><code>remittance_data.sender_phone_number</code></td>\n<td><code>string</code></td>\n<td>Phone number of the sender.</td>\n</tr>\n<tr>\n<td><code>remittance_data.sender_service_provider_name</code></td>\n<td><code>string</code></td>\n<td>Name of the sender's bank or financial service provider.</td>\n</tr>\n<tr>\n<td><code>remittance_data.sender_recipient_relationship</code></td>\n<td><code>string</code></td>\n<td>Relationship between the sender and the recipient (e.g., Brother, Parent).</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"failed-response-body\">Failed Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>request status true/false</td>\n</tr>\n<tr>\n<td>error</td>\n<td>string</td>\n<td>error returned</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>request status description</td>\n</tr>\n<tr>\n<td>data</td>\n<td>string</td>\n<td>error data</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","transactions",":transactionReference"],"host":["https://api.korapay.com"],"query":[],"variable":[{"description":{"content":"<p>The transaction reference to verify</p>\n","type":"text/plain"},"type":"any","value":"your-unique-transaction-reference-001","key":"transactionReference"}]}},"response":[{"id":"93e6aa3a-5dc4-49f5-b54a-e1bec45340a0","name":"Verify Payout Transaction - Successful Payout","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/merchant/api/v1/transactions/:transactionReference","host":["https://api.korapay.com"],"path":["merchant","api","v1","transactions",":transactionReference"],"variable":[{"key":"transactionReference","value":"your-unique-transaction-reference-001"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"457"},{"key":"ETag","value":"W/\"1c9-1z4Ai7x0Gw8kI8JUXB3n4gZd8+4\""},{"key":"Date","value":"Mon, 05 Aug 2019 20:38:26 GMT"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Transaction retrieved successfully\",\n    \"data\": {\n        \"reference\": \"your-unique-transaction-reference-001\",\n        \"status\": \"success\",\n        \"amount\": 1000,\n        \"fee\": 10,\n        \"currency\": \"NGN\",\n        \"narration\": \"payout to customer\",    \n        \"trace_id\": \"000000000000000111111111111111\",\n        \"message\": \"Payout successful\",\n        \"customer\": {\n            \"name\": \"John Doe\",\n            \"email\": \"johndoe@korapay.com\",\n            \"phone\": null\n        }\n    }\n}"},{"id":"bbf6117b-710f-470b-b84a-b2e230317ecb","name":"Verify Payout Transaction - Successful Remittance Payout","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/merchant/api/v1/transactions/:transactionReference","host":["https://api.korapay.com"],"path":["merchant","api","v1","transactions",":transactionReference"],"variable":[{"key":"transactionReference","value":"your-unique-transaction-reference-001"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"457"},{"key":"ETag","value":"W/\"1c9-1z4Ai7x0Gw8kI8JUXB3n4gZd8+4\""},{"key":"Date","value":"Mon, 05 Aug 2019 20:38:26 GMT"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Transaction retrieved successfully\",\n    \"data\": {\n        \"reference\": \"productivity-JSONref-01990Valentin-997-890-3785\",\n        \"batch_reference\": null,\n        \"status\": \"success\",\n        \"amount\": \"100.00\",\n        \"fee\": 23.37,\n        \"currency\": \"GHS\",\n        \"narration\": \"Test Transfer Payment backend\",\n        \"trace_id\": \"325312136131805485217437051622\",\n        \"message\": \"Payout successful\",\n        \"customer\": {\n            \"email\": \"jeremiah@korapay.com\",\n            \"name\": \"jeremiah\",\n            \"phone\": null\n        },\n        \"metadata\": null,\n        \"remittance_data\": {\n            \"sender_dob\": \"1990-05-15T00:00:00.000Z\",\n            \"sender_name\": \"Jeremiah Doe\",\n            \"sender_id_type\": \"Passport\",\n            \"source_of_funds\": \"Salary\",\n            \"sender_id_number\": \"A12345678\",\n            \"sender_occupation\": \"Software Engineer\",\n            \"remittance_purpose\": \"Family Support\",\n            \"sender_country_iso\": \"NG\",\n            \"sender_nationality\": \"Nigerian\",\n            \"sender_phone_number\": \"086778899010\",\n            \"sender_service_provider_name\": \"ABC Bank\",\n            \"sender_recipient_relationship\": \"Brother\"\n        }\n    }\n}"},{"id":"e596f874-d429-4119-aa86-d6c407c39426","name":"Verify Payout Transaction - Failed Payout","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/merchant/api/v1/transactions/:transactionReference","host":["https://api.korapay.com"],"path":["merchant","api","v1","transactions",":transactionReference"],"variable":[{"key":"transactionReference","value":"your-unique-transaction-reference-002"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"457"},{"key":"ETag","value":"W/\"1c9-1z4Ai7x0Gw8kI8JUXB3n4gZd8+4\""},{"key":"Date","value":"Mon, 05 Aug 2019 20:38:26 GMT"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Transaction retrieved successfully\",\n    \"data\": {\n        \"reference\": \"your-unique-transaction-reference-002\",\n        \"status\": \"failed\",\n        \"amount\": 1000,\n        \"fee\": 10,\n        \"currency\": \"NGN\",\n        \"narration\": \"payout to customer\",    \n        \"message\": \"Timeout waiting for response from destination\",\n        \"customer\": {\n            \"name\": \"John Doe\",\n            \"email\": \"johndoe@korapay.com\",\n            \"phone\": null\n        }\n    }\n}"},{"id":"5807d4cf-18dc-489d-96c0-d13044557c3b","name":"Verify Payout Transaction - Pending Payout","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/merchant/api/v1/transactions/:transactionReference","host":["https://api.korapay.com"],"path":["merchant","api","v1","transactions",":transactionReference"],"variable":[{"key":"transactionReference","value":"your-unique-transaction-reference-002"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"457"},{"key":"ETag","value":"W/\"1c9-1z4Ai7x0Gw8kI8JUXB3n4gZd8+4\""},{"key":"Date","value":"Mon, 05 Aug 2019 20:38:26 GMT"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Transaction retrieved successfully\",\n    \"data\": {\n        \"reference\": \"your-unique-transaction-reference-002\",\n        \"status\": \"processing\",\n        \"amount\": 1000,\n        \"fee\": 10,\n        \"currency\": \"NGN\",\n        \"narration\": \"payout to customer\",    \n        \"message\": \"Timeout waiting for response from destination\",\n        \"customer\": {\n            \"name\": \"John Doe\",\n            \"email\": \"johndoe@korapay.com\",\n            \"phone\": null\n        }\n    }\n}"},{"id":"dbe899ba-6f9a-4b86-a2e1-c63ff5d7403d","name":"Verify Payout Transaction - Transaction not found","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/merchant/api/v1/transactions/:transactionReference","host":["https://api.korapay.com"],"path":["merchant","api","v1","transactions",":transactionReference"],"variable":[{"key":"transactionReference","value":"your-unique-transaction-reference-003"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"82"},{"key":"ETag","value":"W/\"52-D/jU98+U6NVrjRWqRqPK/zrncC4\""},{"key":"Date","value":"Mon, 05 Aug 2019 20:39:47 GMT"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Transaction not found\",\n    \"data\": null\n}"}],"_postman_id":"ce2440eb-4576-4106-ba6f-bda9e8f4e06a"},{"name":"Get All Payouts","id":"5168281c-5959-455b-a196-6aa9019a7321","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"GET","header":[],"url":"{{base_url}}/merchant/api/v1/payouts?limit=10","description":"<p>This API allows you to retrieve the history of your payouts. The maximum amount of records that can be retrieved per request is 50</p>\n<h2 id=\"successful-response-body\">Successful Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>request status message</td>\n</tr>\n<tr>\n<td>data.has_more</td>\n<td>boolean</td>\n<td>This signifies whether there are still more items that can be retrieved on the next page</td>\n</tr>\n<tr>\n<td>data.payouts</td>\n<td>array</td>\n<td>This contains the list of payout records. The array contains objects where each object has the information of the payout information</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","payouts"],"host":["{{base_url}}"],"query":[{"key":"limit","value":"10"},{"disabled":true,"key":"ending_before","value":"cus_9C1"},{"disabled":true,"key":"starting_after","value":"cus_9CB"},{"disabled":true,"key":"date_from","value":"2021-04-23"},{"disabled":true,"key":"date_to","value":"2022-01-28"}],"variable":[]}},"response":[{"id":"b5ae2494-64f8-4fc5-97cc-2bdb16affc92","name":"Get All Payouts - Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/api/v1/payouts?limit=10&ending_before=cus_9C1&starting_after=cus_9CB&date_from=2021-04-23&date_to=2022-01-28","host":["https://api.korapay.com"],"path":["api","v1","payouts"],"query":[{"key":"limit","value":"10"},{"key":"ending_before","value":"cus_9C1"},{"key":"starting_after","value":"cus_9CB"},{"key":"date_from","value":"2021-04-23"},{"key":"date_to","value":"2022-01-28"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Transactions retrieved successfully\",\n    \"data\": {\n        \"has_more\": true,\n        \"payouts\": [\n            {\n                \"pointer\": \"cus_16FC\",\n                \"reference\": \"555780645\",\n                \"status\": \"success\",\n                \"amount\": \"1500.00\",\n                \"fee\": \"40.31\",\n                \"currency\": \"NGN\",\n                \"narration\": \"Transfer from Young and free\",\n                \"trace_id\": \"14530184957\",\n                \"message\": \"Payout successful\",\n                \"payment_destination\": \"bank_account\",\n                \"customer_name\": \"David\",\n                \"customer_email\": \"orovwiroroking@gmail.com\",\n                \"date_created\": \"2023-09-07 07:16:04\",\n                \"date_completed\": \"2023-09-07 07:18:17\"\n            },\n            {\n                \"pointer\": \"cus_16FB\",\n                \"reference\": \"KPY-DD-gDPFcCN7NmKHkNb\",\n                \"status\": \"success\",\n                \"amount\": \"3000.00\",\n                \"fee\": \"80.63\",\n                \"currency\": \"NGN\",\n                \"narration\": \"me\",\n                \"trace_id\": \"14534633726\",\n                \"message\": \"Payout successful\",\n                \"payment_destination\": \"bank_account\",\n                \"customer_name\": \"Test Account\",\n                \"customer_email\": null,\n                \"date_created\": \"2023-09-07 06:52:55\",\n                \"date_completed\": \"2023-09-07 06:55:33\"\n            },\n            {\n                \"pointer\": \"cus_16FA\",\n                \"reference\": \"KPY-DD-cSbXyifpQO5kFHh\",\n                \"status\": \"success\",\n                \"amount\": \"3000.00\",\n                \"fee\": \"80.63\",\n                \"currency\": \"NGN\",\n                \"narration\": \"me\",\n                \"trace_id\": \"14532807660\",\n                \"message\": \"Payout successful\",\n                \"payment_destination\": \"bank_account\",\n                \"customer_name\": \"Olaolu Adejide\",\n                \"customer_email\": null,\n                \"date_created\": \"2023-09-07 06:50:31\",\n                \"date_completed\": \"2023-09-07 06:52:56\"\n            },\n            {\n                \"pointer\": \"cus_16F4\",\n                \"reference\": \"558900645\",\n                \"status\": \"success\",\n                \"amount\": \"1500.00\",\n                \"fee\": \"40.31\",\n                \"currency\": \"NGN\",\n                \"narration\": \"Transfer from Young and free\",\n                \"trace_id\": \"14537686836\",\n                \"message\": \"Payout successful\",\n                \"payment_destination\": \"bank_account\",\n                \"customer_name\": \"David\",\n                \"customer_email\": \"orovwiroroking@gmail.com\",\n                \"date_created\": \"2023-08-31 13:09:49\",\n                \"date_completed\": \"2023-08-31 13:12:01\"\n            },\n            {\n                \"pointer\": \"cus_16F3\",\n                \"reference\": \"KPY-DD-ymxQCQyUpsGI7SG\",\n                \"status\": \"success\",\n                \"amount\": \"2000.00\",\n                \"fee\": \"53.75\",\n                \"currency\": \"NGN\",\n                \"narration\": \"me\",\n                \"trace_id\": \"14536244562\",\n                \"message\": \"Payout successful\",\n                \"payment_destination\": \"bank_account\",\n                \"customer_name\": \"Olaolu Adejide\",\n                \"customer_email\": null,\n                \"date_created\": \"2023-08-31 12:54:50\",\n                \"date_completed\": \"2023-08-31 12:57:12\"\n            },\n            {\n                \"pointer\": \"cus_16F2\",\n                \"reference\": \"KPY-DD-7j0VV6umyYK9UUb\",\n                \"status\": \"abandoned\",\n                \"amount\": \"2000.00\",\n                \"fee\": \"53.75\",\n                \"currency\": \"NGN\",\n                \"narration\": \"work\",\n                \"trace_id\": null,\n                \"message\": null,\n                \"payment_destination\": \"bank_account\",\n                \"customer_name\": \"Test Account\",\n                \"customer_email\": null,\n                \"date_created\": \"2023-08-31 12:53:21\",\n                \"date_completed\": \"2023-08-31 15:00:00\"\n            },\n            {\n                \"pointer\": \"cus_16F1\",\n                \"reference\": \"KPY-DD-wwbIAC8XDY5JO1B\",\n                \"status\": \"abandoned\",\n                \"amount\": \"2000.00\",\n                \"fee\": \"53.75\",\n                \"currency\": \"NGN\",\n                \"narration\": \"mee\",\n                \"trace_id\": null,\n                \"message\": null,\n                \"payment_destination\": \"bank_account\",\n                \"customer_name\": \"Olaolu Adejide\",\n                \"customer_email\": null,\n                \"date_created\": \"2023-08-31 10:06:08\",\n                \"date_completed\": \"2023-08-31 12:20:00\"\n            },\n            {\n                \"pointer\": \"cus_16F0\",\n                \"reference\": \"KPY-DD-Gfy013qiRHtNz7T\",\n                \"status\": \"abandoned\",\n                \"amount\": \"2000.00\",\n                \"fee\": \"53.75\",\n                \"currency\": \"NGN\",\n                \"narration\": \"me\",\n                \"trace_id\": null,\n                \"message\": null,\n                \"payment_destination\": \"bank_account\",\n                \"customer_name\": \"Test Account\",\n                \"customer_email\": null,\n                \"date_created\": \"2023-08-31 10:02:15\",\n                \"date_completed\": \"2023-08-31 12:20:00\"\n            },\n            {\n                \"pointer\": \"cus_16E3\",\n                \"reference\": \"KPY-DD-ipmRkETW0EqW6j4\",\n                \"status\": \"abandoned\",\n                \"amount\": \"2000.00\",\n                \"fee\": \"53.75\",\n                \"currency\": \"NGN\",\n                \"narration\": \"test\",\n                \"trace_id\": null,\n                \"message\": null,\n                \"payment_destination\": \"bank_account\",\n                \"customer_name\": \"Test Account\",\n                \"customer_email\": null,\n                \"date_created\": \"2023-08-30 11:13:18\",\n                \"date_completed\": \"2023-08-30 13:20:01\"\n            },\n            {\n                \"pointer\": \"cus_16E0\",\n                \"reference\": \"KPY-DD-DPosZYzExMCGp9m\",\n                \"status\": \"success\",\n                \"amount\": \"2000.00\",\n                \"fee\": \"53.75\",\n                \"currency\": \"NGN\",\n                \"narration\": \"test\",\n                \"trace_id\": \"14537757119\",\n                \"message\": \"Payout successful\",\n                \"payment_destination\": \"bank_account\",\n                \"customer_name\": \"Test Account\",\n                \"customer_email\": null,\n                \"date_created\": \"2023-08-30 10:22:14\",\n                \"date_completed\": \"2023-08-30 10:24:37\"\n            }\n        ]\n    }\n}"}],"_postman_id":"5168281c-5959-455b-a196-6aa9019a7321"}],"id":"34814774-3f6c-4608-b0a4-21c3f3560c77","description":"<p>Payouts, also sometimes called Disbursements, are outbound fund transfers from your merchant account to any bank account.</p>\n<p>You can easily create and manage your payouts directly from your dashboard or through Korapay’s Payout API. These APIs enable you to send payments via a simple, secured process that requires only the bank information of the recipients.</p>\n<h2 id=\"disbursements-channels\">Disbursements Channels</h2>\n<ul>\n<li>Bank accounts</li>\n<li>Mobile Money</li>\n</ul>\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"5b73b874-f17a-4012-b6d6-ec815a315e88","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"c4519fdf-c8e6-468d-b290-454faf09bd47","type":"text/javascript","exec":[""]}}],"_postman_id":"34814774-3f6c-4608-b0a4-21c3f3560c77"},{"name":"Verification","item":[{"name":"Bank Account Resolve","id":"05b2fb87-ee57-4a2c-b07b-bb050b6b58e7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"bank\": \"090645\",\n    \"account\": \"9118378968\",\n    \"currency\": \"NGN\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/misc/banks/resolve","description":"<p>This resolves bank account.</p>\n<h2 id=\"request-body\">Request Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>bank</td>\n<td>string</td>\n<td><code>Required</code> bank code of account number</td>\n</tr>\n<tr>\n<td>account</td>\n<td>string</td>\n<td><code>Required</code> account number to be resolved</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"successful-response-body\">Successful Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>request status message</td>\n</tr>\n<tr>\n<td>data</td>\n<td>string</td>\n<td>object containing transaction details:bank_name, bank_code, account_number, account_name</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"failed-response-body\">Failed Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>request status true/false</td>\n</tr>\n<tr>\n<td>error</td>\n<td>string</td>\n<td>error returned</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>request status description</td>\n</tr>\n<tr>\n<td>data</td>\n<td>string</td>\n<td>error data</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","misc","banks","resolve"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"2338c4b9-4ca7-44dc-9c4e-c7e1020282c7","name":"Bank Account Resolve - Success","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"bank\": \"033\",\n\t\"account\": \"2158634852\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/misc/banks/resolve"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Sat, 29 Feb 2020 13:31:59 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"187"},{"key":"Connection","value":"keep-alive"},{"key":"x-powered-by","value":"Express"},{"key":"access-control-allow-origin","value":"*"},{"key":"www-environment","value":"live"},{"key":"etag","value":"W/\"bb-QWys+gKhpSikfZHn/cdP16IJJec\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"content-security-policy","value":"frame-ancestors 'none'"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Content-Security-Policy","value":"frame-ancestors 'none'"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Request Completed\",\n    \"data\": {\n        \"bank_name\": \"United Bank for Africa\",\n        \"bank_code\": \"033\",\n        \"account_number\": \"2158634852\",\n        \"account_name\": \"EBUKA CIROMA OLADEMJI\"\n    }\n}"},{"id":"75690eef-5ac7-468e-b379-ce376462f9a5","name":"Bank Account Resolve - Invalid account","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n    \"bank\": \"058\",\n    \"account\": \"0237251709\",\n    \"currency\": \"NGN\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/misc/banks/resolve"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 15 Jun 2023 19:30:51 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"72"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"48-/vskXfsoQyvlK8WhwOnihceNu1g\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7d7d3ad8eed4b8be-AMS"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"code\": \"AA027\",\n    \"message\": \"Invalid account.\",\n    \"data\": null\n}"},{"id":"75d48e47-11c9-47a0-9f61-11e88d95dbc0","name":"Bank Account Resolve - Request Validation Error","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n    \"account\": \"0237251709\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/misc/banks/resolve"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 15 Jun 2023 19:30:51 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"72"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"48-/vskXfsoQyvlK8WhwOnihceNu1g\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7d7d3ad8eed4b8be-AMS"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"bad_request\",\n    \"message\": \"invalid request data\",\n    \"data\": {\n        \"amount\": {\n            \"message\": \"bank is required\",\n            \"customErrorMessage\": \"bank is required\"\n        }\n    }\n}"}],"_postman_id":"05b2fb87-ee57-4a2c-b07b-bb050b6b58e7"}],"id":"fb2a169e-91cc-4ebc-802c-fa71b2702e89","description":"<p>The Verification API allows you perform KYC processes.</p>\n","_postman_id":"fb2a169e-91cc-4ebc-802c-fa71b2702e89"},{"name":"Balances","item":[{"name":"Get Balances","id":"d6dcfa41-0bac-493c-b2e5-eaa43ff0e4dd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.korapay.com/merchant/api/v1/balances","description":"<p>This API allows you to retrieve your pending and available balances</p>\n<h2 id=\"successful-response-body\">Successful Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>request status message</td>\n</tr>\n<tr>\n<td>data.currency</td>\n<td>object</td>\n<td>The currency can be NGN, USD or any of the currencies available for you.</td>\n</tr>\n<tr>\n<td>data.currency.pending_balance</td>\n<td>number</td>\n<td>This refers to funds that have been received but are yet to be settled to you.</td>\n</tr>\n<tr>\n<td>data.currency.available_balance</td>\n<td>number</td>\n<td>This represents funds that are available and ready for you to use - to withdraw or to make payouts.</td>\n</tr>\n<tr>\n<td>data.currency.issuing_balance</td>\n<td>number</td>\n<td>This represents funds that are available and ready for you to use for all card related actions such as creation, funding. Funds withdrawn from cards are also settled to this wallet.  <br />  <br /><code>Note:</code> This is only available for the USD currency at the moment</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","balances"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"121e62c3-4e8f-4750-a7d5-3902e7e35119","name":"Get Balance - Success","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer sk_***","description":"API secret key"}],"url":"https://api.korapay.com/merchant/api/v1/balances"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"Sucuri/Cloudproxy"},{"key":"Date","value":"Fri, 23 Apr 2021 13:47:59 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"96"},{"key":"Connection","value":"keep-alive"},{"key":"X-Sucuri-ID","value":"13002"},{"key":"access-control-allow-origin","value":"*"},{"key":"www-environment","value":"live"},{"key":"etag","value":"W/\"60-d4XYr4D4BKC21ZimtFOSErXKHM4\""},{"key":"vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Content-Security-Policy","value":"frame-ancestors 'none'"},{"key":"X-Sucuri-Cache","value":"MISS"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"success\",\n    \"data\": {\n        \"NGN\": {\n            \"pending_balance\": 0,\n            \"available_balance\": 946\n        },\n         \"USD\": {\n            \"pending_balance\": 0,\n            \"available_balance\": 946,\n            \"issuing_balance\": 500\n        }\n    }\n}"}],"_postman_id":"d6dcfa41-0bac-493c-b2e5-eaa43ff0e4dd"},{"name":"Get Balance History","id":"144c6962-2288-48e3-a92a-b90a2df976a0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"GET","header":[],"url":"{{base_url}}/merchant/api/v1/balances/history","description":"<p>This API allows you to retrieve the history of your balances. This provides information about all debit and credit actions on the wallet. The maximum amount of records that can be retrieved per request is 50</p>\n<h2 id=\"successful-response-body\">Successful Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>request status message</td>\n</tr>\n<tr>\n<td>data.has_more</td>\n<td>boolean</td>\n<td>This signifies whether there are still more items that can be retrieved on the next page</td>\n</tr>\n<tr>\n<td>data.history</td>\n<td>array</td>\n<td>This contains the list of balance history records. The array contains objects where each object has the information of the history information</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","balances","history"],"host":["{{base_url}}"],"query":[{"disabled":true,"key":"currency","value":"NGN"},{"disabled":true,"key":"direction","value":"credit"},{"disabled":true,"key":"starting_after","value":"cus_713"},{"disabled":true,"key":"ending_before","value":"cus_70A"},{"disabled":true,"key":"date_from","value":"2023-05-24"},{"disabled":true,"key":"date_to","value":"2022-01-28"},{"disabled":true,"key":"limit","value":"50"}],"variable":[]}},"response":[{"id":"35c4cff6-be9d-41cd-9421-39aa30d2c185","name":"Get Balance History - Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/api/v1/balances/history?currency=NGN&direction=credit&starting_after=cus_713&ending_before=cus_70A&date_from=2023-05-24&date_to=2022-01-28&limit=10","host":["https://api.korapay.com"],"path":["api","v1","balances","history"],"query":[{"key":"currency","value":"NGN"},{"key":"direction","value":"credit"},{"key":"starting_after","value":"cus_713"},{"key":"ending_before","value":"cus_70A"},{"key":"date_from","value":"2023-05-24"},{"key":"date_to","value":"2022-01-28"},{"key":"limit","value":"10"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Balance history retrieved successfully\",\n    \"data\": {\n        \"has_more\": true,\n        \"history\": [\n            {\n                \"pointer\": \"cus_713\",\n                \"amount\": \"100.00\",\n                \"currency\": \"NGN\",\n                \"balance_before\": \"1031741.79\",\n                \"balance_after\": \"1031641.79\",\n                \"date\": \"2023-05-24 08:00:35\",\n                \"description\": \"Refund processed for KPY-C-1G3fDjgD93md\",\n                \"direction\": \"debit\",\n                \"source\": \"refund\",\n                \"source_reference\": \"KPY-RFD-MQdYOcMDF678\"\n            },\n            {\n                \"pointer\": \"cus_712\",\n                \"amount\": \"100.00\",\n                \"currency\": \"NGN\",\n                \"balance_before\": \"1031841.79\",\n                \"balance_after\": \"1031741.79\",\n                \"date\": \"2023-05-23 07:52:05\",\n                \"description\": \"Refund processed for KPY-C-1G3fDjgD93md\",\n                \"direction\": \"debit\",\n                \"source\": \"refund\",\n                \"source_reference\": \"KPY-RFD-6s1DyLsidVlE\"\n            },\n            {\n                \"pointer\": \"cus_711\",\n                \"amount\": \"100.00\",\n                \"currency\": \"NGN\",\n                \"balance_before\": \"1031941.79\",\n                \"balance_after\": \"1031841.79\",\n                \"date\": \"2023-05-23 07:42:48\",\n                \"description\": \"Refund processed for KPY-C-1G3fDjgD93md\",\n                \"direction\": \"debit\",\n                \"source\": \"refund\",\n                \"source_reference\": \"KPY-RFD-zKm7j3b4eLlm\"\n            },\n            {\n                \"pointer\": \"cus_710\",\n                \"amount\": \"100.00\",\n                \"currency\": \"NGN\",\n                \"balance_before\": \"1032041.79\",\n                \"balance_after\": \"1031941.79\",\n                \"date\": \"2023-05-23 07:41:04\",\n                \"description\": \"Refund processed for KPY-C-1G3fDjgD93md\",\n                \"direction\": \"debit\",\n                \"source\": \"refund\",\n                \"source_reference\": \"KPY-RFD-5YqW9sAXGREt\"\n            },\n            {\n                \"pointer\": \"cus_70F\",\n                \"amount\": \"100.00\",\n                \"currency\": \"NGN\",\n                \"balance_before\": \"1032141.79\",\n                \"balance_after\": \"1032041.79\",\n                \"date\": \"2023-05-16 07:38:15\",\n                \"description\": \"Refund processed for KPY-C-1G3fDjgD93md\",\n                \"direction\": \"debit\",\n                \"source\": \"refund\",\n                \"source_reference\": \"KPY-RFD-cShQI9tkNa9O\"\n            },\n            {\n                \"pointer\": \"cus_70E\",\n                \"amount\": \"100.00\",\n                \"currency\": \"NGN\",\n                \"balance_before\": \"1032241.79\",\n                \"balance_after\": \"1032141.79\",\n                \"date\": \"2023-05-12 09:01:45\",\n                \"description\": \"Refund processed for KPY-C-1G3fDjgD93md\",\n                \"direction\": \"debit\",\n                \"source\": \"refund\",\n                \"source_reference\": \"KPY-RFD-5S13UNouoy3P\"\n            },\n            {\n                \"pointer\": \"cus_70D\",\n                \"amount\": \"100.00\",\n                \"currency\": \"NGN\",\n                \"balance_before\": \"1032341.79\",\n                \"balance_after\": \"1032241.79\",\n                \"date\": \"2023-03-31 10:22:23\",\n                \"description\": \"Refund processed for KPY-C-AnEji3hg72ou\",\n                \"direction\": \"debit\",\n                \"source\": \"refund\",\n                \"source_reference\": \"KPY-RFD-iPA1DwzDJr3a\"\n            },\n            {\n                \"pointer\": \"cus_70C\",\n                \"amount\": \"100.00\",\n                \"currency\": \"NGN\",\n                \"balance_before\": \"1032441.79\",\n                \"balance_after\": \"1032341.79\",\n                \"date\": \"2023-03-31 10:17:58\",\n                \"description\": \"Refund processed for KPY-C-AnEji3hg72ou\",\n                \"direction\": \"credit\",\n                \"source\": \"refund\",\n                \"source_reference\": \"KPY-RFD-NFMsmIS28Rqc\"\n            },\n            {\n                \"pointer\": \"cus_70B\",\n                \"amount\": \"100.00\",\n                \"currency\": \"NGN\",\n                \"balance_before\": \"1032541.79\",\n                \"balance_after\": \"1032441.79\",\n                \"date\": \"2023-03-21 13:11:19\",\n                \"description\": \"Refund processed for KPY-C-LxQiPK16rNdt\",\n                \"direction\": \"debit\",\n                \"source\": \"refund\",\n                \"source_reference\": \"KPY-RFD-XViRTaENOw9I\"\n            },\n            {\n                \"pointer\": \"cus_70A\",\n                \"amount\": \"100.00\",\n                \"currency\": \"NGN\",\n                \"balance_before\": \"1032641.79\",\n                \"balance_after\": \"1032541.79\",\n                \"date\": \"2023-03-17 06:08:58\",\n                \"description\": \"Refund processed for KPY-C-LxQiPK16rNdt\",\n                \"direction\": \"debit\",\n                \"source\": \"refund\",\n                \"source_reference\": \"KPY-RFD-a7qsyFes5kmT\"\n            }\n        ]\n    }\n}"}],"_postman_id":"144c6962-2288-48e3-a92a-b90a2df976a0"}],"id":"756c4ed5-443e-4322-85f0-8d7a02b183cd","description":"<p>Your Balance on Korapay simply represents how much funds you have in your Korapay account. Getting balance information can be useful for reconciliatory purposes, preventing failures from insufficient funds, or even fraud detection.</p>\n","_postman_id":"756c4ed5-443e-4322-85f0-8d7a02b183cd"},{"name":"Currency Conversion","item":[{"name":"Initiate Exchange Rate Conversion","id":"07df4e4a-15d0-4c41-b1f6-0189962b7f0c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 4000,\n    \"from_currency\": \"NGN\",\n    \"to_currency\": \"USD\",\n    \"reference\": \"2ccdb7da-e732-4610-a17f-5abfb7617d90\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/conversions/rates","description":"<p>You can use the exchange rate API to get the latest rate for any currency pair. It can be used on its own or before starting a currency conversion</p>\n<h2 id=\"request-body\">Request Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>from_currency</td>\n<td>string</td>\n<td>The currency in which the user is converting from</td>\n</tr>\n<tr>\n<td>to_currency</td>\n<td>string</td>\n<td>The currency in which the user wants to convert to</td>\n</tr>\n<tr>\n<td>amount</td>\n<td>number</td>\n<td>The amount to be converted</td>\n</tr>\n<tr>\n<td>reference</td>\n<td>string</td>\n<td>A string to reference this user. This can be a customer ID, a session ID, or similar, and can be used to reconcile the conversion</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"successful-response-body\">Successful Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>request status message</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>object containing transaction details: reference, rate, expiry_in_seconds and other details</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","conversions","rates"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"93808132-e53a-415d-809e-bac5c7544c20","name":"Initiated","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 10,\n    \"from_currency\": \"USD\",\n    \"to_currency\": \"NGN\",\n    \"reference\": \"1ccdb7da-e732-4610-a17f-5abfb7617d99\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/conversions/rates"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 26 Feb 2025 12:21:44 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"ee-Ft/uo3QySEH6gRIpbK3mi4EfBbU\""},{"key":"vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"content-security-policy","value":"frame-ancestors 'none'"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Set-Cookie","value":"__cf_bm=1Y34g7CWidY1.OUyO1FBaj3SJXEtvGv5laChXlQR9C8-1740572504-1.0.1.1-GfmqGVgHtDvhLt9IS2Jj12doqDL2bXJf71u1YG8f2g0LmEimVqWhKXSmwOjovfomXixjUSt1EQK5f13X_UPShg; path=/; expires=Wed, 26-Feb-25 12:51:44 GMT; domain=.korapay.com; HttpOnly; Secure; SameSite=None"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"917fe5858d3c05f3-IAD"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Conversion rate retrieved successfully\",\n    \"data\": {\n        \"from_currency\": \"USD\",\n        \"to_currency\": \"NGN\",\n        \"from_amount\": 10,\n        \"to_amount\": 14400,\n        \"rate\": 1440,\n        \"reference\": \"1ccdb7da-e732-4610-a17f-5abfb7617d99\",\n        \"expiry_in_seconds\": 25,\n        \"expiry_date\": \"2025-01-01T15:58:18.264Z\"\n    }\n}"},{"id":"3d4d55ec-0383-4d24-bb99-3eb13ca27377","name":"Request Validation Error","originalRequest":{"method":"POST","header":[],"url":"https://api.korapay.com/merchant/api/v1/conversions/rates"},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 26 Feb 2025 11:55:05 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"416"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"1a0-I4wVM4/nOTqzsBGXVTG5k7A+Erk\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"917fbe7c6daec55a-IAD"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"validation_error\",\n    \"message\": \"It seems there`s an issue with your input. Please correct it and try again.\",\n    \"data\": {\n        \"amount\": {\n            \"message\": \"amount is required\",\n            \"customErrorMessage\": \"amount is required\"\n        },\n        \"to_currency\": {\n            \"message\": \"to_currency is required\",\n            \"customErrorMessage\": \"to_currency is required\"\n        },\n        \"reference\": {\n            \"message\": \"reference is required\",\n            \"customErrorMessage\": \"reference is required\"\n        }\n    }\n}"}],"_postman_id":"07df4e4a-15d0-4c41-b1f6-0189962b7f0c"},{"name":"Complete Exchange Rate Conversion","id":"168bd76d-a1bf-4606-bfd3-cab8b08db2ce","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 10,\n    \"from_currency\": \"NGN\",\n    \"to_currency\": \"USD\",\n    \"rate_reference\": \"2ccdb7da-e732-4610-a17f-5abfb7617d90\",\n    \"customer_name\": \"John\",\n    \"customer_email\": \"jdoe@gmail.com\",\n    \"narration\": \"sample narration\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/conversions/","description":"<p>After you get the exchange rate for the currency pair, you can use this endpoint to complete the currency conversion</p>\n<h2 id=\"request-body\">Request Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>rate_reference</td>\n<td>string</td>\n<td><code>required</code> A string to reference the rate that was gotten for the amount</td>\n</tr>\n<tr>\n<td>amount</td>\n<td>number</td>\n<td><code>required</code> The amount to be converted</td>\n</tr>\n<tr>\n<td>from_currency</td>\n<td>string</td>\n<td><code>required</code> The currency in which the user is converting from</td>\n</tr>\n<tr>\n<td>to_currency</td>\n<td>string</td>\n<td><code>required</code>The currency in which the user wants to convert to</td>\n</tr>\n<tr>\n<td>customer_name</td>\n<td>string</td>\n<td><code>required</code> Name of customer initiating</td>\n</tr>\n<tr>\n<td>customer_email</td>\n<td>string</td>\n<td><code>optional</code> Email of the customer initiating</td>\n</tr>\n<tr>\n<td>narration</td>\n<td>string</td>\n<td><code>optional</code> Description</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"successful-response-body\">Successful Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>request status message</td>\n</tr>\n<tr>\n<td>data</td>\n<td>string</td>\n<td>object containing transaction details: converted_amount, exchange_rate and other details</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","conversions",""],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"e8bc0a84-7daf-404c-93a2-2242116fd56f","name":"Successful Conversion","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 10,\n    \"from_currency\": \"USD\",\n    \"to_currency\": \"NGN\",\n    \"rate_reference\": \"1ccdb7da-e732-4610-a17f-5abfb7617d90\",\n    \"customer_name\": \"John\",\n    \"customer_email\": \"jdoe@gmail.com\",\n    \"narration\": \"sample narration\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/conversions/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 26 Feb 2025 12:33:20 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"111-nsCcn9MfqHxGJuahx1d/lhwc6lM\""},{"key":"vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"content-security-policy","value":"frame-ancestors 'none'"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"917ff685a8bd7048-IAD"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Conversion processed successfully\",\n    \"data\": {\n        \"converted_amount\": \"14400.00\",\n        \"source_amount\": \"10.00\",\n        \"destination_currency\": \"NGN\",\n        \"exchange_rate\": \"1440.00\",\n        \"reference\": \"1ccdb7da-e732-4610-a17f-5abfb7617d90\",\n        \"source_currency\": \"USD\",\n        \"status\": \"success\"\n    }\n}"},{"id":"a8c46e18-d45a-4bb1-b4dc-df5beccc56c4","name":"Expired rate reference","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"amount\": 10,\n    \"from_currency\": \"USD\",\n    \"to_currency\": \"NGN\",\n    \"rate_reference\": \"1ccdb7da-e732-4610-a17f-5abfb7617d99\",\n    \"customer_name\": \"John\",\n    \"customer_email\": \"jdoe@gmail.com\",\n    \"narration\": \"sample narration\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/conversions/"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 26 Feb 2025 12:28:50 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"78"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"4e-sZqRvBbj11iCy+8KmujamiYH1wU\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"917fefeabf4268f4-IAD"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"code\": \"AA021\",\n    \"message\": \"Rate details not found\",\n    \"data\": null\n}"},{"id":"9d25aab9-66ac-40e2-9113-acf886fe1e3f","name":"Request Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n   \n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/conversions/"},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 26 Feb 2025 12:30:52 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"536"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"218-Ft/8Yxx+2Ics0gZsMj5S8wG/FJk\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"917ff2e63b3e084f-IAD"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"validation_error\",\n    \"message\": \"It seems there`s an issue with your input. Please correct it and try again.\",\n    \"data\": {\n        \"amount\": {\n            \"message\": \"amount is required\",\n            \"customErrorMessage\": \"amount is required\"\n        },\n        \"to_currency\": {\n            \"message\": \"to_currency is required\",\n            \"customErrorMessage\": \"to_currency is required\"\n        },\n        \"rate_reference\": {\n            \"message\": \"rate_reference is required\",\n            \"customErrorMessage\": \"rate_reference is required\"\n        },\n        \"customer_name\": {\n            \"message\": \"customer_name is required\",\n            \"customErrorMessage\": \"customer_name is required\"\n        }\n    }\n}"}],"_postman_id":"168bd76d-a1bf-4606-bfd3-cab8b08db2ce"},{"name":"Fetch All Exchange Rate Conversions","id":"4c8256ac-84b9-41ff-addc-0a3786ba1e20","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/conversions/?page=1&limit=10&date_to=2021-04-23&date_from=2023-04-23","description":"<p>This API allows you to retrieve the history of your currency conversion transactions.</p>\n<h2 id=\"successful-response-body\">Successful Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>request status message</td>\n</tr>\n<tr>\n<td>data.history</td>\n<td>array</td>\n<td>This contains the list of balance history records. The array contains objects where each object has the history information</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","conversions",""],"host":["https://api.korapay.com"],"query":[{"key":"page","value":"1"},{"key":"limit","value":"10"},{"key":"date_to","value":"2021-04-23"},{"key":"date_from","value":"2023-04-23"},{"disabled":true,"key":null,"value":""}],"variable":[]}},"response":[{"id":"e928c9bd-c9ff-4c65-93f3-b20eaee74469","name":"Success","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.korapay.com/merchant/api/v1/conversions/?page=1&limit=2","host":["https://api.korapay.com"],"path":["merchant","api","v1","conversions",""],"query":[{"key":"page","value":"1"},{"key":"limit","value":"2"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 26 Feb 2025 12:42:11 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"39c-3cylR60gQzJUzIvpMyN39JpWb+o\""},{"key":"vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"content-security-policy","value":"frame-ancestors 'none'"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"9180037d3f113b6b-IAD"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Conversion transactions retrieved successfully\",\n    \"data\": {\n        \"history\": [\n            {\n                \"source_currency\": \"NGN\",\n                \"destination_currency\": \"USD\",\n                \"exchange_rate\": \"1870.00\",\n                \"source_amount\": \"4000.00\",\n                \"converted_amount\": \"2.14\",\n                \"status\": \"success\",\n                \"reference\": \"2ccdb7da-e732-4610-a17f-5abfb7617d90\",\n                \"channel\": \"api\",\n                \"customer_name\": \"John\",\n                \"customer_email\": \"jdoe@gmail.com\",\n                \"narration\": \"sample narration\",\n                \"transaction_date\": \"2025-02-26 13:36:57\",\n                \"account\": {\n                    \"name\": \"Demo Merchant\",\n                    \"email\": \"demo@korapay.com\"\n                }\n            },\n            {\n                \"source_currency\": \"USD\",\n                \"destination_currency\": \"NGN\",\n                \"exchange_rate\": \"1440.00\",\n                \"source_amount\": \"10.00\",\n                \"converted_amount\": \"14400.00\",\n                \"status\": \"success\",\n                \"reference\": \"1ccdb7da-e732-4610-a17f-5abfb7617d90\",\n                \"channel\": \"api\",\n                \"customer_name\": \"John\",\n                \"customer_email\": \"jdoe@gmail.com\",\n                \"narration\": \"sample narration\",\n                \"transaction_date\": \"2025-02-26 13:33:20\",\n                \"account\": {\n                    \"name\": \"Demo Merchant\",\n                    \"email\": \"demo@korapay.com\"\n                }\n            }\n        ]\n    }\n}"}],"_postman_id":"4c8256ac-84b9-41ff-addc-0a3786ba1e20"},{"name":"Fetch Exchange Rate Conversion","id":"a4a4b805-957c-41ce-ad9a-fe01dc974952","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/conversions/:reference","description":"<p>This API allows you to retrieve your pending and available balances</p>\n<h2 id=\"successful-response-body\">Successful Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>request status message</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>object containing currency conversion transaction details</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","conversions",":reference"],"host":["https://api.korapay.com"],"query":[],"variable":[{"type":"any","value":"2ccdb7da-e732-4610-a17f-5abfb7617d90","key":"reference"}]}},"response":[{"id":"1cef5ec0-64a9-4b57-91d4-4a86b1c1314c","name":"Success","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.korapay.com/merchant/api/v1/conversions/:reference","host":["https://api.korapay.com"],"path":["merchant","api","v1","conversions",":reference"],"variable":[{"key":"reference","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 26 Feb 2025 12:48:11 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"1af-/gv0loTaGe9dcCUw5FlLpdq0xnE\""},{"key":"vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"content-security-policy","value":"frame-ancestors 'none'"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"91800c48f98cc036-IAD"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"code\": \"AA000\",\n    \"message\": \"Conversion retrieved successfully\",\n    \"data\": {\n        \"source_currency\": \"NGN\",\n        \"destination_currency\": \"USD\",\n        \"exchange_rate\": \"1870.00\",\n        \"source_amount\": \"4000.00\",\n        \"converted_amount\": \"2.14\",\n        \"status\": \"success\",\n        \"reference\": \"2ccdb7da-e732-4610-a17f-5abfb7617d90\",\n        \"channel\": \"api\",\n        \"customer_name\": \"John\",\n        \"customer_email\": \"jdoe@gmail.com\",\n        \"narration\": \"sample narration\",\n        \"transaction_date\": \"2025-02-26 13:36:57\"\n    }\n}"}],"_postman_id":"a4a4b805-957c-41ce-ad9a-fe01dc974952"}],"id":"21e6776c-d532-4876-bcef-c2bc5e052eb1","description":"<p>Get exchange rates and convert between currencies in real-time with the Exchange Rate APIs.</p>\n<p>Our Currency Conversion product enables you to convert amounts between various currencies using up-to-date exchange rates. The suite of APIs supports fetching the latest exchange rates, converting currency amounts, and retrieving historical conversion transactions.</p>\n","_postman_id":"21e6776c-d532-4876-bcef-c2bc5e052eb1"},{"name":"Card Issuing","item":[{"name":"Cards","item":[{"name":"Create card","id":"7b65e9b7-730a-4064-bb22-7d8a63ddf5f8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"currency\": \"USD\",\n    \"card_holder_reference\": \"KPY-CH-l4QIlhBKexTSjeu\", \n    \"reference\": \"293u112i-f0cu-567f-a1e0-4vht9OUAc9jtest8\",\n    \"type\": \"virtual\",\n    \"brand\": \"visa\",\n    \"amount\": 30\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/cards","description":"<p>This endpoint is used to create card. Pass your secret key in your authorization headers and the request parameters as shown below.</p>\n<h2 id=\"request-body\">Request Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Types</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>reference</td>\n<td>string</td>\n<td><code>Required</code> card reference</td>\n</tr>\n<tr>\n<td>card_holder_reference</td>\n<td>string</td>\n<td><code>Required</code> reference of the cardholder</td>\n</tr>\n<tr>\n<td>amount</td>\n<td>number</td>\n<td><code>Required</code> funding amount during creation</td>\n</tr>\n<tr>\n<td>currency</td>\n<td>string</td>\n<td><code>Required</code> card currency. Allowed option <code>USD</code></td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td><code>Required</code> allowed option is <code>virtual</code></td>\n</tr>\n<tr>\n<td>brand</td>\n<td>string</td>\n<td>can be any of <code>visa</code> or <code>mastercard</code></td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"successful-response-body\">Successful Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>request status message</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>object containing card creation details:reference, currency, type, status,holder_name</td>\n</tr>\n<tr>\n<td>data.reference</td>\n<td>string</td>\n<td>card reference</td>\n</tr>\n<tr>\n<td>data.currency</td>\n<td>string</td>\n<td>transaction currency</td>\n</tr>\n<tr>\n<td>data.status</td>\n<td>string</td>\n<td>card status. Note that this would be <code>pending</code> initially. You can query with the reference to confirm card status. Webhook notification is sent once card creation is completed.</td>\n</tr>\n<tr>\n<td>data.type</td>\n<td>string</td>\n<td>card type</td>\n</tr>\n<tr>\n<td>data.holder_name</td>\n<td>string</td>\n<td>cardholder name</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","cards"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"6b5cabf4-1193-434a-8d85-c1f18f969c09","name":"Create card - Success","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n    \"currency\": \"USD\",\n    \"card_holder_reference\": \"KPY-CH-l4QIlhBKexTSjeu\", \n    \"reference\": \"293u112i-f0cu-567f-a1e0-4vht9OUAc9jtest8\",\n    \"type\": \"virtual\",\n    \"brand\": \"visa\",\n    \"amount\": 30\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/cards"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Card creation pending\",\n    \"data\": {\n        \"reference\": \"293u112i-f0cu-567f-a1e0-4vht9OUAc9jtest8\",\n        \"currency\": \"USD\",\n        \"type\": \"virtual\",\n        \"status\": \"pending\",\n        \"holder_name\": \"John Doe\"\n    }\n}"},{"id":"f0e44f06-ed8b-4775-b8a8-bcfee94844f7","name":"Create card - Request validation error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"currency\": \"USD\",\n    \"card_holder_reference\": \"KPY-CH-l4QIlhBKexTSjeu\", \n    \"reference\": \"293u112i-f0cu-567f-a1e0-4vht9OUAc9jtest8\",\n    \"type\": \"virtual\",\n    \"brand\": \"visa\",\n    \"amount\": 30\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/cards"},"status":"Unprocessable Content","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"validation_error\",\n    \"message\": \"It seems there`s an issue with your input. Please correct it and try again.\",\n    \"data\": {\n        \"brand\": {\n            \"message\": \"brand must be one of [visa, mastercard]\",\n            \"customErrorMessage\": \"master is not a valid option\"\n        }\n    }\n}"},{"id":"8d33d379-f84b-4e46-a0f6-b3e9cdaefb7b","name":"Create card - Duplicate card reference","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"currency\": \"USD\",\n    \"card_holder_reference\": \"KPY-CH-l4QIlhBKexTSjeu\", \n    \"reference\": \"293u112i-f0cu-567f-a1e0-4vht9OUAc9jtest8\",\n    \"type\": \"virtual\",\n    \"brand\": \"visa\",\n    \"amount\": 30\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/cards"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Reference already exists\",\n    \"data\": {}\n}"}],"_postman_id":"7b65e9b7-730a-4064-bb22-7d8a63ddf5f8"},{"name":"Get cards details","id":"2fe2e470-ead0-458c-9a99-266acd28213d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.korapay.com/merchant/api/v1/cards/:reference","description":"<p>This endpoint allows you to retrieve the details of a card.</p>\n<h2 id=\"url-parameters\">URL Parameters</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>reference</td>\n<td>string</td>\n<td>card reference</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"successful-response-body\">Successful Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>request status message</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>object containing card details</td>\n</tr>\n<tr>\n<td>data.reference</td>\n<td>string</td>\n<td>the card reference</td>\n</tr>\n<tr>\n<td>data.type</td>\n<td>string</td>\n<td>the card type</td>\n</tr>\n<tr>\n<td>data.first_six</td>\n<td>string</td>\n<td><code>Optional</code> the first six digit of card PAN</td>\n</tr>\n<tr>\n<td>data.last_four</td>\n<td>string</td>\n<td><code>Optional</code> the last four digit of card PAN</td>\n</tr>\n<tr>\n<td>data.brand</td>\n<td>string</td>\n<td><code>Optional</code> the card brand. It can be <code>visa</code> or <code>mastercard</code></td>\n</tr>\n<tr>\n<td>data.pan</td>\n<td>string</td>\n<td><code>Optional</code> the card PAN</td>\n</tr>\n<tr>\n<td>data.cvv</td>\n<td>string</td>\n<td><code>Optional</code> card verification value</td>\n</tr>\n<tr>\n<td>data.expiry_month</td>\n<td>string</td>\n<td><code>Optional</code> two digit that represents the card expiry month</td>\n</tr>\n<tr>\n<td>data.expiry_year</td>\n<td>string</td>\n<td><code>Optional</code> four digit that represents the card expiry year</td>\n</tr>\n<tr>\n<td>data.currency</td>\n<td>string</td>\n<td><code>Optional</code> card currency</td>\n</tr>\n<tr>\n<td>data.balance</td>\n<td>number</td>\n<td><code>Optional</code> card balance</td>\n</tr>\n<tr>\n<td>data.status</td>\n<td>string</td>\n<td>status of the card. Can be any of <code>pending</code>, <code>active</code>, <code>suspended</code>, <code>terminated</code>, <code>expired</code> or <code>failed</code></td>\n</tr>\n<tr>\n<td>data.category</td>\n<td>string</td>\n<td><code>Optional</code> The card category. Can be any of <code>reserved</code> or <code>customer.</code> Reserved cards are for business and customer cards are for individual</td>\n</tr>\n<tr>\n<td>data.created_at</td>\n<td>datetime</td>\n<td><code>Optional</code>the date the card was created</td>\n</tr>\n<tr>\n<td>data.billing</td>\n<td>object</td>\n<td><code>Optional</code> the billing information of the card. It contains the <code>address1</code>, <code>city</code>, <code>state</code>, <code>country</code> and <code>zip_code</code></td>\n</tr>\n<tr>\n<td>data.card_holder</td>\n<td>object</td>\n<td>the cardholder information. It contains the <code>first_name</code>, <code>last_name</code>, <code>email</code> and <code>address</code> of the cardholder</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","cards",":reference"],"host":["https://api.korapay.com"],"query":[],"variable":[{"id":"ab856727-13be-4980-b684-9edebeaf8142","type":"any","value":"293df12i-f0cu-577f-a1e0-4vht9OUAc9jtest8","key":"reference"}]}},"response":[{"id":"70159c7c-e9e0-46bc-81cf-f8461f08f421","name":"Get cards details - Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/merchant/api/v1/cards/:reference","host":["https://api.korapay.com"],"path":["merchant","api","v1","cards",":reference"],"variable":[{"key":"reference","value":"293df12i-f0cu-577f-a1e0-4vht9OUAc9jtest8"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Card details retrieved successfully\",\n    \"data\": {\n        \"reference\": \"293df12i-f0cu-577f-a1e0-4vht9OUAc9jtest8\",\n        \"type\": \"virtual\",\n        \"first_six\": \"XXXXXX\",\n        \"last_four\": \"1234\",\n        \"brand\": \"visa\",\n        \"pan\": \"1234567890987654\",\n        \"cvv\": \"987\",\n        \"expiry_month\": \"03\",\n        \"expiry_year\": \"2030\",\n        \"currency\": \"USD\",\n        \"balance\": 5,\n        \"status\": \"active\",\n        \"billing\": {\n            \"address1\": \"8 The Green Ste R\",\n            \"city\": \"Dover County\",\n            \"state\": \"Delaware\",\n            \"country\": \"US\",\n            \"zip_code\": \"19901\"\n        },\n        \"card_holder\": {\n            \"first_name\": \"John\",\n            \"last_name\": \"Deo\",\n            \"email\": \"johndoe@korapay.com\",\n            \"address\": {\n                \"city\": \"Lekki\",\n                \"state\": \"Lagos\",\n                \"street\": \"No 14, Kora street\",\n                \"country\": \"NG\",\n                \"zip_code\": \"101566\"\n            }\n        },\n        \"date_created\": \"2025-03-12T09:47:09.000Z\",\n        \"category\": \"customer\"\n    }\n}"},{"id":"ec7e565a-4fab-464a-919b-98dd9f1a9185","name":"Get cards details - Not found","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/merchant/api/v1/cards/:reference","host":["https://api.korapay.com"],"path":["merchant","api","v1","cards",":reference"],"variable":[{"key":"reference","value":"293df12i-f0cu-577f-a1e0-4vht9OUAc9jtest8"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Card not found\",\n    \"data\": {}\n}"}],"_postman_id":"2fe2e470-ead0-458c-9a99-266acd28213d"},{"name":"Get cards","id":"056623f7-a535-4b2c-9808-0d8599ab6a77","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.korapay.com/merchant/api/v1/cards","description":"<p>This endpoint is used to retrieve a list of cards</p>\n<h2 id=\"successful-response-body\">Successful Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>request status message</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>captures the cards data array</td>\n</tr>\n<tr>\n<td>data.data</td>\n<td>array</td>\n<td>This contains the list of card records. The array contains objects where each object has the information of a card.</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","cards"],"host":["https://api.korapay.com"],"query":[{"disabled":true,"key":"start_date","value":"2023-04-06"},{"disabled":true,"key":"end_date","value":"2025-04-10"},{"disabled":true,"key":"status","value":"active"}],"variable":[]}},"response":[{"id":"046e8f0c-2dd5-4b94-94a9-1ed8f617789e","name":"Get cards - Success","originalRequest":{"method":"GET","header":[],"url":"https://api.korapay.com/merchant/api/v1/cards"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Cards retrieved successfully\",\n    \"data\": {\n        \"data\": [\n            {\n                \"reference\": \"293df12i-f0cu-577f-a1e0-4vht9OUAc9jtest8\",\n                \"type\": \"virtual\",\n                \"first_six\": \"XXXXXX\",\n                \"last_four\": \"1234\",\n                \"brand\": \"visa\",\n                \"pan\": \"1234567890987654\",\n                \"cvv\": \"987\",\n                \"expiry_month\": \"03\",\n                \"expiry_year\": \"2030\",\n                \"currency\": \"USD\",\n                \"balance\": 5,\n                \"status\": \"active\",\n                \"holder_name\": \"Allen wave\",\n                \"merchant_name\": \"wave-biz\",\n                \"label\": \"test card\",\n                \"date_created\": \"2025-03-12T09:47:09.000Z\"\n            }\n        ]\n    }\n}"}],"_postman_id":"056623f7-a535-4b2c-9808-0d8599ab6a77"},{"name":"Fund card","id":"476a53f5-1918-4d3a-80c0-203b83bd52ce","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"KPY-RVC-9vITsWdFwZ097jztest\",\n    \"amount\": 500,\n    \"description\": \"fund money\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/cards/:reference/fund","description":"<p>This endpoint is used to fund card. Pass your secret key in your authorization headers and the request parameters as shown below.</p>\n<h2 id=\"url-parameters\">URL Parameters</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>reference</td>\n<td>string</td>\n<td>card reference</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"request-body\">Request Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Types</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>reference</td>\n<td>string</td>\n<td><code>Required</code> card funding transaction reference</td>\n</tr>\n<tr>\n<td>amount</td>\n<td>number</td>\n<td><code>Required</code> amount to be funded</td>\n</tr>\n<tr>\n<td>description</td>\n<td>string</td>\n<td><code>Optional</code> funding description</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"successful-response-body\">Successful Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>request status message</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>object containing <code>card_reference</code>, <code>transaction_reference</code>, <code>currency</code>, <code>status</code>, <code>amount</code>, <code>fee</code>, <code>type</code></td>\n</tr>\n<tr>\n<td>data.card_reference</td>\n<td>string</td>\n<td>card reference</td>\n</tr>\n<tr>\n<td>data.transaction_reference</td>\n<td>string</td>\n<td>transaction reference. This is same as the reference passed in payload</td>\n</tr>\n<tr>\n<td>data.currency</td>\n<td>string</td>\n<td>transaction currency</td>\n</tr>\n<tr>\n<td>data.status</td>\n<td>string</td>\n<td>funding transaction status. Note that this would be <code>processing</code> initially. Webhook notification is sent once card withdrawal is completed.</td>\n</tr>\n<tr>\n<td>data.amount</td>\n<td>number</td>\n<td>amount funded</td>\n</tr>\n<tr>\n<td>data.fee</td>\n<td>fee</td>\n<td>funding fee</td>\n</tr>\n<tr>\n<td>data.type</td>\n<td>string</td>\n<td>transaction type. In this case it will be <code>card_funding</code></td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","cards",":reference","fund"],"host":["https://api.korapay.com"],"query":[],"variable":[{"id":"9266cc91-17b3-4376-91e6-afe291bc62af","type":"any","value":"293df12i-f0cu-577f-a1e0-4vht9OUAc9jtest8","key":"reference"}]}},"response":[{"id":"ec3d5078-1747-4a89-b36f-07da211e707d","name":"Fund card - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"KPY-RVC-9vITsWdFwZ097jz\",\n    \"amount\": 5,\n    \"description\": \"fund money\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.korapay.com/merchant/api/v1/cards/:reference/fund","host":["https://api.korapay.com"],"path":["merchant","api","v1","cards",":reference","fund"],"variable":[{"key":"reference","value":"293df12i-f0cu-577f-a1e0-4vht9OUAc9jtest8"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Card funding pending\",\n    \"data\": {\n        \"card_reference\": \"293df12i-f0cu-577f-a1e0-4vht9OUAc9jtest8\",\n        \"transaction_reference\": \"KPY-RVC-9vITsWdFwZ097jz\",\n        \"amount\": 5,\n        \"fee\": 0.13,\n        \"currency\": \"USD\",\n        \"type\": \"card_funding\",\n        \"status\": \"processing\"\n    }\n}"},{"id":"fe2638a5-573d-400a-8644-a9c27cfd4389","name":"Fund card - Funding limits exceeded","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"KPY-RVC-9vITsWdFwZ097jz\",\n    \"amount\": 5,\n    \"description\": \"fund money\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.korapay.com/merchant/api/v1/cards/:reference/fund","host":["https://api.korapay.com"],"path":["merchant","api","v1","cards",":reference","fund"],"variable":[{"key":"reference","value":"293df12i-f0cu-577f-a1e0-4vht9OUAc9jtest8"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Daily funding limit exceeded. Please contact support\",\n    \"data\": {}\n}"},{"id":"01825d1c-9937-4949-9276-f207fd7860e0","name":"Fund card - Request validation error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"KPY-RVC-9vITsWdFwZ097jz\",\n    \"amount\": 5,\n    \"description\": \"fund money\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.korapay.com/merchant/api/v1/cards/:reference/fund","host":["https://api.korapay.com"],"path":["merchant","api","v1","cards",":reference","fund"],"variable":[{"key":"reference","value":"293df12i-f0cu-577f-a1e0-4vht9OUAc9jtest8"}]}},"status":"Unprocessable Content","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"validation_error\",\n    \"message\": \"It seems there`s an issue with your input. Please correct it and try again.\",\n    \"data\": {\n        \"description\": {\n            \"message\": \"description is not allowed to be empty\"\n        }\n    }\n}"},{"id":"5014a795-91ae-49eb-a11a-276908292b67","name":"Fund card - Duplicate reference","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"KPY-RVC-9vITsWdFwZ097jz\",\n    \"amount\": 5,\n    \"description\": \"fund money\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.korapay.com/merchant/api/v1/cards/:reference/fund","host":["https://api.korapay.com"],"path":["merchant","api","v1","cards",":reference","fund"],"variable":[{"key":"reference","value":"293df12i-f0cu-577f-a1e0-4vht9OUAc9jtest8"}]}},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Reference already exists\",\n    \"data\": {}\n}"}],"_postman_id":"476a53f5-1918-4d3a-80c0-203b83bd52ce"},{"name":"Withdraw from card","id":"6d6b7850-0c32-4ed3-a13c-bd63840a00d6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"your-reference-id1\",\n    \"amount\": 2,\n    \"description\": \"test money\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/cards/:reference/withdraw","description":"<p>This endpoint is used to withdraw from a card. Pass your secret key in your authorization headers and the request parameters as shown below.</p>\n<h2 id=\"url-parameters\">URL Parameters</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>reference</td>\n<td>string</td>\n<td>card reference</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"request-body\">Request Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Types</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>reference</td>\n<td>string</td>\n<td><code>Required</code> card withdrawal transaction reference</td>\n</tr>\n<tr>\n<td>amount</td>\n<td>number</td>\n<td><code>Required</code> amount to be withdrawn</td>\n</tr>\n<tr>\n<td>description</td>\n<td>string</td>\n<td><code>Optional</code> withdrawal description</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"successful-response-body\">Successful Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>request status message</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>object containing <code>card_reference</code>, <code>transaction_reference</code>, <code>currency</code>, <code>status</code>, <code>amount</code>, <code>fee</code>, <code>type</code></td>\n</tr>\n<tr>\n<td>data.card_reference</td>\n<td>string</td>\n<td>card reference</td>\n</tr>\n<tr>\n<td>data.transaction_reference</td>\n<td>string</td>\n<td>transaction reference. This is same as the reference passed in payload</td>\n</tr>\n<tr>\n<td>data.currency</td>\n<td>string</td>\n<td>transaction currency</td>\n</tr>\n<tr>\n<td>data.status</td>\n<td>string</td>\n<td>funding transaction status. Note that this would be <code>processing</code> initially. Webhook notification is sent once card withdrawal is completed.</td>\n</tr>\n<tr>\n<td>data.amount</td>\n<td>number</td>\n<td>amount funded</td>\n</tr>\n<tr>\n<td>data.fee</td>\n<td>fee</td>\n<td>funding fee</td>\n</tr>\n<tr>\n<td>data.type</td>\n<td>string</td>\n<td>transaction type. In this case it will be <code>card_withdrawal</code></td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","cards",":reference","withdraw"],"host":["https://api.korapay.com"],"query":[],"variable":[{"id":"69b14f0f-7b69-48da-93f7-db1278eaace9","type":"any","value":"293df12i-f0cu-577f-a1e0-4vht9OUAc9jtest8","key":"reference"}]}},"response":[{"id":"288abdc9-cd41-46d1-a8e9-3fae12012b02","name":"Withdraw from card - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"your-reference-id12\",\n    \"amount\": 5,\n    \"description\": \"test money\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.korapay.com/merchant/api/v1/cards/:reference/withdraw","host":["https://api.korapay.com"],"path":["merchant","api","v1","cards",":reference","withdraw"],"variable":[{"key":"reference","value":"293df12i-f0cu-577f-a1e0-4vht9OUAc9jtest8"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Card withdrawal pending\",\n    \"data\": {\n        \"card_reference\": \"293df12i-f0cu-577f-a1e0-4vht9OUAc9jtest8\",\n        \"transaction_reference\": \"your-reference-id12\",\n        \"amount\": 4,\n        \"fee\": 1,\n        \"currency\": \"USD\",\n        \"type\": \"card_withdrawal\",\n        \"status\": \"processing\"\n    }\n}"},{"id":"5b3ab373-18bb-4f91-8294-4c16818e74ea","name":"Withdraw from card - Request validation error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"your-reference-id12\",\n    \"amount\": 2,\n    \"description\": \"test money\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.korapay.com/merchant/api/v1/cards/:reference/withdraw","host":["https://api.korapay.com"],"path":["merchant","api","v1","cards",":reference","withdraw"],"variable":[{"key":"reference","value":"293df12i-f0cu-577f-a1e0-4vht9OUAc9jtest8"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Amount must be within the range of 5 and 100\",\n    \"data\": {}\n}"},{"id":"22971e45-53e8-4c9a-bb28-6d560140a5df","name":"Withdraw from card - Duplicate reference","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"reference\": \"your-reference-id12\",\n    \"amount\": 5,\n    \"description\": \"test money\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.korapay.com/merchant/api/v1/cards/:reference/withdraw","host":["https://api.korapay.com"],"path":["merchant","api","v1","cards",":reference","withdraw"],"variable":[{"key":"reference","value":"293df12i-f0cu-577f-a1e0-4vht9OUAc9jtest8"}]}},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Reference already exists\",\n    \"data\": {}\n}"}],"_postman_id":"6d6b7850-0c32-4ed3-a13c-bd63840a00d6"},{"name":"Update card status","id":"64fac5d4-e3e4-4062-beb6-ca978bb8aa3c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n    \"action\": \"activate\",\n    \"reason\": \"Test reason\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/cards/:reference/status","description":"<p>This endpoint is used to update the status of a card. Pass your secret key in your authorization headers and the request parameters as shown below.</p>\n<p>The action can be <code>activate</code> or <code>suspend</code></p>\n<h2 id=\"url-parameters\">URL Parameters</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>reference</td>\n<td>string</td>\n<td>card reference</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"request-body\">Request Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Types</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>action</td>\n<td>string</td>\n<td><code>Required</code>can be any of <code>activate</code> or <code>suspend</code></td>\n</tr>\n<tr>\n<td>reason</td>\n<td>string</td>\n<td><code>Required</code> reason for status update</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"successful-response-body\">Successful Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>request status message</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>object containing <code>status</code></td>\n</tr>\n<tr>\n<td>data.status</td>\n<td>string</td>\n<td>can be any of <code>active</code> or <code>suspended</code></td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","cards",":reference","status"],"host":["https://api.korapay.com"],"query":[],"variable":[{"id":"c493c1e5-e5a6-42c1-acff-17a2f8dba026","type":"any","value":"293df12i-f0cu-577f-a1e0-4vht9OUAc9jtest8","key":"reference"}]}},"response":[{"id":"e200a47a-29c3-482c-a407-c8255076dcea","name":"Update card status - Successful Activate card","originalRequest":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n    \"action\": \"activate\",\n    \"reason\": \"Test reason\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.korapay.com/merchant/api/v1/cards/:reference/status","protocol":"https","host":["api","korapay","com"],"path":["merchant","api","v1","cards",":reference","status"],"variable":[{"key":"reference","value":"293df12i-f0cu-577f-a1e0-4vht9OUAc9jtest8"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Card activated successfully\",\n    \"data\": {\n        \"status\": \"active\"\n    }\n}"},{"id":"1e87d637-effc-4f37-aa88-6ab5dab39bd6","name":"Update card status - Successful suspension of card","originalRequest":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n    \"action\": \"suspend\",\n    \"reason\": \"Test reason\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.korapay.com/merchant/api/v1/cards/:reference/status","host":["https://api.korapay.com"],"path":["merchant","api","v1","cards",":reference","status"],"variable":[{"key":"reference","value":"293df12i-f0cu-577f-a1e0-4vht9OUAc9jtest8"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Card deactivated successfully\",\n    \"data\": {\n        \"status\": \"suspended\"\n    }\n}"},{"id":"7dae28eb-0741-4d10-903e-7a3e41b70794","name":"Update card status - Request validation error","originalRequest":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n    \"action\": \"activated\",\n    \"reason\": \"Test reason\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.korapay.com/merchant/api/v1/cards/:reference/status","host":["https://api.korapay.com"],"path":["merchant","api","v1","cards",":reference","status"],"variable":[{"key":"reference","value":"293df12i-f0cu-577f-a1e0-4vht9OUAc9jtest8"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"validation_error\",\n    \"message\": \"It seems there`s an issue with your input. Please correct it and try again.\",\n    \"data\": {\n        \"action\": {\n            \"message\": \"action must be one of [activate, suspend]\",\n            \"customErrorMessage\": \"activat is not a valid option\"\n        }\n    }\n}"},{"id":"d55e91ed-beef-462f-bcb4-2482e95669cf","name":"Update card status - Duplicate Request","originalRequest":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n    \"action\": \"activate\",\n    \"reason\": \"Test reason\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.korapay.com/merchant/api/v1/cards/:reference/status","host":["https://api.korapay.com"],"path":["merchant","api","v1","cards",":reference","status"],"variable":[{"key":"reference","value":"293df12i-f0cu-577f-a1e0-4vht9OUAc9jtest8"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Card is already active\",\n    \"data\": {}\n}"}],"_postman_id":"64fac5d4-e3e4-4062-beb6-ca978bb8aa3c"}],"id":"df8ed076-17c9-491f-84c3-fc9566aff91e","description":"<p>This folder includes endpoints for card creation, withdrawal, funding, and retrieving cards</p>\n","_postman_id":"df8ed076-17c9-491f-84c3-fc9566aff91e"},{"name":"Cardholder","item":[{"name":"Create Cardholder","id":"7d2e7296-e26b-4eb0-a8cd-2f2506708e6a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"first_name\": \"John\",\n    \"last_name\": \"Doe\",\n    \"email\": \"jdoe@test.com\",\n    \"phone_number\": \"2348000191000\",\n    \"selfie_reference\":\"cardholder-ref-01\",\n    \"gender\":\"male\",\n    \"date_of_birth\": \"1988-04-04\",\n    \"country_identity\": {\n        \"type\": \"bvn\",\n        \"number\": \"11111111111\",\n        \"country\":\"NG\"\n    },\n    \"address\": {\n        \"street\": \"No 14, Kora street\",\n        \"city\": \"Lekki\",\n        \"state\": \"Lagos\",\n        \"country\": \"NG\",\n        \"zip_code\": \"101566\"\n    },\n    \"identity\": {\n        \"type\": \"nin\",\n        \"number\": \"11111111111\",\n        \"country\": \"NG\",\n        \"id_front_reference\":\"cardholder-id-front-ref-01\",\n        \"id_back_reference\":\"cardholder-id-back-ref-01\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/cardholders","description":"<p>This endpoint is used to create a cardholder</p>\n<h2 id=\"request-body\">Request Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Types</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>first_name</td>\n<td>string</td>\n<td><code>Required</code> first name of the cardholder</td>\n</tr>\n<tr>\n<td>last_name</td>\n<td>string</td>\n<td><code>Required</code> last name of cardholder</td>\n</tr>\n<tr>\n<td>email</td>\n<td>string</td>\n<td><code>Required</code> email of cardholder</td>\n</tr>\n<tr>\n<td>phone_number</td>\n<td>string</td>\n<td><code>Required</code> phone number of cardholder</td>\n</tr>\n<tr>\n<td>gender</td>\n<td>string</td>\n<td><code>Required</code> Can be any of <code>male</code> or <code>female</code></td>\n</tr>\n<tr>\n<td>selfie_reference</td>\n<td>string</td>\n<td><code>Required</code> reference of uploaded selfie image</td>\n</tr>\n<tr>\n<td>date_of_birth</td>\n<td>string</td>\n<td><code>Required</code> date of birth of cardholder</td>\n</tr>\n<tr>\n<td>country_identity</td>\n<td>object</td>\n<td><code>Required</code> contains the type and number of the cardholder's country identity</td>\n</tr>\n<tr>\n<td>country_identity.type</td>\n<td>string</td>\n<td><code>Required</code> When country is NG, the allowed option is <code>bvn</code> and for other countries <code>national_id</code> is the allowed option</td>\n</tr>\n<tr>\n<td>country_identity.number</td>\n<td>string</td>\n<td><code>Required</code> country identity number</td>\n</tr>\n<tr>\n<td>country_identity.country</td>\n<td>string</td>\n<td><code>Required</code> alpha2 country codes</td>\n</tr>\n<tr>\n<td>identity</td>\n<td>object</td>\n<td><code>Required</code> contains details of the identity details provided by cardholder such as the type, number, country and image</td>\n</tr>\n<tr>\n<td>identity.type</td>\n<td>string</td>\n<td><code>Required</code> can be any of <code>nin</code>, <code>passport</code>, <code>drivers_license</code> or <code>voters_card</code></td>\n</tr>\n<tr>\n<td>identity.number</td>\n<td>string</td>\n<td><code>Required</code> identity number</td>\n</tr>\n<tr>\n<td>identity.country</td>\n<td>string</td>\n<td><code>Required</code> alpha2 country codes</td>\n</tr>\n<tr>\n<td>identity.image</td>\n<td>string</td>\n<td><code>Optional</code> base64 string</td>\n</tr>\n<tr>\n<td>identity.id_front_reference</td>\n<td>string</td>\n<td><code>Required</code> reference of uploaded front Id image</td>\n</tr>\n<tr>\n<td>identity.id_back_reference</td>\n<td>string</td>\n<td><code>Required</code> reference of uploaded back Id image</td>\n</tr>\n<tr>\n<td>address</td>\n<td>object</td>\n<td><code>Required</code> contains details of the cardholder's address</td>\n</tr>\n<tr>\n<td>address.street</td>\n<td>string</td>\n<td><code>Required</code></td>\n</tr>\n<tr>\n<td>address.street2</td>\n<td>string</td>\n<td><code>Optional</code></td>\n</tr>\n<tr>\n<td>address.city</td>\n<td>string</td>\n<td><code>Required</code></td>\n</tr>\n<tr>\n<td>address.state</td>\n<td>string</td>\n<td><code>Required</code></td>\n</tr>\n<tr>\n<td>address.country</td>\n<td>string</td>\n<td><code>Required</code> This is alpha-2 country codes. For example: <code>NG</code></td>\n</tr>\n<tr>\n<td>address.zip_code</td>\n<td>string</td>\n<td><code>Required</code></td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"successful-response-body\">Successful Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>request status message</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>object containing <code>status</code></td>\n</tr>\n<tr>\n<td>data.reference</td>\n<td>string</td>\n<td>cardholder reference</td>\n</tr>\n<tr>\n<td>data.validation_status</td>\n<td>string</td>\n<td>can be any of <code>pending</code>, <code>failed</code> or <code>success</code></td>\n</tr>\n<tr>\n<td>data.first_name</td>\n<td>string</td>\n<td>cardholder first name</td>\n</tr>\n<tr>\n<td>data.last_name</td>\n<td>string</td>\n<td>cardholder last name</td>\n</tr>\n<tr>\n<td>data.email</td>\n<td>string</td>\n<td>cardholder email</td>\n</tr>\n<tr>\n<td>data.phone_number</td>\n<td>string</td>\n<td>cardholder phone number</td>\n</tr>\n<tr>\n<td>data.date_of_birth</td>\n<td>string</td>\n<td>cardholder date of birth</td>\n</tr>\n<tr>\n<td>data.address</td>\n<td>object</td>\n<td>the cardholder address information. It contains the <code>street</code>, <code>city</code>, <code>state</code>, <code>country</code> and <code>zip_code</code></td>\n</tr>\n<tr>\n<td>data.country_identity</td>\n<td>object</td>\n<td>the cardholder country identity details. It contains the <code>type</code> and <code>number</code></td>\n</tr>\n<tr>\n<td>data.identity</td>\n<td>object</td>\n<td>the cardholder identity details. It contains the <code>type</code> <code>number</code>, <code>country</code>, and <code>image</code></td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","cardholders"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"097b6698-4619-44f4-a6d4-615436c9b106","name":"Create cardholder - Success","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n    \"first_name\": \"John\",\n    \"last_name\": \"Doe\",\n    \"email\": \"jdoe@test.com\",\n    \"phone_number\": \"2348000191000\",\n    \"selfie_reference\":\"cardholder-ref-01\",\n    \"gender\":\"male\",\n    \"date_of_birth\": \"1988-04-04\",\n    \"country_identity\": {\n        \"type\": \"bvn\",\n        \"number\": \"11111111111\",\n        \"country\":\"NG\"\n    },\n    \"address\": {\n        \"street\": \"No 14, Kora street\",\n        \"city\": \"Lekki\",\n        \"state\": \"Lagos\",\n        \"country\": \"NG\",\n        \"zip_code\": \"101566\"\n    },\n    \"identity\": {\n        \"type\": \"nin\",\n        \"number\": \"11111111111\",\n        \"country\": \"NG\",\n        \"id_front_reference\":\"cardholder-id-front-ref-01\",\n        \"id_back_reference\":\"cardholder-id-back-ref-01\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/cardholders"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Cardholder created successfully\",\n    \"data\": {\n        \"reference\": \"KPY-CH-vWh0saT4eb1mX6V\",\n        \"validation_status\": \"success\",\n        \"first_name\": \"James\",\n        \"last_name\": \"Conrad\",\n        \"email\": \"testing@korapay.com\",\n        \"phone_number\": \"+2348000191000\",\n        \"date_of_birth\": \"1988-04-04T00:00:00.000Z\",\n        \"selfie_reference\": \"cardholder-ref-01\",\n        \"address\": {\n            \"street\": \"No 14, Kora street\",\n            \"city\": \"Lekki\",\n            \"state\": \"Lagos\",\n            \"country\": \"NG\",\n            \"zip_code\": \"101566\"\n        },\n        \"country_identity\": {\n            \"type\": \"bvn\",\n            \"country\": \"NG\",\n            \"number\": \"11111111111\"\n        },\n        \"identity\": {\n            \"type\": \"nin\",\n            \"number\": \"11111111111\",\n            \"country\": \"NG\",\n            \"id_front_reference\": \"cardholder-id-front-ref-01\",\n            \"id_back_reference\": \"cardholder-id-front-ref-01\"\n        }\n    }\n}"},{"id":"5398b414-e066-4b23-b597-c06026cfd7d3","name":"Create cardholder - Duplicate cardholder","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"first_name\": \"John\",\n    \"last_name\": \"Doe\",\n    \"email\": \"jdoe@test.com\",\n    \"phone_number\": \"2348000191000\",\n    \"selfie_reference\":\"cardholder-ref-01\",\n    \"gender\":\"male\",\n    \"date_of_birth\": \"1988-04-04\",\n    \"country_identity\": {\n        \"type\": \"bvn\",\n        \"number\": \"11111111111\",\n        \"country\":\"NG\"\n    },\n    \"address\": {\n        \"street\": \"No 14, Kora street\",\n        \"city\": \"Lekki\",\n        \"state\": \"Lagos\",\n        \"country\": \"NG\",\n        \"zip_code\": \"101566\"\n    },\n    \"identity\": {\n        \"type\": \"nin\",\n        \"number\": \"11111111111\",\n        \"country\": \"NG\",\n        \"id_front_reference\":\"cardholder-id-front-ref-01\",\n        \"id_back_reference\":\"cardholder-id-back-ref-01\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/cardholders"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Cardholder with email \\\"johndoe@korapay.com\\\" already exists\",\n    \"data\": {}\n}"},{"id":"2ce9a3b5-7764-4f61-b533-9d12fe773245","name":"Create cardholder - Request Validation error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"first_name\": \"John\",\n    \"last_name\": \"Doe\",\n    \"email\": \"jdoe@test.com\",\n    \"phone_number\": \"2348000191000\",\n    \"selfie_reference\":\"cardholder-ref-01\",\n    \"gender\":\"male\",\n    \"date_of_birth\": \"1988-04-04\",\n    \"country_identity\": {\n        \"type\": \"bvn\",\n        \"number\": \"11111111111\",\n        \"country\":\"NG\"\n    },\n    \"address\": {\n        \"street\": \"No 14, Kora street\",\n        \"city\": \"Lekki\",\n        \"state\": \"Lagos\",\n        \"country\": \"NG\",\n        \"zip_code\": \"101566\"\n    },\n    \"identity\": {\n        \"type\": \"nin\",\n        \"number\": \"11111111111\",\n        \"country\": \"NG\",\n        \"id_front_reference\":\"cardholder-id-front-ref-01\",\n        \"id_back_reference\":\"cardholder-id-back-ref-01\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/cardholders"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"validation_error\",\n    \"message\": \"It seems there`s an issue with your input. Please correct it and try again.\",\n    \"data\": {\n        \"first_name\": {\n            \"message\": \"first_name is not allowed to be empty\"\n        }\n    }\n}"}],"_postman_id":"7d2e7296-e26b-4eb0-a8cd-2f2506708e6a"},{"name":"Update cardholder","id":"54d0c5a6-65dd-4a29-92df-a80143c774ab","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n    \"first_name\": \"test_name\",\n    \"last_name\": \"test_name\",\n    \"email\": \"test@test.com\",\n    \"phone_number\": \"2348060579682\",\n    \"date_of_birth\": \"1979-04-04\",\n    \"gender\": \"male\",\n    \"selfie_reference\":\"test-selfie-ref-1\",\n    \"id_front_reference\":\"test-front-ref-1\",\n    \"id_back_reference\":\"test-back-ref-1\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/cardholders/:cardholderReference","description":"<p>This endpoint is used to create a cardholder</p>\n<h2 id=\"request-body\">Request Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Types</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>first_name</td>\n<td>string</td>\n<td><code>Optional</code> first name of the cardholder</td>\n</tr>\n<tr>\n<td>last_name</td>\n<td>string</td>\n<td><code>Optional</code> last name of cardholder</td>\n</tr>\n<tr>\n<td>email</td>\n<td>string</td>\n<td><code>Optional</code> email of cardholder</td>\n</tr>\n<tr>\n<td>phone_number</td>\n<td>string</td>\n<td><code>Optional</code> phone number of cardholder</td>\n</tr>\n<tr>\n<td>gender</td>\n<td>string</td>\n<td><code>Optional</code> Can be any of <code>male</code> or <code>female</code></td>\n</tr>\n<tr>\n<td>selfie_reference</td>\n<td>string</td>\n<td><code>Optional</code> reference of uploaded selfie image</td>\n</tr>\n<tr>\n<td>date_of_birth</td>\n<td>string</td>\n<td><code>Optional</code> date of birth of cardholder</td>\n</tr>\n<tr>\n<td>identity.id_front_reference</td>\n<td>string</td>\n<td><code>Optional</code> reference of uploaded front Id image</td>\n</tr>\n<tr>\n<td>identity.id_back_reference</td>\n<td>string</td>\n<td><code>Optional</code> reference of uploaded back Id image</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","cardholders",":cardholderReference"],"host":["https://api.korapay.com"],"query":[],"variable":[{"id":"0f054394-aa99-4a8f-82b3-33eb6b48e201","type":"any","value":"KPY-CH-96test1R06n4uyT7p","key":"cardholderReference"}]}},"response":[{"id":"6588abc0-bc8e-4885-98c6-af21c77098bd","name":"Update cardholder - Success","originalRequest":{"method":"PATCH","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n    \"first_name\": \"Updated\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.korapay.com/merchant/api/v1/cardholders/:cardholderReferecnce","host":["https://api.korapay.com"],"path":["merchant","api","v1","cardholders",":cardholderReferecnce"],"variable":[{"key":"cardholderReferecnce","value":"KPY-CH-96test1R06n4uyT7p"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Cardholder updated successfully\"\n}\n"}],"_postman_id":"54d0c5a6-65dd-4a29-92df-a80143c774ab"},{"name":"Get Cardholders","id":"dfb286e2-5cae-4149-ba80-5e901dec27f0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/cardholders","description":"<p>This endpoint is used to fetch all cardholders</p>\n","urlObject":{"path":["merchant","api","v1","cardholders"],"host":["https://api.korapay.com"],"query":[{"disabled":true,"key":"email","value":"test@test.com"},{"disabled":true,"key":"reference","value":"KPY-CH-1234sheysia"}],"variable":[]}},"response":[{"id":"ec6645e1-d959-43aa-90d2-5a5e13016d54","name":"Get Cardholders","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n    \"first_name\": \"Updated\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.korapay.com/merchant/api/v1/cardholders?email=test@test.com&reference=KPY-CH-1234sheysia","host":["https://api.korapay.com"],"path":["merchant","api","v1","cardholders"],"query":[{"key":"email","value":"test@test.com"},{"key":"reference","value":"KPY-CH-1234sheysia"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Cardholders retrieved successfully\",\n    \"data\": {\n        \"data\": [\n            {\n                \"status\": \"active\",\n                \"reference\": \"KPY-CH-7y7xnskeksaDNKvmVgU\",\n                \"first_name\": \"Jane\",\n                \"last_name\": \"Doe\",\n                \"email\": \"janedoe@test.com\",\n                \"phone_number\": \"+2349034782938\",\n                \"gender\": \"female\",\n                \"address\": {\n                    \"city\": \"Lekki\",\n                    \"state\": \"Lagos\",\n                    \"street\": \"No 14, Kora street\",\n                    \"country\": \"NG\",\n                    \"zip_code\": \"101566\"\n                },\n                \"identity\": {\n                    \"type\": \"nin\",\n                    \"number\": \"11111111111\"\n                }\n            },\n            {\n                \"status\": \"active\",\n                \"reference\": \"KPY-CH-9hApwsaKCHaaMIbU\",\n                \"first_name\": \"John\",\n                \"last_name\": \"Doe\",\n                \"email\": \"johndoe@korapay.com\",\n                \"phone_number\": \"+2348056789072\",\n                \"gender\": \"male\",\n                \"address\": {\n                    \"city\": \"Lekki\",\n                    \"state\": \"Lagos\",\n                    \"street\": \"No 14, Kora street\",\n                    \"country\": \"NG\",\n                    \"zip_code\": \"101566\"\n                },\n                \"identity\": {\n                    \"type\": \"nin\",\n                    \"number\": \"11111111111\"\n                }\n            }\n        ],\n        \"paging\": {\n            \"total_items\": 2,\n            \"page_size\": 10,\n            \"current\": 1,\n            \"count\": 2\n        }\n    }\n}"}],"_postman_id":"dfb286e2-5cae-4149-ba80-5e901dec27f0"},{"name":"Get Cardholder","id":"a3b8d642-0870-45f5-b03a-88f32056d015","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/cardholders/:cardholderReference","description":"<p>This endpoint is used to fetch a single cardholder by reference</p>\n","urlObject":{"path":["merchant","api","v1","cardholders",":cardholderReference"],"host":["https://api.korapay.com"],"query":[],"variable":[{"id":"8b3025a2-1889-4dd6-98ac-f13f8d189aca","type":"any","value":"KPY-CH-7y7xnskeksaDNKvmVgU","key":"cardholderReference"}]}},"response":[{"id":"89f38a05-d8dd-4a9d-b942-d92f9d9a74b2","name":"Get Cardholder","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n    \"first_name\": \"Updated\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.korapay.com/merchant/api/v1/cardholders/:cardholderReference","host":["https://api.korapay.com"],"path":["merchant","api","v1","cardholders",":cardholderReference"],"variable":[{"key":"cardholderReference","value":"KPY-CH-7y7xnskeksaDNKvmVgU"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Cardholder retrieved successfully\",\n    \"data\": {\n        \"status\": \"active\",\n        \"reference\": \"KPY-CH-7y7xnskeksaDNKvmVgU\",\n        \"first_name\": \"Jane\",\n        \"last_name\": \"Doe\",\n        \"email\": \"janedoe@test.com\",\n        \"phone_number\": \"+2349034782938\",\n        \"gender\": \"female\",\n        \"address\": {\n            \"city\": \"Lekki\",\n            \"state\": \"Lagos\",\n            \"street\": \"No 14, Kora street\",\n            \"country\": \"NG\",\n            \"zip_code\": \"101566\"\n        },\n        \"identity\": {\n            \"type\": \"nin\",\n            \"number\": \"11111111111\"\n        }\n    }\n}"}],"_postman_id":"a3b8d642-0870-45f5-b03a-88f32056d015"}],"id":"627f69ec-5c65-40dc-bd5c-da9cf8525fc1","description":"<p>This folder captures cardholder endpoints</p>\n","_postman_id":"627f69ec-5c65-40dc-bd5c-da9cf8525fc1"},{"name":"Transactions","item":[{"name":"Get card transactions","id":"70ac1ff5-8112-487a-adc3-7334bf69c4d2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"sk_******"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.korapay.com/merchant/api/v1/cards/:cardReference/transactions","description":"<p>This endpoint is used to fetch all transactions performed using a particular card.</p>\n<h2 id=\"successful-response-body\">Successful Response Body</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>request status</td>\n</tr>\n<tr>\n<td>message</td>\n<td>string</td>\n<td>request status message</td>\n</tr>\n<tr>\n<td>data</td>\n<td>object</td>\n<td>captures the transactions data array</td>\n</tr>\n<tr>\n<td>data.data</td>\n<td>array</td>\n<td>The array contains card transaction objects where each object has the information of a transaction such as <code>reference</code>, <code>amount</code>, <code>fee</code>, <code>currency</code>, <code>card_holder_name, description</code>, <code>balance_after</code>, <code>type</code>, <code>status</code>, <code>date</code></td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","cards",":cardReference","transactions"],"host":["https://api.korapay.com"],"query":[{"disabled":true,"key":"status","value":"success"},{"disabled":true,"key":"start_date","value":"2024-04-06"},{"disabled":true,"key":"end_date","value":"2025-03-01"},{"disabled":true,"key":"type ","value":"card_funding"}],"variable":[{"id":"1f35e5b8-77df-4770-8399-348444befd6e","type":"any","value":"226zxcb8f-f0cb-562f-a5e8-4uht01UIcVhjydur","key":"cardReference"}]}},"response":[{"id":"840b07a3-cdd8-4342-8cf8-f90b4245d2b9","name":"Get card transactions - Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/merchant/api/v1/cards/:cardReference/transactions","host":["https://api.korapay.com"],"path":["merchant","api","v1","cards",":cardReference","transactions"],"query":[{"key":"status","value":"success","disabled":true}],"variable":[{"key":"cardReference","value":"293df12i-f0cu-577f-a1e0-4vht9OUAc9jtest8"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Card transactions retrieved successfully\",\n    \"data\": {\n        \"data\": [\n            {\n                \"reference\": \"your-reference-id1\",\n                \"amount\": 4,\n                \"fee\": \"1.00\",\n                \"currency\": \"USD\",\n                \"cross_currency\": false,\n                \"card_holder_name\": \"John Doe\",\n                \"description\": \"test money\",\n                \"balance_after\": 5,\n                \"type\": \"card_withdrawal\",\n                \"status\": \"success\",\n                \"date\": \"2025-03-13T00:19:21.000Z\"\n            },\n            {\n                \"reference\": \"your-reference-id2\",\n                \"amount\": 5,\n                \"fee\": \"0.13\",\n                \"currency\": \"USD\",\n                \"cross_currency\": false,\n                \"card_holder_name\": \"Jane Doe\",\n                \"description\": \"fund money\",\n                \"balance_after\": 10,\n                \"type\": \"card_funding\",\n                \"status\": \"success\",\n                \"date\": \"2025-03-12T23:50:21.000Z\"\n            },\n            {\n                \"reference\": \"your-reference-id3\",\n                \"amount\": 5,\n                \"fee\": \"1.00\",\n                \"currency\": \"USD\",\n                \"cross_currency\": false,\n                \"card_holder_name\": \"Francis Mike\",\n                \"description\": \"Card creation\",\n                \"balance_after\": 5,\n                \"type\": \"card_creation\",\n                \"status\": \"success\",\n                \"date\": \"2025-03-12T09:47:07.000Z\"\n            }\n        ]\n    }\n}"}],"_postman_id":"70ac1ff5-8112-487a-adc3-7334bf69c4d2"}],"id":"5b2d3948-17b4-4bff-9cf2-dcaffa228ac4","description":"<p>This folder captures card transaction endpoints</p>\n","_postman_id":"5b2d3948-17b4-4bff-9cf2-dcaffa228ac4"}],"id":"1d4b55e6-6324-41e8-88e3-be43e0a7dde5","description":"<p>This section of the documentation contains API requests and responses for the card issuance</p>\n","_postman_id":"1d4b55e6-6324-41e8-88e3-be43e0a7dde5"},{"name":"Miscellaneous","item":[{"name":"List Banks","event":[{"listen":"test","script":{"id":"d5581a89-ac4c-4e36-8884-8ca22856f839","exec":["pm.test(\"Your test name\", function () {","    var jsonData = pm.response.json();","    console.log(jsonData);","    const banks = jsonData.data;","    banks.forEach(bank => {","        if (bank.code.length != 3) {","            console.log(bank.name)","        }","    })","});"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"82cbd8bc-00a2-4ed4-8c64-a10654e31ea6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"pk_live_f2AjfQGDFwoNmPaz8En7W6wU2n21QpW1jBt6NYLF"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.korapay.com/merchant/api/v1/misc/banks?countryCode=NG","description":"<h3 id=\"get-a-list-of-all-supported-banks-and-their-properties\">Get a list of all supported banks and their properties</h3>\n<p>This endpoint returns all supported banks.</p>\n<h4 id=\"supported-country-and-their-country-code\">Supported Country and their country code</h4>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>Nigeria        = 'NG'  // Currency: NGN (Nigerian Naira)\nKenya          = 'KE'  // Currency: KES (Kenyan Shilling)\nSouthAfrica    = 'ZA'  // Currency: ZAR (South African Rand)\nEgypt          = 'EG'  // Currency: EGP (Egyptian Pound)\nUnited States  = 'US'  // Currency: USD (United State Dollars)\nGreat Britain  = 'GB'  // Currency: GBP (Great Britain Pounds)\n\n</code></pre>","urlObject":{"path":["merchant","api","v1","misc","banks"],"host":["https://api.korapay.com"],"query":[{"key":"countryCode","value":"NG"}],"variable":[]}},"response":[{"id":"88367e6a-6930-49e6-a586-ea35ecd65e7e","name":"List Banks - Success","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer pk_***","description":"API public key"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.korapay.com/merchant/api/v1/misc/banks?countryCode=NG","host":["https://api.korapay.com"],"path":["merchant","api","v1","misc","banks"],"query":[{"key":"countryCode","value":"NG"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 19 May 2022 12:05:42 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"6c1f-8/rCq1wIVLzpLQ75vnRLjMnhtWQ\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Content-Encoding","value":"gzip"},{"key":"Cache-Control","value":"no-store"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Content-Security-Policy","value":"frame-ancestors 'none'"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Expect-CT","value":"max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\""},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"70dcb3cb78737562-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Successful\",\n    \"data\": [\n        {\n            \"name\": \" AL-Barakah Microfinance Bank\",\n            \"slug\": \"al-barakah-mfb\",\n            \"code\": \"090133\",\n            \"nibss_bank_code\": \"090133\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"9 Payment Service Bank\",\n            \"slug\": \"9payment\",\n            \"code\": \"000802\",\n            \"nibss_bank_code\": \"000802\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"AB Microfinance Bank\",\n            \"slug\": \"ab-mfb\",\n            \"code\": \"090270\",\n            \"nibss_bank_code\": \"090270\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Abbey Mortgage Bank\",\n            \"slug\": \"abbey-mb\",\n            \"code\": \"070010\",\n            \"nibss_bank_code\": \"070010\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Above Only Microfinance Bank\",\n            \"slug\": \"above-only-mfb\",\n            \"code\": \"090260\",\n            \"nibss_bank_code\": \"090260\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"ABU Microfinance Bank\",\n            \"slug\": \"abu-mfb\",\n            \"code\": \"090197\",\n            \"nibss_bank_code\": \"090197\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Access Bank Nigeria\",\n            \"slug\": \"access\",\n            \"code\": \"044\",\n            \"nibss_bank_code\": \"000014\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Access Bank Plc (Diamond)\",\n            \"slug\": \"diamond\",\n            \"code\": \"063\",\n            \"nibss_bank_code\": \"000005\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"ACCESS MOBILE\",\n            \"slug\": \"access-mobile\",\n            \"code\": \"323\",\n            \"nibss_bank_code\": null,\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Access Money\",\n            \"slug\": \"access-money\",\n            \"code\": \"927\",\n            \"nibss_bank_code\": \"100013\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Access Yello &amp; Beta\",\n            \"slug\": \"access-yellow\",\n            \"code\": \"100052\",\n            \"nibss_bank_code\": \"100052\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Accion Microfinance Bank\",\n            \"slug\": \"accion-mfb\",\n            \"code\": \"090134\",\n            \"nibss_bank_code\": \"090134\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Addosser Microfinance Bank\",\n            \"slug\": \"addosser-mfb\",\n            \"code\": \"090160\",\n            \"nibss_bank_code\": \"090160\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Adeyemi College Staff Microfinance Bank\",\n            \"slug\": \"adeyemi-mfb\",\n            \"code\": \"090268\",\n            \"nibss_bank_code\": \"090268\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"AG Mortgage Bank\",\n            \"slug\": \"ag-mb\",\n            \"code\": \"100028\",\n            \"nibss_bank_code\": \"100028\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Al-Hayat Microfinance Bank\",\n            \"slug\": \"al-hayat-mfb\",\n            \"code\": \"090277\",\n            \"nibss_bank_code\": \"090277\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Alekun Microfinance Bank\",\n            \"slug\": \"alekun-mfb\",\n            \"code\": \"090259\",\n            \"nibss_bank_code\": \"090259\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Alert MFB\",\n            \"slug\": \"alert-mfb\",\n            \"code\": \"090297\",\n            \"nibss_bank_code\": \"090297\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Allworkers Microfinance Bank\",\n            \"slug\": \"allworkers-mfb\",\n            \"code\": \"090131\",\n            \"nibss_bank_code\": \"090131\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Alpha Kapital Microfinance Bank\",\n            \"slug\": \"alpha-kapital-mfb\",\n            \"code\": \"090169\",\n            \"nibss_bank_code\": \"090169\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"AMJU Unique Microfinance Bank\",\n            \"slug\": \"amju-unique-mfb\",\n            \"code\": \"090180\",\n            \"nibss_bank_code\": \"090180\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"AMML Micro-finance Bank\",\n            \"slug\": \"amml-mfb\",\n            \"code\": \"914\",\n            \"nibss_bank_code\": \"090116\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Apeks Microfinance Bank\",\n            \"slug\": \"apeks-mfb\",\n            \"code\": \"090143\",\n            \"nibss_bank_code\": \"090143\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Arise MFB\",\n            \"slug\": \"arise-mfb\",\n            \"code\": \"090282\",\n            \"nibss_bank_code\": \"090282\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Aso Savings and Loans\",\n            \"slug\": \"aso-savings\",\n            \"code\": \"401\",\n            \"nibss_bank_code\": \"090001\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Astrapolaris Microfinance Bank\",\n            \"slug\": \"astrapolaris-mfb\",\n            \"code\": \"090172\",\n            \"nibss_bank_code\": \"090172\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Auchi Microfinance Bank\",\n            \"slug\": \"auchi-mfb\",\n            \"code\": \"090264\",\n            \"nibss_bank_code\": \"090264\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Baines Credit Microfinance Bank\",\n            \"slug\": \"baines-mfb\",\n            \"code\": \"090188\",\n            \"nibss_bank_code\": \"090188\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Balogun Gambari MFB\",\n            \"slug\": \"balogun-mfb\",\n            \"code\": \"090326\",\n            \"nibss_bank_code\": \"090326\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Bayero MICROFINANCE BANK\",\n            \"slug\": \"bayero-mfb\",\n            \"code\": \"090316\",\n            \"nibss_bank_code\": \"090316\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"BC Kash Microfinance Bank\",\n            \"slug\": \"bc-kash-mfb\",\n            \"code\": \"090127\",\n            \"nibss_bank_code\": \"090127\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"BIPC MICROFINANCE BANK\",\n            \"slug\": \"bipc-mfb\",\n            \"code\": \"090336\",\n            \"nibss_bank_code\": \"090336\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"BOCTrust Micro-finance Bank\",\n            \"slug\": \"boc-trust-mfb\",\n            \"code\": \"952\",\n            \"nibss_bank_code\": \"090117\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Bosak Microfinance Bank\",\n            \"slug\": \"bosak-mfb\",\n            \"code\": \"090176\",\n            \"nibss_bank_code\": \"090176\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Bowen Microfinance Bank\",\n            \"slug\": \"bowen-mfb\",\n            \"code\": \"090148\",\n            \"nibss_bank_code\": \"090148\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Brent Mortgage Bank\",\n            \"slug\": \"brent-mb\",\n            \"code\": \"070015\",\n            \"nibss_bank_code\": \"070015\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"BRETHREN MICROFINANCE BANK\",\n            \"slug\": \"brethren-mfb\",\n            \"code\": \"090293\",\n            \"nibss_bank_code\": \"090293\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"BRIDGEWAY MICROFINANCE BANK\",\n            \"slug\": \"bridgeway-mfb\",\n            \"code\": \"090393\",\n            \"nibss_bank_code\": \"090393\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Brightway MFB\",\n            \"slug\": \"brightway-mfb\",\n            \"code\": \"090308\",\n            \"nibss_bank_code\": \"090308\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Cellulant\",\n            \"slug\": \"cellulant\",\n            \"code\": \"919\",\n            \"nibss_bank_code\": \"100005\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"CEMCS Microfinance Bank\",\n            \"slug\": \"cems-mfb\",\n            \"code\": \"090154\",\n            \"nibss_bank_code\": \"090154\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Chams Mobile\",\n            \"slug\": \"chams-mobile\",\n            \"code\": \"929\",\n            \"nibss_bank_code\": null,\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Chikum Microfinance Bank\",\n            \"slug\": \"chikum-mfb\",\n            \"code\": \"090141\",\n            \"nibss_bank_code\": \"090141\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"CIT Microfinance Bank\",\n            \"slug\": \"cit-mfb\",\n            \"code\": \"090144\",\n            \"nibss_bank_code\": \"090144\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Citi Bank\",\n            \"slug\": \"citibankng\",\n            \"code\": \"023\",\n            \"nibss_bank_code\": \"000009\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Consumer Microfinance Bank\",\n            \"slug\": \"consumer-mfb\",\n            \"code\": \"090130\",\n            \"nibss_bank_code\": \"090130\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Contec Global Infotech Limited (NowNow)\",\n            \"slug\": \"contec-global\",\n            \"code\": \"100032\",\n            \"nibss_bank_code\": \"100032\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Coronation Merchant Bank\",\n            \"slug\": \"cmfb\",\n            \"code\": \"559\",\n            \"nibss_bank_code\": \"060001\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Covenant Micro-finance Bank\",\n            \"slug\": \"covenant-mfb\",\n            \"code\": \"949\",\n            \"nibss_bank_code\": \"070006\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Credit Afrique Microfinance Bank\",\n            \"slug\": \"credit-afrique-mfb\",\n            \"code\": \"090159\",\n            \"nibss_bank_code\": \"090159\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Daylight Microfinance Bank\",\n            \"slug\": \"daylight-mfb\",\n            \"code\": \"090167\",\n            \"nibss_bank_code\": \"090167\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"e-Barcs Microfinance Bank\",\n            \"slug\": \"e-barcs-mfb\",\n            \"code\": \"090156\",\n            \"nibss_bank_code\": \"090156\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Eagle Flight MFB\",\n            \"slug\": \"eagle-flight-mfb\",\n            \"code\": \"090294\",\n            \"nibss_bank_code\": \"090294\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Eartholeum\",\n            \"slug\": \"eartholeum\",\n            \"code\": \"935\",\n            \"nibss_bank_code\": \"100021\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Ecobank\",\n            \"slug\": \"eco\",\n            \"code\": \"050\",\n            \"nibss_bank_code\": \"000010\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Ecobank Express Account\",\n            \"slug\": \"ecobank-express-account\",\n            \"code\": \"922\",\n            \"nibss_bank_code\": \"100008\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Ecobank Mobile\",\n            \"slug\": \"ecobank-mobile\",\n            \"code\": \"307\",\n            \"nibss_bank_code\": null,\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Edfin MFB\",\n            \"slug\": \"edfin-mfb\",\n            \"code\": \"090310\",\n            \"nibss_bank_code\": \"090310\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Ekondo MFB\",\n            \"slug\": \"ekondo-mfb\",\n            \"code\": \"090097\",\n            \"nibss_bank_code\": \"090097\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Emeralds Microfinance Bank\",\n            \"slug\": \"emeral-mfb\",\n            \"code\": \"090273\",\n            \"nibss_bank_code\": \"090273\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Empire Trust Micro-finance Bank\",\n            \"slug\": \"empire-trust-mfb\",\n            \"code\": \"913\",\n            \"nibss_bank_code\": \"090114\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Enterprise Bank\",\n            \"slug\": \"enterprise\",\n            \"code\": \"084\",\n            \"nibss_bank_code\": \"000019\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Esan Microfinance Bank\",\n            \"slug\": \"esan-mfb\",\n            \"code\": \"090189\",\n            \"nibss_bank_code\": \"090189\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Eso-E Microfinance Bank\",\n            \"slug\": \"eso-e-mfb\",\n            \"code\": \"090166\",\n            \"nibss_bank_code\": \"090166\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"eTRANZACT\",\n            \"slug\": \"e-tranzact\",\n            \"code\": \"920\",\n            \"nibss_bank_code\": \"100006\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Evangel MFB\",\n            \"slug\": \"evangel-mfb\",\n            \"code\": \"090304\",\n            \"nibss_bank_code\": \"090304\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Evergreen MICROFINANCE BANK\",\n            \"slug\": \"evergreen-mfb\",\n            \"code\": \"090332\",\n            \"nibss_bank_code\": \"090332\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Eyowo MFB\",\n            \"slug\": \"eyowo-mfb\",\n            \"code\": \"090328\",\n            \"nibss_bank_code\": \"090328\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"FAST Microfinance Bank\",\n            \"slug\": \"fast-mfb\",\n            \"code\": \"090179\",\n            \"nibss_bank_code\": \"090179\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"FBN MOBILE\",\n            \"slug\": \"first-mobile\",\n            \"code\": \"309\",\n            \"nibss_bank_code\": null,\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"FBN Mortgages Limited\",\n            \"slug\": \"fbn-mortgages-ltd\",\n            \"code\": \"090107\",\n            \"nibss_bank_code\": \"090107\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"FBNQuest Merchant Bank\",\n            \"slug\": \"fbnquest-meb\",\n            \"code\": \"911\",\n            \"nibss_bank_code\": \"060002\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"FCMB Easy Account\",\n            \"slug\": \"fcmb-easy-account\",\n            \"code\": \"100031\",\n            \"nibss_bank_code\": \"100031\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"FCMB Plc\",\n            \"slug\": \"fcmb\",\n            \"code\": \"214\",\n            \"nibss_bank_code\": \"000003\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"FCT MFB\",\n            \"slug\": \"fct-mfb\",\n            \"code\": \"090290\",\n            \"nibss_bank_code\": \"090290\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"FEDERAL UNIVERSITY DUTSE MICROFINANCE BANK\",\n            \"slug\": \"fed-uni-duste-mfb\",\n            \"code\": \"090318\",\n            \"nibss_bank_code\": \"090318\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"FederalPoly NasarawaMFB\",\n            \"slug\": \"federalPoly-nasarawa-mfb\",\n            \"code\": \"090298\",\n            \"nibss_bank_code\": \"090298\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"FETS\",\n            \"slug\": \"fets\",\n            \"code\": \"915\",\n            \"nibss_bank_code\": \"100001\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"FFS Microfinance Bank\",\n            \"slug\": \"ffs-mfb\",\n            \"code\": \"090153\",\n            \"nibss_bank_code\": \"090153\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Fidelity Bank\",\n            \"slug\": \"fidelity\",\n            \"code\": \"070\",\n            \"nibss_bank_code\": \"000007\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Fidelity Mobile\",\n            \"slug\": \"Fidelity-mobile\",\n            \"code\": \"933\",\n            \"nibss_bank_code\": \"100019\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Fidfund Microfinance Bank\",\n            \"slug\": \"fidfund-mfb\",\n            \"code\": \"090126\",\n            \"nibss_bank_code\": \"090126\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"FINATRUST MICROFINANCE BANK\",\n            \"slug\": \"finatrust-mfb\",\n            \"code\": \"090111\",\n            \"nibss_bank_code\": \"090111\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Firmus MFB\",\n            \"slug\": \"firmus-mfb\",\n            \"code\": \"090366\",\n            \"nibss_bank_code\": \"090366\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"First Bank of Nigeria\",\n            \"slug\": \"firstbank\",\n            \"code\": \"011\",\n            \"nibss_bank_code\": \"000016\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"First Generation Mortgage Bank\",\n            \"slug\": \"first-gen-mb\",\n            \"code\": \"070014\",\n            \"nibss_bank_code\": \"070014\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"First Multiple MFB\",\n            \"slug\": \"first-multiple-mfb\",\n            \"code\": \"090163\",\n            \"nibss_bank_code\": \"090163\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"First Option MFB\",\n            \"slug\": \"first-option-mfb\",\n            \"code\": \"090285\",\n            \"nibss_bank_code\": \"090285\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"First Royal Microfinance Bank\",\n            \"slug\": \"first-royal-mfb\",\n            \"code\": \"090164\",\n            \"nibss_bank_code\": \"090164\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"First Trust Mortgage Bank Plc\",\n            \"slug\": \"first-trust-mob\",\n            \"code\": \"910\",\n            \"nibss_bank_code\": null,\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"FirstMonie Wallet\",\n            \"slug\": \"firstMonie-wallet\",\n            \"code\": \"928\",\n            \"nibss_bank_code\": \"100014\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Flutterwave Technology Solutions Limited\",\n            \"slug\": \"flutterwave\",\n            \"code\": \"110002\",\n            \"nibss_bank_code\": \"110002\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Fortis Micro-finance Bank\",\n            \"slug\": \"fortis-mfb\",\n            \"code\": \"948\",\n            \"nibss_bank_code\": \"070002\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Fortis Mobile\",\n            \"slug\": \"fortis-mobile\",\n            \"code\": \"930\",\n            \"nibss_bank_code\": \"100016\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"FSDH Merchant Bank\",\n            \"slug\": \"fsdh\",\n            \"code\": \"601\",\n            \"nibss_bank_code\": \"400001\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Fullrange Microfinance Bank\",\n            \"slug\": \"fullrange-mfb\",\n            \"code\": \"090145\",\n            \"nibss_bank_code\": \"090145\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Futo Microfinance Bank\",\n            \"slug\": \"futo-mfb\",\n            \"code\": \"090158\",\n            \"nibss_bank_code\": \"090158\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Gashua Microfinance Bank\",\n            \"slug\": \"gashua-mfb\",\n            \"code\": \"090168\",\n            \"nibss_bank_code\": \"090168\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Gateway Mortgage Bank\",\n            \"slug\": \"gateway-mb\",\n            \"code\": \"070009\",\n            \"nibss_bank_code\": \"070009\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Globus Bank\",\n            \"slug\": \"globus-bank\",\n            \"code\": \"103\",\n            \"nibss_bank_code\": \"000027\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Glory MFB\",\n            \"slug\": \"glory-mfb\",\n            \"code\": \"090278\",\n            \"nibss_bank_code\": \"090278\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"GoMoney\",\n            \"slug\": \"go-money\",\n            \"code\": \"100022\",\n            \"nibss_bank_code\": \"100022\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Gowans Microfinance Bank\",\n            \"slug\": \"gowans-mfb\",\n            \"code\": \"090122\",\n            \"nibss_bank_code\": \"090122\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"GreenBank Microfinance Bank\",\n            \"slug\": \"greenbank-mfb\",\n            \"code\": \"090178\",\n            \"nibss_bank_code\": \"090178\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Greenville Microfinance Bank\",\n            \"slug\": \"greenville-mfb\",\n            \"code\": \"090269\",\n            \"nibss_bank_code\": \"090269\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Greenwich Merchant Bank\",\n            \"slug\": \"greenwich-mb\",\n            \"code\": \"060004\",\n            \"nibss_bank_code\": \"060004\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Grooming Microfinance Bank\",\n            \"slug\": \"grooming-mfb\",\n            \"code\": \"090195\",\n            \"nibss_bank_code\": \"090195\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"GT MOBILE\",\n            \"slug\": \"gt-mobile\",\n            \"code\": \"923\",\n            \"nibss_bank_code\": \"100009\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"GTBank Mobile Money\",\n            \"slug\": \"gtb-mobile\",\n            \"code\": \"315\",\n            \"nibss_bank_code\": null,\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"GTBank Plc\",\n            \"slug\": \"gtb\",\n            \"code\": \"058\",\n            \"nibss_bank_code\": \"000013\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Hackman Microfinance Bank\",\n            \"slug\": \"hackman-mfb\",\n            \"code\": \"090147\",\n            \"nibss_bank_code\": \"090147\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Haggai Mortgage Bank Limited\",\n            \"slug\": \"haggai-mb\",\n            \"code\": \"070017\",\n            \"nibss_bank_code\": \"070017\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Hala MFB\",\n            \"slug\": \"hala-mfb\",\n            \"code\": \"090291\",\n            \"nibss_bank_code\": \"090291\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Hasal Micro-finance Bank\",\n            \"slug\": \"hasal-mfb\",\n            \"code\": \"958\",\n            \"nibss_bank_code\": \"090121\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Hedonmark\",\n            \"slug\": \"hedonmark\",\n            \"code\": \"931\",\n            \"nibss_bank_code\": \"100017\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Heritage Bank\",\n            \"slug\": \"heritage\",\n            \"code\": \"030\",\n            \"nibss_bank_code\": \"000020\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"IBILE Microfinance Bank\",\n            \"slug\": \"ibile-mfb\",\n            \"code\": \"090118\",\n            \"nibss_bank_code\": \"090118\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"IKENNE MFB\",\n            \"slug\": \"ikenne-mfb\",\n            \"code\": \"090324\",\n            \"nibss_bank_code\": \"090324\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Ikire MFB\",\n            \"slug\": \"ikire-mfb\",\n            \"code\": \"090279\",\n            \"nibss_bank_code\": \"090279\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Imo State Microfinance Bank\",\n            \"slug\": \"imo-state-mfb\",\n            \"code\": \"090258\",\n            \"nibss_bank_code\": \"090258\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Imperial Homes Mortgage Bank\",\n            \"slug\": \"imperial-homes-mob\",\n            \"code\": \"938\",\n            \"nibss_bank_code\": \"100024\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Infinity Microfinance Bank\",\n            \"slug\": \"infinity-mfb\",\n            \"code\": \"090157\",\n            \"nibss_bank_code\": \"090157\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Infinity Trust Mortgage Bank\",\n            \"slug\": \"infinity-mb\",\n            \"code\": \"070016\",\n            \"nibss_bank_code\": \"070016\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Innovectives Kesh\",\n            \"slug\": \"innovectives-kesh\",\n            \"code\": \"100029\",\n            \"nibss_bank_code\": \"100029\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Intellfin\",\n            \"slug\": \"intellfin\",\n            \"code\": \"941\",\n            \"nibss_bank_code\": \"100027\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"IRL Microfinance Bank\",\n            \"slug\": \"irl-mfb\",\n            \"code\": \"090149\",\n            \"nibss_bank_code\": \"090149\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"JAIZ Bank\",\n            \"slug\": \"jaiz\",\n            \"code\": \"301\",\n            \"nibss_bank_code\": \"000006\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Jubliee Life\",\n            \"slug\": \"jubliee-life\",\n            \"code\": \"906\",\n            \"nibss_bank_code\": \"090003\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Kadick Integration Limited\",\n            \"slug\": \"kadick-integration\",\n            \"code\": \"110008\",\n            \"nibss_bank_code\": \"110008\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Kadpoly MICROFINANCE BANK\",\n            \"slug\": \"kadpoly-mfb\",\n            \"code\": \"090320\",\n            \"nibss_bank_code\": \"090320\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"KCMB Microfinance Bank\",\n            \"slug\": \"kcmb-mfb\",\n            \"code\": \"090191\",\n            \"nibss_bank_code\": \"090191\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Kegow\",\n            \"slug\": \"kegow\",\n            \"code\": \"100015\",\n            \"nibss_bank_code\": \"100015\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Keystone Bank\",\n            \"slug\": \"keystone\",\n            \"code\": \"082\",\n            \"nibss_bank_code\": \"000002\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Kontagora MFB\",\n            \"slug\": \"kontagora-mfb\",\n            \"code\": \"090299\",\n            \"nibss_bank_code\": \"090299\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Kuda Micro-finance Bank\",\n            \"slug\": \"kuda-mfb\",\n            \"code\": \"50211\",\n            \"nibss_bank_code\": \"090267\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"La Fayette Microfinance Bank\",\n            \"slug\": \"la-fayette-mfb\",\n            \"code\": \"090155\",\n            \"nibss_bank_code\": \"090155\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Lagos Building Investment Company\",\n            \"slug\": \"lagos-building\",\n            \"code\": \"070012\",\n            \"nibss_bank_code\": \"070012\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Lapo Microfinance Bank\",\n            \"slug\": \"lapo-mfb\",\n            \"code\": \"090177\",\n            \"nibss_bank_code\": \"090177\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Lavender Microfinance Bank\",\n            \"slug\": \"lavender-mfb\",\n            \"code\": \"090271\",\n            \"nibss_bank_code\": \"090271\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Letshego MFB\",\n            \"slug\": \"letshego-mfb\",\n            \"code\": \"090420\",\n            \"nibss_bank_code\": \"090420\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Lovonus Microfinance Bank\",\n            \"slug\": \"lovonus-mfb\",\n            \"code\": \"090265\",\n            \"nibss_bank_code\": \"090265\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"M36\",\n            \"slug\": \"m36\",\n            \"code\": \"100035\",\n            \"nibss_bank_code\": \"100035\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Mainland MICROFINANCE BANK\",\n            \"slug\": \"mainland-mfb\",\n            \"code\": \"090323\",\n            \"nibss_bank_code\": \"090323\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Mainstreet Micro-finance Bank\",\n            \"slug\": \"mainstreet-mfb\",\n            \"code\": \"014\",\n            \"nibss_bank_code\": \"090171\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Malachy Microfinance Bank\",\n            \"slug\": \"malachy-mfb\",\n            \"code\": \"090174\",\n            \"nibss_bank_code\": \"090174\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Manny Microfinance bank\",\n            \"slug\": \"manny-mfb\",\n            \"code\": \"090383\",\n            \"nibss_bank_code\": \"090383\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"MAUTECH Microfinance Bank\",\n            \"slug\": \"mautech-mfb\",\n            \"code\": \"090423\",\n            \"nibss_bank_code\": \"090423\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Mayfair MFB\",\n            \"slug\": \"mayfair-mfb\",\n            \"code\": \"090321\",\n            \"nibss_bank_code\": \"090321\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"MayFresh Mortgage Bank\",\n            \"slug\": \"mayFresh-mortgage\",\n            \"code\": \"070019\",\n            \"nibss_bank_code\": \"070019\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Megapraise Microfinance Bank\",\n            \"slug\": \"megapraise-mfb\",\n            \"code\": \"090280\",\n            \"nibss_bank_code\": \"090280\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Meridian MFB\",\n            \"slug\": \"meridian-mfb\",\n            \"code\": \"090275\",\n            \"nibss_bank_code\": \"090275\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Microcred Microfinance Bank\",\n            \"slug\": \"microcred-mfb\",\n            \"code\": \"090136\",\n            \"nibss_bank_code\": \"090136\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Midland Microfinance Bank\",\n            \"slug\": \"midland-mfb\",\n            \"code\": \"090192\",\n            \"nibss_bank_code\": \"090192\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Mint-Finex Micro-finance Bank\",\n            \"slug\": \"mint-finex-mfb\",\n            \"code\": \"50304\",\n            \"nibss_bank_code\": \"090281\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Mkudi\",\n            \"slug\": \"mkudi\",\n            \"code\": \"100011\",\n            \"nibss_bank_code\": \"100011\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Money Trust Micro-finance Bank\",\n            \"slug\": \"money-trust-mfb\",\n            \"code\": \"963\",\n            \"nibss_bank_code\": \"090129\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"MoneyBox\",\n            \"slug\": \"money-box\",\n            \"code\": \"934\",\n            \"nibss_bank_code\": \"100020\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Mutual Benefits Microfinance Bank\",\n            \"slug\": \"mutual-benefits-mfb\",\n            \"code\": \"090190\",\n            \"nibss_bank_code\": \"090190\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Mutual Trust Microfinance Bank\",\n            \"slug\": \"mutual-trust-mfb\",\n            \"code\": \"090151\",\n            \"nibss_bank_code\": \"090151\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Nagarta Microfinance Bank\",\n            \"slug\": \"nagarta-mfb\",\n            \"code\": \"090152\",\n            \"nibss_bank_code\": \"090152\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Navy Microfinance Bank\",\n            \"slug\": \"navy-mfb\",\n            \"code\": \"090263\",\n            \"nibss_bank_code\": \"090263\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Ndiorah Microfinance Bank\",\n            \"slug\": \"ndiorah-mfb\",\n            \"code\": \"090128\",\n            \"nibss_bank_code\": \"090128\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"New Dawn Microfinance Bank\",\n            \"slug\": \"new-dawn-mfb\",\n            \"code\": \"090205\",\n            \"nibss_bank_code\": \"090205\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"New Prudential Bank\",\n            \"slug\": \"new-prudential\",\n            \"code\": \"090108\",\n            \"nibss_bank_code\": \"090108\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"NIP Virtual Bank\",\n            \"slug\": \"nip-vb\",\n            \"code\": \"999999\",\n            \"nibss_bank_code\": \"999999\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"NIRSAL Microfinance Bank\",\n            \"slug\": \"nirsal-mfb\",\n            \"code\": \"090194\",\n            \"nibss_bank_code\": \"090194\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Nnew women MFB\",\n            \"slug\": \"nnew-women-mfb\",\n            \"code\": \"090283\",\n            \"nibss_bank_code\": \"090283\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Nova Merchant Bank\",\n            \"slug\": \"nova-meb\",\n            \"code\": \"637\",\n            \"nibss_bank_code\": \"060003\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"NPF Micro-finance Bank\",\n            \"slug\": \"npf-mfb\",\n            \"code\": \"947\",\n            \"nibss_bank_code\": \"070001\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Oche MFB\",\n            \"slug\": \"oche-mfb\",\n            \"code\": \"090333\",\n            \"nibss_bank_code\": \"090333\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Ohafia Microfinance Bank\",\n            \"slug\": \"ohafia-mfb\",\n            \"code\": \"090119\",\n            \"nibss_bank_code\": \"090119\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Okpoga Microfinance Bank\",\n            \"slug\": \"okpoga-mfb\",\n            \"code\": \"090161\",\n            \"nibss_bank_code\": \"090161\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Olabisi Onabanjo University Microfinance Bank\",\n            \"slug\": \"olabisi-onabanjo-mfb\",\n            \"code\": \"090272\",\n            \"nibss_bank_code\": \"090272\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Omiye MFB\",\n            \"slug\": \"omiye-mfb\",\n            \"code\": \"090295\",\n            \"nibss_bank_code\": \"090295\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Omoluabi Mortgage Bank Plc\",\n            \"slug\": \"omoluabi-mob\",\n            \"code\": \"950\",\n            \"nibss_bank_code\": \"070007\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"One Finance\",\n            \"slug\": \"one-finance\",\n            \"code\": \"940\",\n            \"nibss_bank_code\": \"100026\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"PAGA\",\n            \"slug\": \"paga\",\n            \"code\": \"916\",\n            \"nibss_bank_code\": \"100002\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Page Micro-finance Bank\",\n            \"slug\": \"page-mfb\",\n            \"code\": \"951\",\n            \"nibss_bank_code\": \"070008\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"PALMPAY\",\n            \"slug\": \"palmpay\",\n            \"code\": \"100033\",\n            \"nibss_bank_code\": \"100033\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"PARALLEX BANK\",\n            \"slug\": \"parallex\",\n            \"code\": \"526\",\n            \"nibss_bank_code\": \"000030\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Parkway\",\n            \"slug\": \"parkway\",\n            \"code\": \"311\",\n            \"nibss_bank_code\": null,\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"ParkWay-ReadyCash\",\n            \"slug\": \"parkway-readycash\",\n            \"code\": \"917\",\n            \"nibss_bank_code\": \"100003\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Parralex Microfinance bank\",\n            \"slug\": \"parralex-mfb\",\n            \"code\": \"090004\",\n            \"nibss_bank_code\": \"090004\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"PatrickGold Microfinance Bank\",\n            \"slug\": \"patrick-gold-mfb\",\n            \"code\": \"090317\",\n            \"nibss_bank_code\": \"090317\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"PayAttitude Online\",\n            \"slug\": \"pay-attitude-online\",\n            \"code\": \"943\",\n            \"nibss_bank_code\": \"110001\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"PAYCOM\",\n            \"slug\": \"paycom\",\n            \"code\": \"305\",\n            \"nibss_bank_code\": \"100004\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"PecanTrust Microfinance Bank\",\n            \"slug\": \"pecanTrust-mfb\",\n            \"code\": \"090137\",\n            \"nibss_bank_code\": \"090137\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Pennywise Microfinance Bank\",\n            \"slug\": \"pennywise-mfb\",\n            \"code\": \"090196\",\n            \"nibss_bank_code\": \"090196\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Personal Trust Microfinance Bank\",\n            \"slug\": \"personal-trust-mfb\",\n            \"code\": \"090135\",\n            \"nibss_bank_code\": \"090135\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Petra Microfinance Bank\",\n            \"slug\": \"petra-mfb\",\n            \"code\": \"090165\",\n            \"nibss_bank_code\": \"090165\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Pillar MFB\",\n            \"slug\": \"pillar-mfb\",\n            \"code\": \"090289\",\n            \"nibss_bank_code\": \"090289\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Platinum Mortgage Bank\",\n            \"slug\": \"platinum-mb\",\n            \"code\": \"070013\",\n            \"nibss_bank_code\": \"070013\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Polaris Bank\",\n            \"slug\": \"polaris\",\n            \"code\": \"076\",\n            \"nibss_bank_code\": \"000008\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Polyuwanna MFB\",\n            \"slug\": \"polyuwanna-mfb\",\n            \"code\": \"090296\",\n            \"nibss_bank_code\": \"090296\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Prestige Microfinance bank\",\n            \"slug\": \"prestige-mfb\",\n            \"code\": \"090274\",\n            \"nibss_bank_code\": \"090274\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Providus Bank\",\n            \"slug\": \"providus\",\n            \"code\": \"101\",\n            \"nibss_bank_code\": \"000023\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Purplemoney MFB\",\n            \"slug\": \"purplemoney-mfb\",\n            \"code\": \"090303\",\n            \"nibss_bank_code\": \"090303\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Quickfund Microfinance Bank\",\n            \"slug\": \"quickfund-mfb\",\n            \"code\": \"090261\",\n            \"nibss_bank_code\": \"090261\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Rahama MFB\",\n            \"slug\": \"rahama-mfb\",\n            \"code\": \"090170\",\n            \"nibss_bank_code\": \"090170\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Rand Merchant Bank\",\n            \"slug\": \"rand-meb\",\n            \"code\": \"502\",\n            \"nibss_bank_code\": \"000024\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Refuge Mortgage Bank\",\n            \"slug\": \"refuge-mb\",\n            \"code\": \"070011\",\n            \"nibss_bank_code\": \"070011\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Regent Micro-finance Bank\",\n            \"slug\": \"regent-mfb\",\n            \"code\": \"955\",\n            \"nibss_bank_code\": \"090125\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Reliance Microfinance Bank\",\n            \"slug\": \"reliance-mfb\",\n            \"code\": \"090173\",\n            \"nibss_bank_code\": \"090173\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"RenMoney Microfinance Bank\",\n            \"slug\": \"renmoney-mfb\",\n            \"code\": \"090198\",\n            \"nibss_bank_code\": \"090198\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Rephidim MICROFINANCE BANK\",\n            \"slug\": \"rephidim-mfb\",\n            \"code\": \"090322\",\n            \"nibss_bank_code\": \"090322\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Richway Microfinance Bank\",\n            \"slug\": \"richway-mfb\",\n            \"code\": \"090132\",\n            \"nibss_bank_code\": \"090132\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Royal Exchange Microfinance Bank\",\n            \"slug\": \"royal-exchange-mfb\",\n            \"code\": \"090138\",\n            \"nibss_bank_code\": \"090138\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Rubies Micro-finance Bank\",\n            \"slug\": \"rubies-mfb\",\n            \"code\": \"125\",\n            \"nibss_bank_code\": \"090175\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Safe Haven MFB\",\n            \"slug\": \"safe-haven-mfb\",\n            \"code\": \"090286\",\n            \"nibss_bank_code\": \"090286\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"SafeTrust\",\n            \"slug\": \"safetrust\",\n            \"code\": \"909\",\n            \"nibss_bank_code\": \"090006\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Sagamu Micro-finance Bank\",\n            \"slug\": \"sagamu-mfb\",\n            \"code\": \"966\",\n            \"nibss_bank_code\": \"090140\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Seed Capital Micro-finance Bank\",\n            \"slug\": \"seed-capital-mfb\",\n            \"code\": \"609\",\n            \"nibss_bank_code\": \"090112\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Sparkle\",\n            \"slug\": \"sparkle\",\n            \"code\": \"090325\",\n            \"nibss_bank_code\": \"090325\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Stanbic IBTC @ease Wallet\",\n            \"slug\": \"stanbic-ibtc-ease-wallet\",\n            \"code\": \"921\",\n            \"nibss_bank_code\": \"100007\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Stanbic IBTC Bank\",\n            \"slug\": \"stanbic\",\n            \"code\": \"221\",\n            \"nibss_bank_code\": \"000012\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Stanbic Mobile\",\n            \"slug\": \"stanbic-mobile\",\n            \"code\": \"304\",\n            \"nibss_bank_code\": null,\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Standard Chartered Bank\",\n            \"slug\": \"standard-chartered\",\n            \"code\": \"068\",\n            \"nibss_bank_code\": \"000021\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Stanford Microfinance Bak\",\n            \"slug\": \"stanford-mfb\",\n            \"code\": \"090162\",\n            \"nibss_bank_code\": \"090162\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Stellas Microfinance Bank\",\n            \"slug\": \"stellas-mfb\",\n            \"code\": \"090262\",\n            \"nibss_bank_code\": \"090262\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Sterling Bank\",\n            \"slug\": \"sterling\",\n            \"code\": \"232\",\n            \"nibss_bank_code\": \"000001\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Sterling Mobile\",\n            \"slug\": \"sterling-mobile\",\n            \"code\": \"936\",\n            \"nibss_bank_code\": null,\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Sulsap MFB\",\n            \"slug\": \"sulsap-mfb\",\n            \"code\": \"090305\",\n            \"nibss_bank_code\": \"090305\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Suntrust Bank Nigeria Limited\",\n            \"slug\": \"suntrust\",\n            \"code\": \"100\",\n            \"nibss_bank_code\": \"000022\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"TAGPAY\",\n            \"slug\": \"tagpay\",\n            \"code\": \"937\",\n            \"nibss_bank_code\": \"100023\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Taj Bank\",\n            \"slug\": \"taj\",\n            \"code\": \"302\",\n            \"nibss_bank_code\": \"000026\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"TCF Micro-finance Bank\",\n            \"slug\": \"tcf-mfb\",\n            \"code\": \"567\",\n            \"nibss_bank_code\": \"090115\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Teasy MOBILE\",\n            \"slug\": \"teasy-mobile\",\n            \"code\": \"924\",\n            \"nibss_bank_code\": \"100010\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Titan Trust Bank\",\n            \"slug\": \"titan\",\n            \"code\": \"102\",\n            \"nibss_bank_code\": \"000025\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Trident Microfinance Bank\",\n            \"slug\": \"trident-mfb\",\n            \"code\": \"090146\",\n            \"nibss_bank_code\": \"090146\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Trust MFB\",\n            \"slug\": \"trust-mfb\",\n            \"code\": \"090327\",\n            \"nibss_bank_code\": \"090327\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Trustbond Mortgage Bank\",\n            \"slug\": \"trustbond-mb\",\n            \"code\": \"090005\",\n            \"nibss_bank_code\": \"090005\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Trustfund Microfinance Bank\",\n            \"slug\": \"trustfund-mfb\",\n            \"code\": \"090276\",\n            \"nibss_bank_code\": \"090276\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"U AND C MFB\",\n            \"slug\": \"u-and-c-mfb\",\n            \"code\": \"090315\",\n            \"nibss_bank_code\": \"090315\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"UNAAB MFB\",\n            \"slug\": \"unaab-mfb\",\n            \"code\": \"090331\",\n            \"nibss_bank_code\": \"090331\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Uniben Microfinance Bank\",\n            \"slug\": \"uniben-mfb\",\n            \"code\": \"090266\",\n            \"nibss_bank_code\": \"090266\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Unical Microfinance Bank\",\n            \"slug\": \"unical-mfb\",\n            \"code\": \"090193\",\n            \"nibss_bank_code\": \"090193\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Union Bank\",\n            \"slug\": \"unionbank\",\n            \"code\": \"032\",\n            \"nibss_bank_code\": \"000018\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"United Bank for Africa\",\n            \"slug\": \"uba\",\n            \"code\": \"033\",\n            \"nibss_bank_code\": \"000004\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Unity Bank\",\n            \"slug\": \"unity\",\n            \"code\": \"215\",\n            \"nibss_bank_code\": \"000011\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"UNN MFB\",\n            \"slug\": \"unn-mfb\",\n            \"code\": \"090251\",\n            \"nibss_bank_code\": \"090251\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Verite Microfinance Bank\",\n            \"slug\": \"verite-mfb\",\n            \"code\": \"090123\",\n            \"nibss_bank_code\": \"090123\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"VFD Micro-finance Bank\",\n            \"slug\": \"vfd-mfb\",\n            \"code\": \"566\",\n            \"nibss_bank_code\": \"090110\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Virtue Microfinance Bank\",\n            \"slug\": \"virtue-mfb\",\n            \"code\": \"090150\",\n            \"nibss_bank_code\": \"090150\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Visa Microfinance Bank\",\n            \"slug\": \"visa-mfb\",\n            \"code\": \"090139\",\n            \"nibss_bank_code\": \"090139\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"VT Networks\",\n            \"slug\": \"vt-networks\",\n            \"code\": \"926\",\n            \"nibss_bank_code\": \"100012\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Wema Bank\",\n            \"slug\": \"wema\",\n            \"code\": \"035\",\n            \"nibss_bank_code\": \"000017\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"WetLand Micro-finance Bank\",\n            \"slug\": \"wetland-mfb\",\n            \"code\": \"954\",\n            \"nibss_bank_code\": \"090120\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Xslnce Microfinance Bank\",\n            \"slug\": \"xslnce-mfb\",\n            \"code\": \"090124\",\n            \"nibss_bank_code\": \"090124\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Yes Microfinance Bank\",\n            \"slug\": \"yes-mfb\",\n            \"code\": \"090142\",\n            \"nibss_bank_code\": \"090142\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"Zenith Bank Plc\",\n            \"slug\": \"zenith\",\n            \"code\": \"057\",\n            \"nibss_bank_code\": \"000015\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"ZENITH Mobile\",\n            \"slug\": \"zenith-mobile\",\n            \"code\": \"322\",\n            \"nibss_bank_code\": \"100018\",\n            \"country\": \"NG\"\n        },\n        {\n            \"name\": \"ZINTERNET - KONGAPAY\",\n            \"slug\": \"zinternet-kongapay\",\n            \"code\": \"939\",\n            \"nibss_bank_code\": \"100025\",\n            \"country\": \"NG\"\n        }\n    ]\n}"}],"_postman_id":"82cbd8bc-00a2-4ed4-8c64-a10654e31ea6"},{"name":"List Payout Payment Purposes","id":"334b4033-26cc-45e9-a2a0-703f1034b2b6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"pk_live_f2AjfQGDFwoNmPaz8En7W6wU2n21QpW1jBt6NYLF"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.korapay.com/merchant/api/v1/misc/payout-payment-purpose-by-country-code/:countryCode","description":"<h3 id=\"get-payment-purposes-by-country-code\">Get Payment Purposes by Country Code</h3>\n<p>Retrieves the list of valid payment purposes for a specific country. Payment purposes are required fields for certain payout destinations — call this endpoint first to fetch the accepted values before submitting a Payout request.</p>\n<blockquote>\n<p><strong>Note:</strong> This endpoint is conditionally required. Check whether the target country mandates a payment purpose before initiating a payout. </p>\n</blockquote>\n<hr />\n<h4 id=\"supported-countries\">Supported Countries</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Country</th>\n<th>Country Code</th>\n<th>Currency</th>\n<th>Currency Code</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>United States</td>\n<td><code>US</code></td>\n<td>US Dollar</td>\n<td><code>USD</code></td>\n</tr>\n<tr>\n<td>Great Britain</td>\n<td><code>GB</code></td>\n<td>Pound Sterling</td>\n<td><code>GBP</code></td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"integration-notes\">Integration Notes</h4>\n<ul>\n<li><p>Call this endpoint <strong>before submitting a Payout request</strong> when the destination country requires a payment purpose.</p>\n</li>\n<li><p>Pass the returned <code>code</code> value as the <code>purpose_of_payment</code> field in your Payout payload.</p>\n</li>\n<li><p>If an unsupported country code is provided, the endpoint will return a <code>400</code> error.</p>\n</li>\n</ul>\n","urlObject":{"path":["merchant","api","v1","misc","payout-payment-purpose-by-country-code",":countryCode"],"host":["https://api.korapay.com"],"query":[],"variable":[{"id":"7abf0a6b-e1e6-41e3-b5cb-3985d5de75b3","type":"any","value":"US","key":"countryCode"}]}},"response":[{"id":"6861121d-45a7-48e4-96e8-794126d6ed85","name":"List Payout Payment Purposes - Success","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer pk_***","description":"API public key"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/misc/payout-payment-purpose-by-country-code/US"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 19 May 2022 12:05:42 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"6c1f-8/rCq1wIVLzpLQ75vnRLjMnhtWQ\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Content-Encoding","value":"gzip"},{"key":"Cache-Control","value":"no-store"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Content-Security-Policy","value":"frame-ancestors 'none'"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Expect-CT","value":"max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\""},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"70dcb3cb78737562-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Payment purposes retrieved successfully\",\n    \"data\": [\n        {\n            \"countryCode\": \"US\",\n            \"code\": \"CHAR\",\n            \"name\": \"Charity\",\n            \"description\": \"Charitable donations\"\n        },\n        {\n            \"countryCode\": \"US\",\n            \"code\": \"COMM\",\n            \"name\": \"Commercial Payment\",\n            \"description\": \"General business/commercial payments\"\n        },\n        {\n            \"countryCode\": \"US\",\n            \"code\": \"DIVD\",\n            \"name\": \"Dividend\",\n            \"description\": \"Dividend payments\"\n        },\n        {\n            \"countryCode\": \"US\",\n            \"code\": \"EDUC\",\n            \"name\": \"Education\",\n            \"description\": \"Tuition and education-related payments\"\n        },\n        {\n            \"countryCode\": \"US\",\n            \"code\": \"FAMI\",\n            \"name\": \"Family Support\",\n            \"description\": \"Remittance to family members\"\n        },\n        {\n            \"countryCode\": \"US\",\n            \"code\": \"FREX\",\n            \"name\": \"Foreign Exchange\",\n            \"description\": \"FX-related transfers\"\n        },\n        {\n            \"countryCode\": \"US\",\n            \"code\": \"GIFT\",\n            \"name\": \"Gift\",\n            \"description\": \"Personal gift transfers\"\n        },\n        {\n            \"countryCode\": \"US\",\n            \"code\": \"INSU\",\n            \"name\": \"Insurance\",\n            \"description\": \"Insurance premium payments\"\n        },\n        {\n            \"countryCode\": \"US\",\n            \"code\": \"INTC\",\n            \"name\": \"Interest\",\n            \"description\": \"Interest payments\"\n        },\n        {\n            \"countryCode\": \"US\",\n            \"code\": \"INVEST\",\n            \"name\": \"Investment\",\n            \"description\": \"Investment in financial assets\"\n        },\n        {\n            \"countryCode\": \"US\",\n            \"code\": \"LOAN\",\n            \"name\": \"Loan Repayment\",\n            \"description\": \"Repayment of loans\"\n        },\n        {\n            \"countryCode\": \"US\",\n            \"code\": \"HLTH\",\n            \"name\": \"Medical Expenses\",\n            \"description\": \"Healthcare or medical payments\"\n        },\n        {\n            \"countryCode\": \"US\",\n            \"code\": \"OTHR\",\n            \"name\": \"Other\",\n            \"description\": \"Other purposes\"\n        },\n        {\n            \"countryCode\": \"US\",\n            \"code\": \"RENT\",\n            \"name\": \"Rent\",\n            \"description\": \"Rental payments\"\n        },\n        {\n            \"countryCode\": \"US\",\n            \"code\": \"ROYA\",\n            \"name\": \"Royalty\",\n            \"description\": \"Royalty or licensing fees\"\n        },\n        {\n            \"countryCode\": \"US\",\n            \"code\": \"SALA\",\n            \"name\": \"Salary\",\n            \"description\": \"Wage or salary payments\"\n        },\n        {\n            \"countryCode\": \"US\",\n            \"code\": \"SERV\",\n            \"name\": \"Services\",\n            \"description\": \"Payment for services rendered\"\n        },\n        {\n            \"countryCode\": \"US\",\n            \"code\": \"TAXS\",\n            \"name\": \"Tax Payment\",\n            \"description\": \"Tax remittance to authorities\"\n        },\n        {\n            \"countryCode\": \"US\",\n            \"code\": \"TRVL\",\n            \"name\": \"Travel\",\n            \"description\": \"Travel and tourism expenses\"\n        }\n    ]\n}"}],"_postman_id":"334b4033-26cc-45e9-a2a0-703f1034b2b6"},{"name":"List Payout Bank Country","id":"947eb9a3-9c0c-4671-a7b8-fcde3c7044a2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"pk_live_f2AjfQGDFwoNmPaz8En7W6wU2n21QpW1jBt6NYLF"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.korapay.com/merchant/api/v1/misc/payout-countries-by-currency-code/:currencyCode","description":"<h3 id=\"get-supported-bank-countries-by-currency-code\">Get Supported Bank Countries by Currency Code</h3>\n<p>Retrieves the list of countries for which we have supported banks for a specific currency. Use this endpoint to confirm that we have bank support in your target country for the given currency before initiating a Payout request.</p>\n<blockquote>\n<p><strong>Note:</strong> This endpoint is conditionally required. Call it to verify that your destination country has supported banks under your target currency before submitting a Payout request. </p>\n</blockquote>\n<hr />\n<h4 id=\"supported-currencies\">Supported Currencies</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Currency</th>\n<th>Currency Code</th>\n<th>Example Countries with Supported Banks</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>US Dollar</td>\n<td><code>USD</code></td>\n<td>United States</td>\n</tr>\n<tr>\n<td>Pound Sterling</td>\n<td><code>GBP</code></td>\n<td>Great Britain</td>\n</tr>\n</tbody>\n</table>\n</div><h4 id=\"integration-notes\">Integration Notes</h4>\n<ul>\n<li><p>The returned countries represent destinations where we have supported banks for the given currency. Use this to confirm bank availability before proceeding with a Payout.</p>\n</li>\n<li><p>Call this endpoint <strong>before submitting a Payout request</strong> to ensure we have bank support in your destination country for the target currency.</p>\n</li>\n<li><p>Use the returned <code>iso2</code> value as the <code>bank_country</code> in your Payout payload.</p>\n</li>\n<li><p>If an unsupported currency code is provided, the endpoint will return a <code>400</code> error.</p>\n</li>\n<li><p>Requests without a valid public key will return a <code>401 Unauthorized</code> error.</p>\n</li>\n</ul>\n","urlObject":{"path":["merchant","api","v1","misc","payout-countries-by-currency-code",":currencyCode"],"host":["https://api.korapay.com"],"query":[],"variable":[{"id":"3790ab86-9bc2-409c-9260-ee2a04d4e450","type":"any","value":"USD","key":"currencyCode"}]}},"response":[{"id":"ff6b179a-ad54-4c0a-84b6-2d6107364b24","name":"List Payout Bank Country - Success","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer pk_***","description":"API public key"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/misc/payout-countries-by-currency-code/USD"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 19 May 2022 12:05:42 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"6c1f-8/rCq1wIVLzpLQ75vnRLjMnhtWQ\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Content-Encoding","value":"gzip"},{"key":"Cache-Control","value":"no-store"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Content-Security-Policy","value":"frame-ancestors 'none'"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Expect-CT","value":"max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\""},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"70dcb3cb78737562-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"currency countries retrieved successfully\",\n    \"data\": [\n        {\n            \"country\": \"United Kingdom\",\n            \"countryCode\": \"GB\",\n            \"currencyCode\": \"USD\",\n            \"metadata\": null\n        },\n        {\n            \"country\": \"United States\",\n            \"countryCode\": \"US\",\n            \"currencyCode\": \"USD\",\n            \"metadata\": null\n        }\n    ]\n}"}],"_postman_id":"947eb9a3-9c0c-4671-a7b8-fcde3c7044a2"},{"name":"List MMO","id":"9a13d891-2fc9-4bce-864c-5d7919eb845f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"pk_live_f2AjfQGDFwoNmPaz8En7W6wU2n21QpW1jBt6NYLF"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.korapay.com/merchant/api/v1/misc/mobile-money?countryCode=GH","description":"<p>Get a list of all supported mobile money operators and their properties</p>\n","urlObject":{"path":["merchant","api","v1","misc","mobile-money"],"host":["https://api.korapay.com"],"query":[{"description":{"content":"<p>KE for KES, GH for GHS</p>\n","type":"text/plain"},"key":"countryCode","value":"GH"}],"variable":[]}},"response":[{"id":"34e473e3-74da-4451-b076-cc2e5ae56e6c","name":"List MMO - Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.korapay.com/merchant/api/v1/misc/mobile-money?countryCode=KE","host":["https://api.korapay.com"],"path":["merchant","api","v1","misc","mobile-money"],"query":[{"key":"countryCode","value":"KE"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 25 Oct 2022 10:22:14 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"Express"},{"key":"access-control-allow-origin","value":"*"},{"key":"www-environment","value":"live"},{"key":"etag","value":"W/\"f4-uF4O4iYtUhG/t0HG6E8m1rM7BQo\""},{"key":"vary","value":"Accept-Encoding"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"75fa3add0d4d6fce-IAD"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"code\": \"AA000\",\n    \"message\": \"Successful\",\n    \"data\": [\n        {\n            \"name\": \"AIRTEL\",\n            \"slug\": \"airtel-ke\",\n            \"country\": \"KE\",\n            \"code\": \"0002\",\n            \"min\": 10,\n            \"max\": 1000000\n        },\n        {\n            \"name\": \"SAFARICOM\",\n            \"slug\": \"safaricom-ke\",\n            \"country\": \"KE\",\n            \"code\": \"0001\",\n            \"min\": 10,\n            \"max\": 70000\n        }\n    ]\n}"}],"_postman_id":"9a13d891-2fc9-4bce-864c-5d7919eb845f"}],"id":"d4fbafa6-59eb-48c1-890b-ba731961a9b9","description":"<p>The Miscellaneous APIs are supporting APIs that can be used to provide more details to other APIs.</p>\n","_postman_id":"d4fbafa6-59eb-48c1-890b-ba731961a9b9"},{"name":"Identity","item":[{"name":"South Africa","item":[{"name":"SAID verification","id":"386b0800-cf25-4534-9d8f-d9a7852ed6bc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"8012185201077\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/za/said","description":"<p>This endpoint allows you to verify the validity of a South African ID number</p>\n<p><strong>Payload</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>id</td>\n<td>string</td>\n<td><code>Required</code> South African ID</td>\n</tr>\n<tr>\n<td>verification_consent</td>\n<td>boolean</td>\n<td><code>Required</code> Indicates whether the user has provided explicit consent for their ID to be verified</td>\n</tr>\n<tr>\n<td>validation</td>\n<td>object</td>\n<td><code>Optional</code> Additional validation fields for enhanced verification</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>Validation</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>first_name</td>\n<td>string</td>\n<td><code>Optional</code> First name of the individual for cross-verification</td>\n</tr>\n<tr>\n<td>last_name</td>\n<td>string</td>\n<td><code>Optional</code> Last name of the individual for cross-verification</td>\n</tr>\n<tr>\n<td>date_of_birth</td>\n<td>string (YYYY-MM-DD)</td>\n<td><code>Optional</code> Date of birth of the individual</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","identities","za","said"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"7f31b4da-8186-48e9-934d-ec15e9a23def","name":"SAID verification - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"8012185201077\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/za/said"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 11:18:14 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"1eb-F3S5fbvst1t5JP0kRqoc+B5J0rQ\""},{"key":"vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"content-security-policy","value":"frame-ancestors 'none'"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95aeb34269cdbd87-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"South Africa ID verified successfully\",\n    \"data\": {\n        \"reference\": \"VR-j8v8kgloISbKmwdEP\",\n        \"id\": \"8012185201077\",\n        \"id_type\": \"za_said\",\n        \"first_name\": \"Trevor\",\n        \"last_name\": \"Mandela\",\n        \"is_smart_card_issued\": \"Yes\",\n        \"issued_date\": \"2015-07-08\",\n        \"sequence_number\": \"1\",\n        \"deceased_status\": \"alive\",\n        \"date_of_death\": \"\",\n        \"marital_status\": \"SINGLE\",\n        \"date_of_marriage\": \"\",\n        \"on_hanis\": \"yes\",\n        \"on_npr\": \"yes\",\n        \"country_of_birth\": \"SOUTH AFRICA\",\n        \"hanis_reference\": \"2306078375132\",\n        \"requested_by\": \"API User\"\n    }\n}"},{"id":"57b30ecb-34d1-47ce-afe2-43c8b0ddeacc","name":"SAID verification - Request Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"8012185201Ar\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/za/said"},"status":"Unprocessable Entity","code":422,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 11:22:14 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"269"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"10d-QJfoKArbmLjSQCfKKIOC1NXq7L0\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95aeb92258e45d00-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"validation_error\",\n    \"message\": \"It seems there`s an issue with your input. Please correct it and try again.\",\n    \"data\": {\n        \"id\": {\n            \"message\": \"id length must be 13 characters long\",\n            \"customErrorMessage\": \"id should only be 13 characters, no less, no more\"\n        }\n    }\n}"},{"id":"4b4a61c3-d52d-4e25-9ec7-3ad0d0783165","name":"SAID verification - Not Found","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"8012185201056\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/za/said"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 11:25:03 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"45-68UEugLuqZI4swnQVJWmXCDHPIo\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95aebd3d8ae49783-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"South Africa ID data not found\",\n    \"data\": {}\n}"}],"_postman_id":"386b0800-cf25-4534-9d8f-d9a7852ed6bc"}],"id":"b5402fe3-7714-416b-a6d2-8711ef4c0a08","description":"<p>This folder contains endpoints for verifying South African identities</p>\n","_postman_id":"b5402fe3-7714-416b-a6d2-8711ef4c0a08"},{"name":"Nigeria","item":[{"name":"BVN Verification","id":"85e0227c-6524-41a4-b3ad-fe3c2050cd90","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"22222222222\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/bvn","description":"<p>This endpoint allows you to verify the validity of a Nigerian bank verification number(BVN)</p>\n<p><strong>Payload</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>id</td>\n<td>string</td>\n<td><code>Required</code> Bank verification number</td>\n</tr>\n<tr>\n<td>verification_consent</td>\n<td>boolean</td>\n<td><code>Required</code> Indicates whether the user has provided explicit consent for their ID to be verified</td>\n</tr>\n<tr>\n<td>validation</td>\n<td>object</td>\n<td><code>Optional</code> Additional validation fields for enhanced verification</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>Validation</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>first_name</td>\n<td>string</td>\n<td><code>Optional</code> First name of the individual for cross-verification</td>\n</tr>\n<tr>\n<td>last_name</td>\n<td>string</td>\n<td><code>Optional</code> Last name of the individual for cross-verification</td>\n</tr>\n<tr>\n<td>date_of_birth</td>\n<td>string (YYYY-MM-DD)</td>\n<td><code>Optional</code> Date of birth of the individual</td>\n</tr>\n<tr>\n<td>selfie</td>\n<td>string (URL or Base64)</td>\n<td><code>Optional</code> URL to a selfie image used for facial recognition</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","identities","ng","bvn"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"1ed6df8d-72ea-47bd-b027-8af1916ff5a9","name":"BVN Verification - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"22222222222\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/bvn"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 11:32:14 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"1b1a-6fsiWFMpWIx6YpDR+rEmXNk+hM4\""},{"key":"vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"content-security-policy","value":"frame-ancestors 'none'"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95aec7c88c369408-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"BVN verified successfully\",\n    \"data\": {\n        \"reference\": \"VR-IvCTTlplTDmWzme6u\",\n        \"id\": \"22222222222\",\n        \"id_type\": \"ng_bvn\",\n        \"first_name\": \"Trevor\",\n        \"last_name\": \"Mandela\",\n        \"middle_name\": null,\n        \"date_of_birth\": \"1989-07-08\",\n        \"phone_number\": \"08031234567\",\n        \"gender\": \"male\",\n        \"enrollment_branch\": null,\n        \"enrollment_institution\": null,\n        \"registration_date\": \"2005-11-11\",\n        \"nin\": \"55555555555\",\n        \"level_of_account\": null,\n        \"address\": {\n            \"town\": null,\n            \"lga\": null,\n            \"state\": null,\n            \"street\": null\n        },\n        \"title\": null,\n        \"marital_status\": null,\n        \"lga_of_origin\": null,\n        \"other_mobile\": null,\n        \"state_of_origin\": null,\n        \"watch_listed\": null,\n        \"name_on_card\": null,\n        \"image\": \"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\",\n        \"requested_by\": \"API User\"\n    }\n}"},{"id":"477d7f2e-8135-4848-8540-62d3f0146b67","name":"BVN Verification - Request Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"22222222u2\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/bvn"},"status":"Unprocessable Entity","code":422,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 11:33:44 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"269"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"10d-4wfJPqXTOWH5cHhCkRaI6lTfq1A\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Set-Cookie","value":"__cf_bm=_bUUhmkbL0RAV2GsAkGI9jCKCgBLm5fDGojzjb_7WeI-1751801624-1.0.1.1-jtZGwUqcywwWj6BhOG.TC1lcozIk68kqvRppwMLRlalOSPOmNDoRq.2ut0fxfFUfwBFmb08SY6QYpj86iR3xrSqi0OyJ.PyIlZX5ljnsuVc; path=/; expires=Sun, 06-Jul-25 12:03:44 GMT; domain=.korapay.com; HttpOnly; Secure; SameSite=None"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95aec9f9de219457-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"validation_error\",\n    \"message\": \"It seems there`s an issue with your input. Please correct it and try again.\",\n    \"data\": {\n        \"id\": {\n            \"message\": \"id length must be 11 characters long\",\n            \"customErrorMessage\": \"id should only be 11 characters, no less, no more\"\n        }\n    }\n}"},{"id":"89f94a75-d516-4b31-89f6-1bcecb231892","name":"BVN Verification - Not Found","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"22222222211\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/bvn"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 11:34:15 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"39-Qvb4e/AvJohxHXv9ldqW0xOUv8Y\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95aecaba5a9d9457-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"BVN data not found\",\n    \"data\": {}\n}"}],"_postman_id":"85e0227c-6524-41a4-b3ad-fe3c2050cd90"},{"name":"NIN Verification","id":"2e92a632-dba6-426f-9ef1-d00ba4047dd0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"55555555555\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/nin","description":"<p>This endpoint allows you to verify the validity of a Nigerian national Identitification number(NIN)</p>\n<p><strong>Payload</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>id</td>\n<td>string</td>\n<td><code>Required</code> National identitification number</td>\n</tr>\n<tr>\n<td>verification_consent</td>\n<td>boolean</td>\n<td><code>Required</code> Indicates whether the user has provided explicit consent for their ID to be verified</td>\n</tr>\n<tr>\n<td>validation</td>\n<td>object</td>\n<td><code>Optional</code> Additional validation fields for enhanced verification</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>Validation</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>first_name</td>\n<td>string</td>\n<td><code>Optional</code> First name of the individual for cross-verification</td>\n</tr>\n<tr>\n<td>last_name</td>\n<td>string</td>\n<td><code>Optional</code> Last name of the individual for cross-verification</td>\n</tr>\n<tr>\n<td>date_of_birth</td>\n<td>string (YYYY-MM-DD)</td>\n<td><code>Optional</code> Date of birth of the individual</td>\n</tr>\n<tr>\n<td>selfie</td>\n<td>string (URL or Base64)</td>\n<td><code>Optional</code> URL to a selfie image used for facial recognition</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","identities","ng","nin"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"4f99d37d-b009-49dc-aa62-58e976d17de3","name":"NIN Verification - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"55555555555\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/nin"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 11:34:41 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"41c5-K2LEKdFXz1levoq46R3rty6Oel8\""},{"key":"vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"content-security-policy","value":"frame-ancestors 'none'"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95aecb5bdb429457-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"NIN verified successfully\",\n    \"data\": {\n        \"reference\": \"VR-Xf467VL4Ee9nLn4EW\",\n        \"id\": \"55555555555\",\n        \"id_type\": \"ng_nin\",\n        \"first_name\": \"Bimbo\",\n        \"last_name\": \"Olakunle\",\n        \"middle_name\": \"Doherty\",\n        \"date_of_birth\": \"1988-04-04\",\n        \"phone_number\": \"08000000000\",\n        \"address\": {\n            \"town\": \"SULEJA\",\n            \"lga\": \"Suleja\",\n            \"state\": \"Niger\",\n            \"street\": \"13B Fake Street, Ilupeju Niger State\"\n        },\n        \"email\": \"vino@viola.com\",\n        \"birth_state\": \"Edo\",\n        \"birth_lga\": \"Esan West\",\n        \"birth_country\": \"nigeria\",\n        \"next_of_kin_state\": \"Niger\",\n        \"religion\": \"christianity\",\n        \"gender\": \"female\",\n        \"image\": \"/9j/4AAQSkZJRgABAQAAAQABAAD/4gHYSUNDX1BST0ZJTEUAAQEAAAHIAAAAAAQwAABtbnRyUkdCIFhZWiAH4AABAAEAAAAAAABhY3NwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAA9tYAAQAAAADTLQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAlkZXNjAAAA8AAAACRyWFlaAAABFAAAABRnWFlaAAABKAAAABRiWFlaAAABPAAAABR3dHB0AAABUAAAABRyVFJDAAABZAAAAChnVFJDAAABZAAAAChiVFJDAAABZAAAAChjcHJ0AAABjAAAADxtbHVjAAAAAAAAAAEAAAAMZW5VUwAAAAgAAAAcAHMAUgBHAEJYWVogAAAAAAAAb6IAADj1AAADkFhZWiAAAAAAAABimQAAt4UAABjaWFlaIAAAAAAAACSgAAAPhAAAts9YWVogAAAAAAAA9tYAAQAAAADTLXBhcmEAAAAAAAQAAAACZmYAAPKnAAANWQAAE9AAAApbAAAAAAAAAABtbHVjAAAAAAAAAAEAAAAMZW5VUwAAACAAAAAcAEcAbwBvAGcAbABlACAASQBuAGMALgAgADIAMAAxADb/2wBDAAUDBAQEAwUEBAQFBQUGBwwIBwcHBw8LCwkMEQ8SEhEPERETFhwXExQaFRERGCEYGh0dHx8fExciJCIeJBweHx7/2wBDAQUFBQcGBw4ICA4eFBEUHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh7/wAARCACsAJYDASIAAhEBAxEB/8QAHAAAAAcBAQAAAAAAAAAAAAAAAAECAwQFBwYI/8QAQRAAAgEDAgMFBQUGBQIHAAAAAQIDAAQRBSEGEjEHQVFhgRMUInGRMkKhscEIFSNSYnIWJDOS4ReCJUN0g6LR8P/EABkBAAMBAQEAAAAAAAAAAAAAAAABAgMEBf/EAB8RAQEBAQACAwEBAQAAAAAAAAABAhEDIRIxQRMiUf/aAAwDAQACEQMRAD8A1WgKFAVztR0YFFR5oA6MUVGKAMVXcT69p3DmlNqGoyFUB5UUbs7Y6CrEda89duevPqnF81hHKfd7D+Cq9AWx8R+u3pTk6VvEjiLtf1+7uT+71hsoF2ACczZ8STVHH2n8Yx3Cv+/Z5APh5Sq4+mK5GOyvJ25o4HKncMdhijfS75d/ZA/Jqv45L/VbRwZ2yzNPHbcR2yGJsJ7xFsV8Sw762eCSOeGOeFw8UihkYHIIPQ14sYTwcomjePfbmG31rcP2eeL5py3Ct9LzqsZlsix3XH2o/l3jw3pazOdiWzUAaJqLNQZeaLNJJpBagFk0WaRzUWaAcoU3zUKAjHpRUoiixQsVHRUKAVmhmizQoAp50treW5kYKkKNIxPgBn9K806bYLqV3c61qK85uJ2kRCNiSckn67Ct37SrhrfgPVmQ8rvCIgf73VfyJrHr0m0t0VUX+Go27hR3k9Lxn5X2h3KgEgAACoDg81TLS6a5PLL7JlJ25VximLsCAOv3h0zUTXt0/wA/XQiRXjKTIksZ2KsM5qTwfEnDvH2j6lDIy2bXSAnqUVvhI8xvVMk1x7UkTvj+UAYq4AN3o8w29pEOYf8A39a0zXPvD062xI8KRneoGgah+8+H9O1EAj3m1jlIPiVGfxzUvmpMC2NNlqJmptmoBfNQ5vOms+dAHzoM7k0KbBNCgiiKTSzSTQsmhRmioAUBQoUBzfafGZeCroKOk9ux+QmTP51k2qc7XDgMojcnnfYmNe7APUk4Hl59K1DtVv7my4dijhSForqf2U5dckKMMMeByOtZzeQZ5wm5LdKnVdHhz6cdpMN2LhGbJkB+M7crb9wwMVO1eOaR2kyNxtR3V5DYtdSPFLIIUHKkWMsxOMb9NqZ1rWoo4YpY9PuFkdQPYBlLc3fvnAx86j3a6JJM8tV6iXnhVvahVl5pDG5VmX+Udw+eDXRaWsjRlH5cyo6EqMA5Bxnz6ZxVJFPHNODECY3QNuc4bvFdBpBwy5O2auWsNSNp7MM/9OdBJGAbTI22+01dAayzsGvZ5pdStld3s1tYHUFiVR+d1wPDIH4VqLmqcms/G8JY02TQY0gmgh5o803mjBoBwGhSQaFASjSSKWaKhXSDSaUwpNAlChQpJNBuN7ardpuzy9mjJD2skc648jg59GrO9PvlvNPS5TBMqZO/Ru/8a27UrODUtPuNPuUDw3MbROpHUEYrzHaah/hniC90e+yUguGQsOg5SRnHmKfx7F+Pfxq7jhilaeAXCwKjZnuDuS56Ko8cd/dVTqWk2fN7JHuDGrcwcMdm8ckfnSeG9QsZZJriJYZr8Ss2JObGD0xg+HfUe54k1L94TWr2dtECxYHncj0qLm99OnOsXP8AqnFYJKlszqTjMTr94d4I7jVrJeC00qaZjgqhwfPoK4vVr62ju45ORBcc4ZvZjHNjxpy81ObWb6GytI39nJIFVe9iSB+ZrWZc+9z6eg+wPTZ7Dgprm4ieNryRXTmXBKBdj8sk137HvqNpNqun6TZ2CfZt4EiG2Ogx07qec1N+2FvSCaQzUGO9IJpArNGDTYNKBoB0GhSQaFBp7UmltSKCEaQRSjSSaFEt0pBpbdKakZURndlVVBZmY4AHeSe4UGUDXnX9o/SXteMF1KIfw723RmKjHK4+E/UAfStF4q7X+FdId7aweTWLsZAFuQIc+ch+Y+yDXF8Qa1/jWxF3ewxqr80YiQ5CBWIwD1zuDn+oU5fj7POfneMIM08Nw0sJdGTqwOD4eNLl1C6eIs7MzdOYk+ldLrvCF3ES9k6TJno55WG/y3rm7jSdTjcq8QGPMVtLms7nU9cNQsZW5jJv+J8K0/sI0pL7j7TZbhA8EDtJgrsXCEj6Hf0rhNL0eRv9UhB3hep/Su/4b1FuG4G1C1lEElqhcMO44wB/3HbHfmlvX5Dzi87Xp5m2ptmrkuAOPNJ4xtX90DW19Coa4tJNyvdzKfvJnv6jbIrpmfNZWc+yKY70lmxTbP50gvQD3MKUDUcNSlakEhTtQpKmhQFs1NmnGptqFQg0VHjJAHU1k3af2sQ6W82kcNMk94uUlvdikR7wnczf1dB3Zpyd+g7LjbjbQ+FVEV9K016y8y2kJHPjxYnZB5nc9wNedu07tP1riZGtBMLTTmba3gOFbH8x6t67eQrkeItWuZ5pJLid5p5WLSyMxJJPUknqaqblixtIx1OSa2ziT7RdJYc+8ksThYgvqTk/p9Ku9H4iudIkblQXFtKQ0sDMV3GwdWH2WxtncEbEEVz963JISDtzfkKZSYlOVumdvKrslKWy9jQ24s0W5XIvhbNjeO7iZCP+5Ayn8PlVff3+jzDn/e2nA/8AqOb8AM1wV1yFgOcg/Ko3L/Uaz/jPytf76/Xaya/oloMrcT3rjolvGUX/AHv+gqovdau9VlVWCwQI3NFbx/ZU/wAxJ3ZvM+mKoQo79zUq2bl+VVMSe2et2r/SNRu7C7S6sLqa2uYN0liblYHyNbR2f9rnvDLY8VMiN0W9RcD/ANxR0/uHqKwe3YB81IMhSRWVjVXM0iXj2PHOksSSxSJJG68yOhBVge8EdRQ5/E15s4F451Xh2ZVhk9vZE5ktZD8B81/kPmPUGt54c17T+INOW+0+UlekkbbPE3gw/Xoaw1mxcvV2H86Wr1E5qUr1BpyyihUVWoUB0zU2acfrVdxDqttoeg3+s3mPYWUDTMP5iBsvqcD1oWzrtt46bSLeThvS35b2eIe8zK28KN90f1EdT3A+Jrz5OcjPenxY8u+rLiK/ur+/k1G9kL3NwTNMfFieY+m+B5Cuf1K49nHcOpyFiOPUYH510ZzJGdvVA8zTxueYszyAj1qSd9VwDtFyoPQUzokIcOzDKpgeuc/pSrMlpZJDuxkJzVRJ+9k5y6gj4TUVmKhdzvQDlpZGz1ampWztndN6oBfHEmRSNiNqXdEPa82N1xTUJGFohD6GnojsN6al2bFLjOMGgJ1u+CBTrvvmo8YxvSpGywHlQFhaSYA8z0rqeD+Ib3QNTS7s5PJ0J+GRe9T/APtutcZay/x8dyip9tL8QHeN6VnRHqnQtWtNY02LULJ+aKTqD9pG71PmP+asAaxLsf4gbTteTS53Hu2o4Tc/ZmAPIfXdfUVtanYVzanKuHloUlTihUm6x6xz9qTXfc+GNN4fifEmo3PtpgD/AOVH09C5H+2tlIJOAMk9K8lftBa2Na7S7z2UnPb2OLSEg7YT7R9XL1eJ2nqud1iYIvO32QeU+QO1c1rIdLaQ5whVIxv3hifyAq71ZRcW8sJJHtE2+fd+lU2n/wCftEafIaCXldT44FboPWMHu9hHGdpGXnf5n/jFV1oQqvnxzVvCxlkLtjG4/wCKqnTkaQdxJAxThIyvufnTcjYnbzFEx5Tim5Tl80yPr8VtKhPdUeAkkCn4STBIf6Tmo0J+ICg0m62ZT5UFJwMGhe7CPzFJjPw4pklQzfdJp1jk5HdUIHNSIH33NHAct5OW4f8Asb8qsbCQhDId87LVbyFLlD91tsj8qkWUhaNB8sCkHQJNJEsc0TlZY2V0bvDDcH616b0HUE1bRbLU0wBdQLKQO4kfEPQ5ry4zbAeFbl2G6iLrhOWwLZayuCAM/cccw/HmrHyT1040IUKCmhWK3QcVarHoXDOpa1Ice52zyLnvfGEHqxFeJNSkea7EsjF2kc85PexOSfXevSn7Teue68O6fw/E4El/N7xMAdxHH9kern/415mvSVM2Dup5xW+JyJqVdP8AwF8V2BqLahVW6dRgyOrMPA4IpyV/aWLOD3cwqv02f2ntQWySoP0P/NaBNtNuZP6siod4qrLy5xk9KmWg/jE+WKpw/vWsFQTy8xHoKZItwvI5U9RTDGpOpkNqDqmMLgbVGI5mxSoSrYf5STzU1DiPxA1PK8lkxHhiq+PY06SZf/6cJHgRTUZOAakXI59MR9iVb8OlRYT8JFP9H4eBpZG21NKadjPcdqCSLecOpSQDIGR6UrSWLFM9F3qNIOTMg6AHP0p/S/hh+dKnFykvxb7mtK7DNRW04qezZvhvrdoxv99fjX8m+tZbG/xir/h6/k03VbO/iOHtpllGPI7j6ZqNTsOPUamhRRskiiSIgxuAyHxBGR+BoVzrYT22cQrxD2gahcQyFrW2ItbY4xlI9s+rcx9aza8OWcj5VuHHHYhxLZSSXHD0sWu2hOViJEV0g8OUnlf5qQfKsa17SNQ0q6a21SyvNNuOns7uFozny5hv6V0T6SgaVKGt2iP3Dj0qogLWmryQg5GWUeYIyKkK0trdH4eYNsQPzqFeyiS8hdDhw4GfHen0lvayShGuH+GONS2/ecbVC4ejzM87dEUkn86m8ROILJbeMY9o2PQUiGMWuiSONmdfzpkpy3NNJIfvEml2qZ+I0UMRKBiNm6VKVeVcdBTgFcEi1I7jVem+flU+5P8Al28RUFO+i/Zpts3tLF4TnODioMTcrYPfUixfklwehpu9j5J2x0zkUX66Ra0tGBANR4nyvKetHkqCO+joOz3Jb+DHjB2LHv8AlU23ccoUHptVYy8kiE965/GpcB+HPfRBxZwNl+tXFqw5lFUdoTmri2yMEUqUej+y7Uv3lwVZOzc0ttm2k33+D7J/2laFcV2H6zb2l1qFjezLDbzRrMCT0dTynHzDD6UKw1JK0lemmXaq7iX3duHr73+CG6t0t3YxTxiRDttswI64q1Yb1Q8eEjhS8x97kU/LnFFvIrM7ZHmDjPhDhpR7VbR7KTvNtIVBP9pyKyzWtHg0+dZ4L1p0R1JV0AOM+INa/wBpDsLR2BwQSaxO+lkaOdWdiMd5rLGtf9d3l8fjk+k7WcTaysfVU2pzV0P7vjjHRm3x4YpqUf8Aiknp+lSdW6wr3AGu55ivMfJGp8B0pDfZJz31Il+yajybDFANTEmJvlUMbVIckg0w9KgEOHBp66+IIx7xg/Oo9Py7xL86OgyUwcipNpu2GAO3U0ypPNin4j8JPpSgtM35/jr3fD+ppy05nYIgZz4KMn8Kk26q2pRcyq2EPUZrtOG3b2gAwB4AYrLfk+NbeLw/OfaPwlwVxNr7MmnabhYwC7zyLEAD/dv9BWkaJ2NX2EOr65bwgdUtIjI3y5mwPwNW/ZO7LrMsY+y9u3N6EEVpoqZ5bZ1O/HMa4pOFuFND4cjYadalpnXlknnPtJGHhuMAeQAoVeUKVpcf/9k=\",\n        \"signature\": \"data:image/jpg;base64,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Rraw1VoucDXNeC6CYty6nmx9MjPfI9x7jorqkSzKxU3bjV172wud60NrOojigoKCartUrsemRHyl4scBycyUZLR5BHEBZG3un5bnsfrurqyGzX03Gu5yRciBC3LTlxy8cmEtOeiVk/E/YqGXTtjvvNkdbTVnygycGWKZpfxAwclpbnyMDKmnb230UO3ekaKOOF9NJZqcPHEmOT14+UhIeMkOLiSD91jFzZ8aunL7EXcXfbHT5MjXSUZmo3ta0t4ei8loOfJ4OBJH3UtzzQ08M088jY4YmOkke44DWMHIuJPgADKrL8Ptayw1+stCV0hFworhJPG0t4teyPETyOzg5AOPOF0vxA6rmsukobJRfVX32U0zYwwucYB/ecceHElrR58lWXxT9kJ23R923rn3B1q0yU9S2eNtmbyDGPfDg+k4gHJbGGgEf1Htbys3dq9Q7Pawtd4kih1JSiGilZK3g6qillaxz+JxiUAEPaPBGVZnQGmGaP0fYrIGkSU9PyqMkEmeU85OxnoOJAx7KrXxCaattk1np3UEVTFC67S8qtssQmY19M5gMpj8vaWn62++Me6llkysveFr9F2iSwaS03apOQkpLfBE8OxyDw3LgePXROOlAe9jJdK692+123HysErKWpDWkO/lPLyXFpBdyY8gD8YVoIpI5o45YpGSRva17HsILXNcMgtI6wR4Wg1VpWz6zslVZrvC59LMWuyx3F7Hs7a9ju8Ef5jpaszJhn32rVutd7duNrvbjTNgqPmHQVDamapjGWxx1IZIDg8c8Y2cnd/jyrcE5JP3JP8AiVFWgNodLbe1NXW281FVWTAxtqKotc6KIn9DAwNAz/U7yVKiSbtLdSPQSOwSP2Xw9rZGvY9oc1wLXBwyCHdEEHyD7hfSKo1VFYrJbp31FFZ6KmmeSXSw08cbySA3y0A+BhbVETEBERAREQEREBERAREQEREBERAREQEREBERAREQEREBEQqin/xS3h7pNKWRrz6bWT1srRJ05xIiZlv3aAcH8lWD2tcZNudEkzyS/wCyqccnta0/SMccN6w3HEHyQO+1U7c+R2otQ7r39zYpKS0x0VnpHSkyNbI6RrT6JYMZ+l57P05Vutt28dvtEZke8myURy93I9xA4z9h4A9gsce+VaukKbp6S1pp7WdNuDoilfNM+NkdfS07HPe8sGC6SMZ5xyNADsdgjPntYmgrRrLc3W9FrjWNt+UttrjItlK6N0THyciWcGP7c1hPJzz5IAVql75OSST9yn4n5PFTL4izWai1dbLPb6cTGzWSor6stDssY88ncusY4tbjHucK5qrdQ0TNS777hsdmOnpdOfw2oIcOZ9djG82dEe/v4Tl8OO8pG2eu4ve22lKkyOfJFSmllL3BzudM4x949sAYz7KS1Wb4YKmZ2ldR0TiPSprqDGMAEGWIcsn3zxCsyrx0l2IiKoIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAtJf7yzT1pul3qWNNJQ0/wAxIQ48y1mS4AAEZ8cfufOAt2oV+IK5/wAO2xu8bXytkramkpWGM4/VJ6jg45H0lrCD91LpZuKzVtbKdqLHbnmKS5aw1JU1072Rgy+nDJ6I5AYOTJkt4jGMhX6o6VtDSUtIzjwp4Y4RxaGjEbQ3oDoDrwqX7SUMestwNPzwQ87NpK0wtjcWcA6oIJ5uYcjm+VznZ6OGg5yrsqcV5CIi0yfhVz2ZaLpuHu/fvnJKhrrs2lilzyjfGJXubxd78WsAGPAVhaqc0tNU1AaHGGJ8oaTgH02l2P8AjhQf8O0cQ0FPcW8muuF5rKmVhOQ1zS1gDevsPdZ5bkamq1ew0DhdN1qg1Eha7UUkfok/QC173cx/vHOD+FYtVy+HmY18O4V0jbM2lrb++WFsjQAQ7k/OfdwDgHDJAVjVeOkuxERVBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQFGG623km41gp7fBcxR1NNUevE54c6J54lpbIGnP7O7x9lJ6JZlUc7Zbe0m3WnhbmSx1NbPIZayrbHwMjj+lozk8GDoA/k+6kZESTCCIiDWXuaOns14mldxjjoqhzzgnAEZ9goH2vrYdM7CTXWGu5uhpLlVco2BxhmLi1rcHIJaQCc/dS1uJ/4A1vkZ/2HX/8AZcqwzXmhofhhp2UrJYpaqt+TkLPp5zfMGWQuOf0OY3B+/jCzy6v8amku/DrQmk2yoZzNzNbX1lQRjHAh4h4/n+7zn8qclxu3lvdatC6Ro3vDnR2qmJcG8c828/B+3LC7JWaiXYiIqgiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiKjQaron3LS+pKFnpcqi2VcTfVBLMvicPqDcHH3wqI2FlLrCh2n0JTzukbJX1lZcHRgOfCJZMFvRyOMbC4n7EFfoXJGyVj45GhzHtLXNPgtcMEH9woH2/wBkYNC6xrr+27RVNN6dRFRUxgIfC2ZwwS9x/U1o45A7ysWW1qXpPQREW2RERQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREH/9k=\",\n        \"requested_by\": \"API User\"\n    }\n}"},{"id":"1aab4aa5-005c-47b6-a752-67035e3700a9","name":"NIN Verification - Request Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"555555555Y\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/nin"},"status":"Unprocessable Entity","code":422,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 11:37:58 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"269"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"10d-4wfJPqXTOWH5cHhCkRaI6lTfq1A\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95aed02d6bb64137-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"validation_error\",\n    \"message\": \"It seems there`s an issue with your input. Please correct it and try again.\",\n    \"data\": {\n        \"id\": {\n            \"message\": \"id length must be 11 characters long\",\n            \"customErrorMessage\": \"id should only be 11 characters, no less, no more\"\n        }\n    }\n}"},{"id":"27d4015c-c165-4ce9-b5c6-e96ff6938532","name":"NIN Verification - Not Found","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"55555555511\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/nin"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 11:38:14 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"39-f9NWLfyDgAmf6ERVuiXPvdUFzN0\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95aed0909cf84137-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"NIN data not found\",\n    \"data\": {}\n}"}],"_postman_id":"2e92a632-dba6-426f-9ef1-d00ba4047dd0"},{"name":"Virtual NIN Verification","id":"0f9e660f-fe3b-4a3c-a7f4-404bbe2d869d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"KO111111111111IL\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/vnin","description":"<p>This endpoint allows you to verify the validity of a Nigerian virtual national Identitification number(vNIN)</p>\n<p><strong>Payload</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>id</td>\n<td>string</td>\n<td><code>Required</code> Virtual national identitification number</td>\n</tr>\n<tr>\n<td>verification_consent</td>\n<td>boolean</td>\n<td><code>Required</code> Indicates whether the user has provided explicit consent for their ID to be verified</td>\n</tr>\n<tr>\n<td>validation</td>\n<td>object</td>\n<td><code>Optional</code> Additional validation fields for enhanced verification</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>Validation</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>first_name</td>\n<td>string</td>\n<td><code>Optional</code> First name of the individual for cross-verification</td>\n</tr>\n<tr>\n<td>last_name</td>\n<td>string</td>\n<td><code>Optional</code> Last name of the individual for cross-verification</td>\n</tr>\n<tr>\n<td>date_of_birth</td>\n<td>string (YYYY-MM-DD)</td>\n<td><code>Optional</code> Date of birth of the individual</td>\n</tr>\n<tr>\n<td>selfie</td>\n<td>string (URL or Base64)</td>\n<td><code>Optional</code> URL to a selfie image used for facial recognition</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","identities","ng","vnin"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"f06d4943-d661-435e-8dc7-94b7ebdd0ca3","name":"Virtual NIN Verification - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"KO111111111111IL\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/vnin"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 11:38:43 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"1a00-ktg6k7z2u/GZONdJRJ17GbgTMf4\""},{"key":"vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"content-security-policy","value":"frame-ancestors 'none'"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95aed147581a4137-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Virtual NIN verified successfully\",\n    \"data\": {\n        \"reference\": \"VR-RcQyZN12mjyuVrt2D\",\n        \"id\": \"KO111111111111IL\",\n        \"id_type\": \"ng_vnin\",\n        \"first_name\": \"PROUD\",\n        \"last_name\": \"CITIZEN\",\n        \"middle_name\": \"NIGERIAN\",\n        \"date_of_birth\": \"1960-10-01\",\n        \"phone_number\": \"2341234567890\",\n        \"v_nin_user_id\": \"ABCDEF-8910\",\n        \"gender\": \"male\",\n        \"image\": \"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\",\n        \"requested_by\": \"API User\"\n    }\n}"},{"id":"e8c82e62-b90f-4659-87bc-84eb638c6c97","name":"Virtual NIN Verification - Request Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"KO111111111-\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/vnin"},"status":"Unprocessable Entity","code":422,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 11:39:05 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"240"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"f0-HU29stikRU5tqXKpzrUhNVXSQCU\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95aed1cdaf8a4137-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"validation_error\",\n    \"message\": \"It seems there`s an issue with your input. Please correct it and try again.\",\n    \"data\": {\n        \"id\": {\n            \"message\": \"id with value KO111111111- fails to match the required pattern: /^[a-zA-Z0-9]*$/\"\n        }\n    }\n}"},{"id":"d25edf24-1dd2-49f8-a7e9-815d71f23351","name":"Virtual NIN Verification - Not Found","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"KO111111111111IF\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/vnin"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 11:39:31 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"41-HeATip2bDDF03Lnh28lq56c0glw\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95aed272bb644137-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Virtual NIN data not found\",\n    \"data\": {}\n}"}],"_postman_id":"0f9e660f-fe3b-4a3c-a7f4-404bbe2d869d"},{"name":"Passport Verification","id":"9e53c181-8d13-4ade-80fe-2ae64be5d9fa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"A01234567\",\n    \"last_name\": \"Aser\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/passport","description":"<p>This endpoint allows you to verify the validity of a Nigerian passport</p>\n<p><strong>Payload</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>id</td>\n<td>string</td>\n<td><code>Required</code> Passport number</td>\n</tr>\n<tr>\n<td>last_name</td>\n<td>string</td>\n<td><code>Required</code> User's last name</td>\n</tr>\n<tr>\n<td>verification_consent</td>\n<td>boolean</td>\n<td><code>Required</code> Indicates whether the user has provided explicit consent for their ID to be verified</td>\n</tr>\n<tr>\n<td>validation</td>\n<td>object</td>\n<td><code>Optional</code> Additional validation fields for enhanced verification</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>Validation</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>first_name</td>\n<td>string</td>\n<td><code>Optional</code> First name of the individual for cross-verification</td>\n</tr>\n<tr>\n<td>last_name</td>\n<td>string</td>\n<td><code>Optional</code> Last name of the individual for cross-verification</td>\n</tr>\n<tr>\n<td>date_of_birth</td>\n<td>string (YYYY-MM-DD)</td>\n<td><code>Optional</code> Date of birth of the individual</td>\n</tr>\n<tr>\n<td>selfie</td>\n<td>string (URL or Base64)</td>\n<td><code>Optional</code> URL to a selfie image used for facial recognition</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","identities","ng","passport"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"d444ffba-162f-4c91-b1aa-80e184393438","name":"Passport Verification - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"A01234567\",\n    \"last_name\": \"Jalekun\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/passport"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 11:41:19 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"1a34-fFvclEYlDF2ZfcDGoHFQrlH4K6o\""},{"key":"vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"content-security-policy","value":"frame-ancestors 'none'"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95aed514b9f1ed04-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Passport verified successfully\",\n    \"data\": {\n        \"reference\": \"VR-WF1R0fjTRQVrgaTxI\",\n        \"id\": \"A01234567\",\n        \"id_type\": \"ng_passport\",\n        \"first_name\": \"Abike\",\n        \"last_name\": \"Jalekun\",\n        \"middle_name\": \"Mary\",\n        \"date_of_birth\": \"1999-07-04\",\n        \"phone_number\": \"08030123456\",\n        \"expired_date\": \"2030-04-04\",\n        \"signature\": null,\n        \"issued_at\": \"AKURE\",\n        \"issued_date\": \"2022-02-01\",\n        \"gender\": \"female\",\n        \"image\": \"/9j/4AAQSkZJRgABAQAAAQABAAD/4gHYSUNDX1BST0ZJTEUAAQEAAAHIAAAAAAQwAABtbnRyUkdCIFhZWiAH4AABAAEAAAAAAABhY3NwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAA9tYAAQAAAADTLQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAlkZXNjAAAA8AAAACRyWFlaAAABFAAAABRnWFlaAAABKAAAABRiWFlaAAABPAAAABR3dHB0AAABUAAAABRyVFJDAAABZAAAAChnVFJDAAABZAAAAChiVFJDAAABZAAAAChjcHJ0AAABjAAAADxtbHVjAAAAAAAAAAEAAAAMZW5VUwAAAAgAAAAcAHMAUgBHAEJYWVogAAAAAAAAb6IAADj1AAADkFhZWiAAAAAAAABimQAAt4UAABjaWFlaIAAAAAAAACSgAAAPhAAAts9YWVogAAAAAAAA9tYAAQAAAADTLXBhcmEAAAAAAAQAAAACZmYAAPKnAAANWQAAE9AAAApbAAAAAAAAAABtbHVjAAAAAAAAAAEAAAAMZW5VUwAAACAAAAAcAEcAbwBvAGcAbABlACAASQBuAGMALgAgADIAMAAxADb/2wBDAAUDBAQEAwUEBAQFBQUGBwwIBwcHBw8LCwkMEQ8SEhEPERETFhwXExQaFRERGCEYGh0dHx8fExciJCIeJBweHx7/2wBDAQUFBQcGBw4ICA4eFBEUHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh7/wAARCACsAJYDASIAAhEBAxEB/8QAHAAAAAcBAQAAAAAAAAAAAAAAAAECAwQFBwYI/8QAQRAAAgEDAgMFBQUGBQIHAAAAAQIDAAQRBSEGEjEHQVFhgRMUInGRMkKhscEIFSNSYnIWJDOS4ReCJUN0g6LR8P/EABkBAAMBAQEAAAAAAAAAAAAAAAABAgMEBf/EAB8RAQEBAQACAwEBAQAAAAAAAAABAhEDIRIxQRMiUf/aAAwDAQACEQMRAD8A1WgKFAVztR0YFFR5oA6MUVGKAMVXcT69p3DmlNqGoyFUB5UUbs7Y6CrEda89duevPqnF81hHKfd7D+Cq9AWx8R+u3pTk6VvEjiLtf1+7uT+71hsoF2ACczZ8STVHH2n8Yx3Cv+/Z5APh5Sq4+mK5GOyvJ25o4HKncMdhijfS75d/ZA/Jqv45L/VbRwZ2yzNPHbcR2yGJsJ7xFsV8Sw762eCSOeGOeFw8UihkYHIIPQ14sYTwcomjePfbmG31rcP2eeL5py3Ct9LzqsZlsix3XH2o/l3jw3pazOdiWzUAaJqLNQZeaLNJJpBagFk0WaRzUWaAcoU3zUKAjHpRUoiixQsVHRUKAVmhmizQoAp50treW5kYKkKNIxPgBn9K806bYLqV3c61qK85uJ2kRCNiSckn67Ct37SrhrfgPVmQ8rvCIgf73VfyJrHr0m0t0VUX+Go27hR3k9Lxn5X2h3KgEgAACoDg81TLS6a5PLL7JlJ25VximLsCAOv3h0zUTXt0/wA/XQiRXjKTIksZ2KsM5qTwfEnDvH2j6lDIy2bXSAnqUVvhI8xvVMk1x7UkTvj+UAYq4AN3o8w29pEOYf8A39a0zXPvD062xI8KRneoGgah+8+H9O1EAj3m1jlIPiVGfxzUvmpMC2NNlqJmptmoBfNQ5vOms+dAHzoM7k0KbBNCgiiKTSzSTQsmhRmioAUBQoUBzfafGZeCroKOk9ux+QmTP51k2qc7XDgMojcnnfYmNe7APUk4Hl59K1DtVv7my4dijhSForqf2U5dckKMMMeByOtZzeQZ5wm5LdKnVdHhz6cdpMN2LhGbJkB+M7crb9wwMVO1eOaR2kyNxtR3V5DYtdSPFLIIUHKkWMsxOMb9NqZ1rWoo4YpY9PuFkdQPYBlLc3fvnAx86j3a6JJM8tV6iXnhVvahVl5pDG5VmX+Udw+eDXRaWsjRlH5cyo6EqMA5Bxnz6ZxVJFPHNODECY3QNuc4bvFdBpBwy5O2auWsNSNp7MM/9OdBJGAbTI22+01dAayzsGvZ5pdStld3s1tYHUFiVR+d1wPDIH4VqLmqcms/G8JY02TQY0gmgh5o803mjBoBwGhSQaFASjSSKWaKhXSDSaUwpNAlChQpJNBuN7ardpuzy9mjJD2skc648jg59GrO9PvlvNPS5TBMqZO/Ru/8a27UrODUtPuNPuUDw3MbROpHUEYrzHaah/hniC90e+yUguGQsOg5SRnHmKfx7F+Pfxq7jhilaeAXCwKjZnuDuS56Ko8cd/dVTqWk2fN7JHuDGrcwcMdm8ckfnSeG9QsZZJriJYZr8Ss2JObGD0xg+HfUe54k1L94TWr2dtECxYHncj0qLm99OnOsXP8AqnFYJKlszqTjMTr94d4I7jVrJeC00qaZjgqhwfPoK4vVr62ju45ORBcc4ZvZjHNjxpy81ObWb6GytI39nJIFVe9iSB+ZrWZc+9z6eg+wPTZ7Dgprm4ieNryRXTmXBKBdj8sk137HvqNpNqun6TZ2CfZt4EiG2Ogx07qec1N+2FvSCaQzUGO9IJpArNGDTYNKBoB0GhSQaFBp7UmltSKCEaQRSjSSaFEt0pBpbdKakZURndlVVBZmY4AHeSe4UGUDXnX9o/SXteMF1KIfw723RmKjHK4+E/UAfStF4q7X+FdId7aweTWLsZAFuQIc+ch+Y+yDXF8Qa1/jWxF3ewxqr80YiQ5CBWIwD1zuDn+oU5fj7POfneMIM08Nw0sJdGTqwOD4eNLl1C6eIs7MzdOYk+ldLrvCF3ES9k6TJno55WG/y3rm7jSdTjcq8QGPMVtLms7nU9cNQsZW5jJv+J8K0/sI0pL7j7TZbhA8EDtJgrsXCEj6Hf0rhNL0eRv9UhB3hep/Su/4b1FuG4G1C1lEElqhcMO44wB/3HbHfmlvX5Dzi87Xp5m2ptmrkuAOPNJ4xtX90DW19Coa4tJNyvdzKfvJnv6jbIrpmfNZWc+yKY70lmxTbP50gvQD3MKUDUcNSlakEhTtQpKmhQFs1NmnGptqFQg0VHjJAHU1k3af2sQ6W82kcNMk94uUlvdikR7wnczf1dB3Zpyd+g7LjbjbQ+FVEV9K016y8y2kJHPjxYnZB5nc9wNedu07tP1riZGtBMLTTmba3gOFbH8x6t67eQrkeItWuZ5pJLid5p5WLSyMxJJPUknqaqblixtIx1OSa2ziT7RdJYc+8ksThYgvqTk/p9Ku9H4iudIkblQXFtKQ0sDMV3GwdWH2WxtncEbEEVz963JISDtzfkKZSYlOVumdvKrslKWy9jQ24s0W5XIvhbNjeO7iZCP+5Ayn8PlVff3+jzDn/e2nA/8AqOb8AM1wV1yFgOcg/Ko3L/Uaz/jPytf76/Xaya/oloMrcT3rjolvGUX/AHv+gqovdau9VlVWCwQI3NFbx/ZU/wAxJ3ZvM+mKoQo79zUq2bl+VVMSe2et2r/SNRu7C7S6sLqa2uYN0liblYHyNbR2f9rnvDLY8VMiN0W9RcD/ANxR0/uHqKwe3YB81IMhSRWVjVXM0iXj2PHOksSSxSJJG68yOhBVge8EdRQ5/E15s4F451Xh2ZVhk9vZE5ktZD8B81/kPmPUGt54c17T+INOW+0+UlekkbbPE3gw/Xoaw1mxcvV2H86Wr1E5qUr1BpyyihUVWoUB0zU2acfrVdxDqttoeg3+s3mPYWUDTMP5iBsvqcD1oWzrtt46bSLeThvS35b2eIe8zK28KN90f1EdT3A+Jrz5OcjPenxY8u+rLiK/ur+/k1G9kL3NwTNMfFieY+m+B5Cuf1K49nHcOpyFiOPUYH510ZzJGdvVA8zTxueYszyAj1qSd9VwDtFyoPQUzokIcOzDKpgeuc/pSrMlpZJDuxkJzVRJ+9k5y6gj4TUVmKhdzvQDlpZGz1ampWztndN6oBfHEmRSNiNqXdEPa82N1xTUJGFohD6GnojsN6al2bFLjOMGgJ1u+CBTrvvmo8YxvSpGywHlQFhaSYA8z0rqeD+Ib3QNTS7s5PJ0J+GRe9T/APtutcZay/x8dyip9tL8QHeN6VnRHqnQtWtNY02LULJ+aKTqD9pG71PmP+asAaxLsf4gbTteTS53Hu2o4Tc/ZmAPIfXdfUVtanYVzanKuHloUlTihUm6x6xz9qTXfc+GNN4fifEmo3PtpgD/AOVH09C5H+2tlIJOAMk9K8lftBa2Na7S7z2UnPb2OLSEg7YT7R9XL1eJ2nqud1iYIvO32QeU+QO1c1rIdLaQ5whVIxv3hifyAq71ZRcW8sJJHtE2+fd+lU2n/wCftEafIaCXldT44FboPWMHu9hHGdpGXnf5n/jFV1oQqvnxzVvCxlkLtjG4/wCKqnTkaQdxJAxThIyvufnTcjYnbzFEx5Tim5Tl80yPr8VtKhPdUeAkkCn4STBIf6Tmo0J+ICg0m62ZT5UFJwMGhe7CPzFJjPw4pklQzfdJp1jk5HdUIHNSIH33NHAct5OW4f8Asb8qsbCQhDId87LVbyFLlD91tsj8qkWUhaNB8sCkHQJNJEsc0TlZY2V0bvDDcH616b0HUE1bRbLU0wBdQLKQO4kfEPQ5ry4zbAeFbl2G6iLrhOWwLZayuCAM/cccw/HmrHyT1040IUKCmhWK3QcVarHoXDOpa1Ice52zyLnvfGEHqxFeJNSkea7EsjF2kc85PexOSfXevSn7Teue68O6fw/E4El/N7xMAdxHH9kern/415mvSVM2Dup5xW+JyJqVdP8AwF8V2BqLahVW6dRgyOrMPA4IpyV/aWLOD3cwqv02f2ntQWySoP0P/NaBNtNuZP6siod4qrLy5xk9KmWg/jE+WKpw/vWsFQTy8xHoKZItwvI5U9RTDGpOpkNqDqmMLgbVGI5mxSoSrYf5STzU1DiPxA1PK8lkxHhiq+PY06SZf/6cJHgRTUZOAakXI59MR9iVb8OlRYT8JFP9H4eBpZG21NKadjPcdqCSLecOpSQDIGR6UrSWLFM9F3qNIOTMg6AHP0p/S/hh+dKnFykvxb7mtK7DNRW04qezZvhvrdoxv99fjX8m+tZbG/xir/h6/k03VbO/iOHtpllGPI7j6ZqNTsOPUamhRRskiiSIgxuAyHxBGR+BoVzrYT22cQrxD2gahcQyFrW2ItbY4xlI9s+rcx9aza8OWcj5VuHHHYhxLZSSXHD0sWu2hOViJEV0g8OUnlf5qQfKsa17SNQ0q6a21SyvNNuOns7uFozny5hv6V0T6SgaVKGt2iP3Dj0qogLWmryQg5GWUeYIyKkK0trdH4eYNsQPzqFeyiS8hdDhw4GfHen0lvayShGuH+GONS2/ecbVC4ejzM87dEUkn86m8ROILJbeMY9o2PQUiGMWuiSONmdfzpkpy3NNJIfvEml2qZ+I0UMRKBiNm6VKVeVcdBTgFcEi1I7jVem+flU+5P8Al28RUFO+i/Zpts3tLF4TnODioMTcrYPfUixfklwehpu9j5J2x0zkUX66Ra0tGBANR4nyvKetHkqCO+joOz3Jb+DHjB2LHv8AlU23ccoUHptVYy8kiE965/GpcB+HPfRBxZwNl+tXFqw5lFUdoTmri2yMEUqUej+y7Uv3lwVZOzc0ttm2k33+D7J/2laFcV2H6zb2l1qFjezLDbzRrMCT0dTynHzDD6UKw1JK0lemmXaq7iX3duHr73+CG6t0t3YxTxiRDttswI64q1Yb1Q8eEjhS8x97kU/LnFFvIrM7ZHmDjPhDhpR7VbR7KTvNtIVBP9pyKyzWtHg0+dZ4L1p0R1JV0AOM+INa/wBpDsLR2BwQSaxO+lkaOdWdiMd5rLGtf9d3l8fjk+k7WcTaysfVU2pzV0P7vjjHRm3x4YpqUf8Aiknp+lSdW6wr3AGu55ivMfJGp8B0pDfZJz31Il+yajybDFANTEmJvlUMbVIckg0w9KgEOHBp66+IIx7xg/Oo9Py7xL86OgyUwcipNpu2GAO3U0ypPNin4j8JPpSgtM35/jr3fD+ppy05nYIgZz4KMn8Kk26q2pRcyq2EPUZrtOG3b2gAwB4AYrLfk+NbeLw/OfaPwlwVxNr7MmnabhYwC7zyLEAD/dv9BWkaJ2NX2EOr65bwgdUtIjI3y5mwPwNW/ZO7LrMsY+y9u3N6EEVpoqZ5bZ1O/HMa4pOFuFND4cjYadalpnXlknnPtJGHhuMAeQAoVeUKVpcf/9k=\",\n        \"requested_by\": \"API User\"\n    }\n}"},{"id":"d2918ab4-acc1-48d5-be8b-2b6cea38dee7","name":"Passport Verification - Request Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"A012345-\",\n    \"last_name\": \"Jalekun\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/passport"},"status":"Unprocessable Entity","code":422,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 11:41:45 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"267"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"10b-pBMI5KzXVZgnnOYTJq7EJISaVNI\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95aed5b82aa4ed04-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"validation_error\",\n    \"message\": \"It seems there`s an issue with your input. Please correct it and try again.\",\n    \"data\": {\n        \"id\": {\n            \"message\": \"id length must be 9 characters long\",\n            \"customErrorMessage\": \"id should only be 9 characters, no less, no more\"\n        }\n    }\n}"},{"id":"ffabae69-1d70-424f-9b04-3592951b4ffe","name":"Passport Verification - Not Found","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"A01234566\",\n    \"last_name\": \"Jalekun\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/passport"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 11:42:07 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"3e-E2zVGle7+FQBXdidOVwNc06NaEc\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95aed63def27ed04-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Passport data not found\",\n    \"data\": {}\n}"}],"_postman_id":"9e53c181-8d13-4ade-80fe-2ae64be5d9fa"},{"name":"PVC Verification","id":"a1744199-830a-4fc7-9bc2-f1503b5f2e3e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"00A0A0A000000000011\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/pvc","description":"<p>This endpoint allows you to verify the validity of a Nigerian permanent voter's card(PVC)</p>\n<p><strong>Payload</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>id</td>\n<td>string</td>\n<td><code>Required</code> Permanent voter's card number</td>\n</tr>\n<tr>\n<td>verification_consent</td>\n<td>boolean</td>\n<td><code>Required</code> Indicates whether the user has provided explicit consent for their ID to be verified</td>\n</tr>\n<tr>\n<td>validation</td>\n<td>object</td>\n<td><code>Optional</code> Additional validation fields for enhanced verification</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>Validation</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>first_name</td>\n<td>string</td>\n<td><code>Optional</code> First name of the individual for cross-verification</td>\n</tr>\n<tr>\n<td>last_name</td>\n<td>string</td>\n<td><code>Optional</code> Last name of the individual for cross-verification</td>\n</tr>\n<tr>\n<td>date_of_birth</td>\n<td>string (YYYY-MM-DD)</td>\n<td><code>Optional</code> Date of birth of the individual</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","identities","ng","pvc"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"cb9314a9-00e9-4e3a-a97a-e9c89f34b20e","name":"PVC Verification - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"00A0A0A000000000011\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/pvc"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 11:42:56 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"106-0zScdjJacA7E3P8CFhAHU/BnB4s\""},{"key":"vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"content-security-policy","value":"frame-ancestors 'none'"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95aed772edd5ed04-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"PVC verified successfully\",\n    \"data\": {\n        \"reference\": \"VR-wRMt6Ny7AmIJMGDf2\",\n        \"id\": \"00A0A0A000000000011\",\n        \"id_type\": \"ng_pvc\",\n        \"first_name\": \"Nonso\",\n        \"last_name\": \"Savage\",\n        \"middle_name\": \"Caleb\",\n        \"date_of_birth\": \"1992-04-04\",\n        \"requested_by\": \"API User\"\n    }\n}"},{"id":"33dbfa54-f7a1-4f64-8e96-6d0bd7051894","name":"PVC Verification - Request Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"00A0A0A0000000000-\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/pvc"},"status":"Unprocessable Entity","code":422,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 11:44:25 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"246"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"f6-/ji0jdKn+2Sx9jkgnXyRRg+ICL8\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95aed99ead281d4e-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"validation_error\",\n    \"message\": \"It seems there`s an issue with your input. Please correct it and try again.\",\n    \"data\": {\n        \"id\": {\n            \"message\": \"id with value 00A0A0A0000000000- fails to match the required pattern: /^[a-zA-Z0-9]*$/\"\n        }\n    }\n}"},{"id":"09d2389a-7ac3-47d4-9b6c-e764d394c3ff","name":"PVC Verification - Not Found","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"00A0A0A000000000012\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/pvc"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 11:44:49 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"39-8751s7nO8mmK92EHk9pAi0iLXU0\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/csp-reporting.cloudflare.com\\/cdn-cgi\\/script_monitor\\/report?m=H0lWS.sIYFQwUf0na_KeobYNbLIQgWosuXT2RlU79Bk-1751802289-1.0.1.1-rrgbIQ048CJMrny62rii8R6W2GSL.mMFLiqlGlt1VfRO9Ee3DiKv8sGHLFyNmz6PUzIUOk9aMwdKsnF3tfJ9muVjeLnvy6RjE0dcTdb5LIADGYvpfbZ1qM28rd5y4NyuG6W687it8CahLe9I1DEM5g\"}],\"group\":\"cf-csp-endpoint\",\"max_age\":86400}"},{"key":"Content-Security-Policy-Report-Only","value":"script-src 'none'; report-uri https://csp-reporting.cloudflare.com/cdn-cgi/script_monitor/report?m=H0lWS.sIYFQwUf0na_KeobYNbLIQgWosuXT2RlU79Bk-1751802289-1.0.1.1-rrgbIQ048CJMrny62rii8R6W2GSL.mMFLiqlGlt1VfRO9Ee3DiKv8sGHLFyNmz6PUzIUOk9aMwdKsnF3tfJ9muVjeLnvy6RjE0dcTdb5LIADGYvpfbZ1qM28rd5y4NyuG6W687it8CahLe9I1DEM5g; report-to cf-csp-endpoint"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95aeda328a9a1d4e-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"PVC data not found\",\n    \"data\": {}\n}"}],"_postman_id":"a1744199-830a-4fc7-9bc2-f1503b5f2e3e"},{"name":"NIN Phone Verification","id":"3f27f755-5ce0-4b7a-8f7b-e76fececb8ae","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"08000000000\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/nin-phone","description":"<p>This endpoint allows you to verify the validity of a Nigerian NIN phone number</p>\n<p><strong>Payload</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>id</td>\n<td>string</td>\n<td><code>Required</code> NIN phone number</td>\n</tr>\n<tr>\n<td>verification_consent</td>\n<td>boolean</td>\n<td><code>Required</code> Indicates whether the user has provided explicit consent for their ID to be verified</td>\n</tr>\n<tr>\n<td>validation</td>\n<td>object</td>\n<td><code>Optional</code> Additional validation fields for enhanced verification</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>Validation</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>first_name</td>\n<td>string</td>\n<td><code>Optional</code> First name of the individual for cross-verification</td>\n</tr>\n<tr>\n<td>last_name</td>\n<td>string</td>\n<td><code>Optional</code> Last name of the individual for cross-verification</td>\n</tr>\n<tr>\n<td>date_of_birth</td>\n<td>string (YYYY-MM-DD)</td>\n<td><code>Optional</code> Date of birth of the individual</td>\n</tr>\n<tr>\n<td>selfie</td>\n<td>string (URL or Base64)</td>\n<td><code>Optional</code> URL to a selfie image used for facial recognition</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","identities","ng","nin-phone"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"51336909-b45f-4ad0-a325-d00488b1f88e","name":"NIN Phone Verification - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"08000000000\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/nin-phone"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 11:45:48 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"41d1-QwzFIEAW1Z2N8FYEhLc3z5EsBBI\""},{"key":"vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"content-security-policy","value":"frame-ancestors 'none'"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95aedba50ee11d4e-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"NIN phone verified successfully\",\n    \"data\": {\n        \"reference\": \"VR-kO5cgZ1ayrD27AQkH\",\n        \"id\": \"08000000000\",\n        \"id_type\": \"ng_nin_phone\",\n        \"first_name\": \"Bimbo\",\n        \"last_name\": \"Olakunle\",\n        \"middle_name\": \"Doherty\",\n        \"date_of_birth\": \"1988-04-04\",\n        \"phone_number\": \"08000000000\",\n        \"address\": {\n            \"town\": \"SULEJA\",\n            \"lga\": \"Suleja\",\n            \"state\": \"Niger\",\n            \"street\": \"13B Fake Street, Ilupeju Niger State\"\n        },\n        \"email\": \"vino@viola.com\",\n        \"birth_state\": \"Edo\",\n        \"birth_lga\": \"Esan West\",\n        \"birth_country\": \"nigeria\",\n        \"next_of_kin_state\": \"Niger\",\n        \"religion\": \"christianity\",\n        \"gender\": \"female\",\n        \"image\": \"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\",\n        \"signature\": \"data:image/jpg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/4gIcSUNDX1BST0ZJTEUAAQEAAAIMbGNtcwIQAABtbnRyUkdCIFhZWiAH3AABABkAAwApADlhY3NwQVBQTAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA9tYAAQAAAADTLWxjbXMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAApkZXNjAAAA/AAAAF5jcHJ0AAABXAAAAAt3dHB0AAABaAAAABRia3B0AAABfAAAABRyWFlaAAABkAAAABRnWFlaAAABpAAAABRiWFlaAAABuAAAABRyVFJDAAABzAAAAEBnVFJDAAABzAAAAEBiVFJDAAABzAAAAEBkZXNjAAAAAAAAAANjMgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAB0ZXh0AAAAAEZCAABYWVogAAAAAAAA9tYAAQAAAADTLVhZWiAAAAAAAAADFgAAAzMAAAKkWFlaIAAAAAAAAG+iAAA49QAAA5BYWVogAAAAAAAAYpkAALeFAAAY2lhZWiAAAAAAAAAkoAAAD4QAALbPY3VydgAAAAAAAAAaAAAAywHJA2MFkghrC/YQPxVRGzQh8SmQMhg7kkYFUXdd7WtwegWJsZp8rGm/fdPD6TD////bAEMABQUFBQUFBQYGBQgIBwgICwoJCQoLEQwNDA0MERoQExAQExAaFxsWFRYbFykgHBwgKS8nJScvOTMzOUdER11dff/bAEMBBQUFBQUFBQYGBQgIBwgICwoJCQoLEQwNDA0MERoQExAQExAaFxsWFRYbFykgHBwgKS8nJScvOTMzOUdER11dff/AABEIAN0BQAMBIgACEQEDEQH/xAAdAAEAAgMBAQEBAAAAAAAAAAAABwgEBQYBAgkD/8QAPhAAAQMDBAECBQIDBAgHAAAAAQACAwQFEQYHEiExE0EIFCJRYTJxFSNCFjORoRckJWKBgrGzNjdDRXJztP/EABcBAQEBAQAAAAAAAAAAAAAAAAABAgP/xAAhEQEBAAICAwADAQEAAAAAAAAAARExAiEiQVESQoFhcf/aAAwDAQACEQMRAD8AtsiIuzkIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiIC+ZJI4mOfI9rGNGXOcQ0AD3JPQX0uG3MomXDQGr6Z4mIdbJ34hHJ+YxzGBluR12M+Eulm3bskZIxr2Pa5jgC1zSHAg+4I8hfSr58OV0mrNu5KX5pkstFdJo2xOJ/lQy8ZAOhnBy4t/KsGpLmFmKIiKoIiICIiAiIgIuH3D1tS6B0xWXqaD15WubFTQcwz1JpOmgk98RjLsd4UAbfbw7lXTWGn7Je7RTyU93LZoz8q6mkZTFrj60RBw5gxnJB6Cme1kytuiDwiqCIiAiIgIiICIiAiIgIiIC9Xi1N/tX8dsl1tXzs1J85TSQfMQHEkfMY5N8d/wDVBtyCOiCD9ivFTu20m+G0FQ2CGhOorK8vkMUb5KljWx5c4t/rhcR34IJ+6tJpW81eoNP2u6VlnqLZU1MIfJRztIfGft2AS0jsEjwpOS4dAiIqgiIgIiICIiAtdeKRlfaLrRvMgbUUc8J9MBz8SRlp4g9F3fQPutivD4P7FFinvwtXkNqdWWJxwXRw1sWGn/0z6L+Tv+ZuArhqhWzLamwbh6KqomTik1HS10YD34Aa2SRnEkY9TgYgTkDsq+qzxXlsREWmRERUERfxqKinpIJaipnjhhiaXSSyODGMaPdznYAH5Kg/siw6C40F1pYqy31sNVTSjLJoXiRjh+C3KzWgFzQfBIH+ah8Vh1Zx1vvxprTz6s/Iafp2V0sfpB7TO0CdzHZyCHANaSfHjysaqqa+7/E3QtpHyujtNJ6M5fE57IWfLuc8DGOIeX4a4/1FcponWNs0hqDeTV16zLVCuNHSYP8AMmlfNI70gAQACIwXOI6AUs7IaYu9NS6g1dqClMN31FVfMcT9PGnd/MH0f0cnHIB8Nwse43qJ4REXRgRcJprXdFqfU+sbHS0j2ixSQxvqS8ObM95c13EDOA0txnPa7tJcroRERBERAREQEREBERAREQEREBERAREQEREBERAXjv0u/Y/9F6vHeHd+xS6H5+XGlntO2+z+sqeo4SW651kAZgF3JtXJUNe0HokcSCD14V/4Jm1MMM7GlrZWNkaD5AeA4A/ntU801Z2334dNWUwqhUut9wramEkuayP5UslIZkZwWkkDAyXdqedmrtPeNtdLT1BcZYad1K5zgByFO4xtIwTn6QBk9krHFqpPXI6+vddpvRuorxQOgFVRUjpovXaXRkggYIBbknPXfldd39lSTfncap1PXT6W0/LJPare0y3KWny+OaRhH6i0f3cJ988S7v2Vt6Sdp22Q1ZqnWOlKq4ahkimfHXSQwVLIxG6VrQC7m1gDfpJwCPPv4UyqHdg//KnTX/2Vv/6XqSNQ6itGlbTU3e8VRgooDGJJAx0hBkcGNw1gJOSfZamtl/xulG+79TFS7Z6zfKcB9A6IeP1yua1o7I9z+67Sy3q26htVFdrXUieiqmc4ZAC3IBIIIPYIIwQewuX3QooLht7q+nn48P4bK8F0Rl4uj+trg1oJyCOiPHlS6JuKl6Ovetdm4KW5NtLbppm9U8FZ6sLHelkjJIk4gslY0EcXfT7qWH/FJo1rXGLT14dI0EsDjA1pI8AkPOAfc9qVtq2tftpotjgC11phDgewQc5BB8hdX/Z+w/Nms/glB80QAZ/lo+eGggDOM9A4WZLidrbM6UD2+o9PX7dClqNWUxpaO5Tz1tLT1HUU0k0hdFG9x48mF2QPZxGF+iQAAAAwB4HjCiXdba+n3BtdM+kmjpLxQZNHORxY4HH8qQtBIb1lpH6T2AowtG+120bM/Tu4en6w19D/AC5a6n4udK3B4vc13EO5dYc04d5Vnjey9zpapcprjU0Gj9KXu9zPANNTu9EEcuc7/pibjrOXHv8ACjaD4i9spqKaokrbhA9odinko3GR+B1xLC5nfgZcPyowZ/aP4htSW6ee2vtujrZM4vzIWumDickHGHyuDcZb1GM99pbLokSJ8OVnnotDVF0qS8zXa4Sz8nP5c2Rfyw457BJDs589FT+sSgoKS2UVLQ0VOyClp42xQwsGGsYwYDR+AstWTES3NERFUEREBERAREQERRLrnefR+hq0W2pfPW3EFnq01K0OMLXnzI5xADsdhvnx4ylsipaRPKIgiIgIiICL3s+ASvkODhkEEfcHKD1ERARFjVtbSW6kqaytqY6emgjdJNNI7ixjG9lzifAQZKxa9xbQ1rhUOgxTyn1mtD3R4afrDSCCW+cY7UWWXfLbu/XuGzUd0qBPPLFDTSS0z44p5Jeg1pPYOevqA78LvdW96U1R1/7RXf8AYcpmWVcdxD/w6xCq2zmgmmD45LnWxkN6cxj2tBB6GHdk+/lVws+5ep9q6fUuk7ZHCJob1KDNKfXbEISY3sY3AGXFoy7/ACVjfhq9P/Rs/gX5/i1Vz5Yxy4R/px7Yx598qufxA2WW1bmXCocQWXOKCtjwAMAj0nDA+zmHs9lY9St+7Eh1+8O4etLRTaXtmj5aW53JnytTWtZJg+p050TS0CIYzkknA8Lb6n2totu9ltVtbL81d6r5H52qYDx4sqWH04gexG3zk9k9lW0DnloDnO8DIJK4vceinuOgtYUkBaJJLVU8eRIH0t5nxn2C1+PVtZl7w5fYmnmptq9LsmYGueKqUDId9Mk73NPWfIPjyFyfxKXJ1Poi32yOJz5LldImNwxrziAF+BnsOJIwR35C2nw7XOCu20oqaNuJKCtq4ZAXAnL3+s12B4BD8d+cFcnvTNFqHcTa/SIqPpNW2eqjP6B60gazJYQ4O4sI9uiCEt8T2yvhs1TFVabrtMVMzGV1tqZZYoHENkMEx5Ow3AJ4PzyPZGVMu4VLW1uhdW09CM1MlrqBGPuQ3JA6PkAqKNc7KT1l8i1XoW5NtF8NV60jHSGOAlw+qRha1xa4/wBTcFrslauqvHxGw2x9uq9GWiu9aGSnkqWPa57hJ/L5OEczQ39XnA8ZKncmLF6zl32xNxdctr9OF9Q2WSnNRTEDGY2xSu4McB4IYR57x2peUG7E6H1JoexXumv9NHBNU1zJIomTNmw1kfEklhIGT+cqclrjpmix6qjpK6CSnq6WKogfjnFKxsjHYORlrgQe1kIqjjYtutBQVTauLRtpZO05a8UrDjrHg9ePwuviiigiihhibHFG0NZGwBrWtHgNA6AH2C+0TEXNERFUERFAREQEREBERBrL1dqWwWm5XarP+r0NNJUyY8lsTS7A/JxgKrWzu2NBq2Cv1tqmj+bkuFfNLSQVI9Rj2OcfUkkBxzLnEhp9sZXZfEPfqiDT1n0vQnlWX+ubE6MN5uMMZBwAMn6nluOjnBwpg0ZYTpfSthsh9MuoqVkTzGCGl/bnHsnOSSSffzgLO7j01qOmAwAERcnqzW2nNEU9HU36tfTxVMpihLIXzcntHIjDASOvutaZdYiDwsasq6e30lVWVLy2CnhkmlcASQyJpe4gDz0EGTkfdFRIby7pS1tTrGIzf2Yiubac0piBpmh7SWxHjhxcGjJOf1Yz5V37Zc6G82+juVvqGz0lVE2WGRhDg5rvHj3Hgj2KkuVswjXe27ss22+oJC6VstSIqWF0cvpOa+R4IdkEHAAyQPI68LhPhmv9VctJ3e01E0kgtdZGKcuA4shqGlwjbjvpzXHv7rJ3WfDqfcfbHRU07m0hqjcKxsZy48QeAP2yGEBwPuVrNpYH2bd/du0v4UzXyunipGOa1nF0/Njmsb19LHjx+kHCzny/q/rhZ1Fg3S40tntlwudY5zaajppaiZzWl5EcTS5xAHZOB4XH6D3H09uJBcZrM2rYaKSNk0dVEI3D1QS0ji5wIOD7raTt3yrDvHWXHXGstN7ZWqqEcM3GrucrW+p6RGXN5jLfpjb9RGeyR7qz4GS0fcgf4qoe211/ieq95twpTHHNRU9QyCOQ8WtDg4sD+OARiENP3Kzy9LxaXZvRlmv25F/u9LbWtsVimIoB6pla6oa7jE/m79Zw0yZHQOOsK1WuqyC36M1ZUzlwiZaasO4jkRzjLB1+7lDPwx0Ho6KvFdydmruz2lhbgN9CNoyD755f5Lqt/L6LNttd4mSsbNcXx0bGuwS5jzyk4jBz9LT+yTE4nuMT4dqBlHtdbJmyOcaytrJ3g4w1wf6OBj2xGD+5UdfFPbGuptIXQOaHtfVUpaGfU4ODZAS7zhuDgflTrtTZXWDbzStC5zHONGKhxYSW5qiZ+s//AD/ZYe6e3Ee5Fmo6IXR1FUUk7poJOHqMJc3gWvHRx+R4Ux4wz5Os0hO6q0npmdxeXPtdGXF55OJ9JuSSCcknvyuiOD5zj3wtPp6zxafsNntEQZwoqOGDLAQ0ljQHOAOT9RyVuFuaiVUTai4f6N9ydX6FuU8UVHUPdPTTTSsaGujb6kZc92M84ne/uFn6Mnotf783/UtKW1FstVJxpJw3gHEMEEbiHA8vLiD0fBUl7mbO2fceeirnV77fcKeN0ZnZE2QTR+WtkBIP0nwc+OsLqNAaCs+31jjttA31J5OL62rcMPqJQMcj9mjOGt9h+ViS5x6XMdymMoi2yIiICIiAiIgIiICIiAiIgIiICIiCq+9M8FLuttFUVM7IoIp4XyyPcGtY1tW0lzifAHuVajIPYII+4UY7p7cUm4thbSh7YblSF8lBUOzxDnDBjfj+h5AyeyMZAUSaH3S1Hom60eitx6R8HEMho7lIQPp5cGuleTxfFgYEg7GO1nVa3FqVTn4o74TW6WsLY/pjhlr3vIH1GRxiaAc/7hz+4Vw45Y5o45YpGvje0OY9pDmua4ZBBHRB9iqLbpfw7Vd+3fu5ppS6wQW2ipZuT2tEzahsEnJpABJHIAfjITlqHHa7Nklkns1omkpxA+Sip3uhaSRGXRglgzk/T47Ueb311Vb9r9TzUszopHNp4S5vn05pmxvH4y0kLttJVLavS2mqgTCX1LXRuMgdy5H0m5OR578rF1xptmr9J3yxuLWuq6ctic/9LJmEPjccfZwCu+P8T2gGpstBQ/DG8RxF3q2+C4HmeXGeWdmXN+2B4+yk7Y4VI2v0v6743NLJzDwBH8r1nYDs+XA5yqotuepamyWnZyvoZaKuj1BG173ytY30JCXem/IOQHO5tcCQRjCvUI6HSOmDHSxPNHZ7a70oy4czHSxEgEn+ohvZ+6zPvxqof0bVy3/e3cW8U1QZ7ZQ22C1tkLumytcwuYwe7eTHkn7/ALrndIfyPiS19DHhsb6KZ7mj3dxhdnvvyStr8OFpmGmr1qWsD3Vl6uEjjK9uDJHCT9QI8hz3O9h2Fq56ien+KGijgkLGVNo9OdrQPrYKR0mHf8zQf+CfP+n1Ie+lf8hthqTDnB1SIKZpaSD/ADZBnx9wCD7FVm0tLVbN6k0Pe5pp32TUNmp5qzA+gCdv1NJ44JhcQ/A7x1lTZ8S1dJDom00EUzGmuu8THxkZc9kTHPy0DJwHYzj9lINft3Z7/t/adKXIl7aW3U0MNWIwJopIo2tErA7tp6+odZHRSzNJpItPPDUR09RDK2SGQMkZI05a5jsODgfcEdhfnvT3WXSGm959N17nUN2rqqkZHDIAS9gnPqsA78xv5ZHWPdSLTVu+20lKbUyzNvlqbJ6dFJ6UlY1jWknDPRcHsDh3xf49lFWrtM7i18/9utUaUl+Wqpo5Kr02egSxjR3IxmXxNc0Y5kf5qcrkkwuds5Z6yxbbaYo6wNE7oZKkhpzhtVIZmgn78XDKh7d+V24O5Oj9AUHJ8dJIZ7i5pA4eoA5+TglpZEP8XYwsu6/E1YXWp0enbBXyXV8YZDHOxjYYnluAf5bnF4afYAZXT7KbeXbTrbtqbUrX/wAeuxPJkpDpIYnHm4vOT9chwXDyMYKudSJrtPUbI4mMjiYGRsaGsaAAGtHQAA8YX0vV4ujIiIoCIioIiKAiIgIiICIiAiIgIiICIiAiIgIiIC5XWWj7Rraw1VoucDXNeC6CYty6nmx9MjPfI9x7jorqkSzKxU3bjV172wud60NrOojigoKCartUrsemRHyl4scBycyUZLR5BHEBZG3un5bnsfrurqyGzX03Gu5yRciBC3LTlxy8cmEtOeiVk/E/YqGXTtjvvNkdbTVnygycGWKZpfxAwclpbnyMDKmnb230UO3ekaKOOF9NJZqcPHEmOT14+UhIeMkOLiSD91jFzZ8aunL7EXcXfbHT5MjXSUZmo3ta0t4ei8loOfJ4OBJH3UtzzQ08M088jY4YmOkke44DWMHIuJPgADKrL8Ptayw1+stCV0hFworhJPG0t4teyPETyOzg5AOPOF0vxA6rmsukobJRfVX32U0zYwwucYB/ecceHElrR58lWXxT9kJ23R923rn3B1q0yU9S2eNtmbyDGPfDg+k4gHJbGGgEf1Htbys3dq9Q7Pawtd4kih1JSiGilZK3g6qillaxz+JxiUAEPaPBGVZnQGmGaP0fYrIGkSU9PyqMkEmeU85OxnoOJAx7KrXxCaattk1np3UEVTFC67S8qtssQmY19M5gMpj8vaWn62++Me6llkysveFr9F2iSwaS03apOQkpLfBE8OxyDw3LgePXROOlAe9jJdK692+123HysErKWpDWkO/lPLyXFpBdyY8gD8YVoIpI5o45YpGSRva17HsILXNcMgtI6wR4Wg1VpWz6zslVZrvC59LMWuyx3F7Hs7a9ju8Ef5jpaszJhn32rVutd7duNrvbjTNgqPmHQVDamapjGWxx1IZIDg8c8Y2cnd/jyrcE5JP3JP8AiVFWgNodLbe1NXW281FVWTAxtqKotc6KIn9DAwNAz/U7yVKiSbtLdSPQSOwSP2Xw9rZGvY9oc1wLXBwyCHdEEHyD7hfSKo1VFYrJbp31FFZ6KmmeSXSw08cbySA3y0A+BhbVETEBERAREQEREBERAREQEREBERAREQEREBERAREQEREBEQqin/xS3h7pNKWRrz6bWT1srRJ05xIiZlv3aAcH8lWD2tcZNudEkzyS/wCyqccnta0/SMccN6w3HEHyQO+1U7c+R2otQ7r39zYpKS0x0VnpHSkyNbI6RrT6JYMZ+l57P05Vutt28dvtEZke8myURy93I9xA4z9h4A9gsce+VaukKbp6S1pp7WdNuDoilfNM+NkdfS07HPe8sGC6SMZ5xyNADsdgjPntYmgrRrLc3W9FrjWNt+UttrjItlK6N0THyciWcGP7c1hPJzz5IAVql75OSST9yn4n5PFTL4izWai1dbLPb6cTGzWSor6stDssY88ncusY4tbjHucK5qrdQ0TNS777hsdmOnpdOfw2oIcOZ9djG82dEe/v4Tl8OO8pG2eu4ve22lKkyOfJFSmllL3BzudM4x949sAYz7KS1Wb4YKmZ2ldR0TiPSprqDGMAEGWIcsn3zxCsyrx0l2IiKoIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAtJf7yzT1pul3qWNNJQ0/wAxIQ48y1mS4AAEZ8cfufOAt2oV+IK5/wAO2xu8bXytkramkpWGM4/VJ6jg45H0lrCD91LpZuKzVtbKdqLHbnmKS5aw1JU1072Rgy+nDJ6I5AYOTJkt4jGMhX6o6VtDSUtIzjwp4Y4RxaGjEbQ3oDoDrwqX7SUMestwNPzwQ87NpK0wtjcWcA6oIJ5uYcjm+VznZ6OGg5yrsqcV5CIi0yfhVz2ZaLpuHu/fvnJKhrrs2lilzyjfGJXubxd78WsAGPAVhaqc0tNU1AaHGGJ8oaTgH02l2P8AjhQf8O0cQ0FPcW8muuF5rKmVhOQ1zS1gDevsPdZ5bkamq1ew0DhdN1qg1Eha7UUkfok/QC173cx/vHOD+FYtVy+HmY18O4V0jbM2lrb++WFsjQAQ7k/OfdwDgHDJAVjVeOkuxERVBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQFGG623km41gp7fBcxR1NNUevE54c6J54lpbIGnP7O7x9lJ6JZlUc7Zbe0m3WnhbmSx1NbPIZayrbHwMjj+lozk8GDoA/k+6kZESTCCIiDWXuaOns14mldxjjoqhzzgnAEZ9goH2vrYdM7CTXWGu5uhpLlVco2BxhmLi1rcHIJaQCc/dS1uJ/4A1vkZ/2HX/8AZcqwzXmhofhhp2UrJYpaqt+TkLPp5zfMGWQuOf0OY3B+/jCzy6v8amku/DrQmk2yoZzNzNbX1lQRjHAh4h4/n+7zn8qclxu3lvdatC6Ro3vDnR2qmJcG8c828/B+3LC7JWaiXYiIqgiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiKjQaron3LS+pKFnpcqi2VcTfVBLMvicPqDcHH3wqI2FlLrCh2n0JTzukbJX1lZcHRgOfCJZMFvRyOMbC4n7EFfoXJGyVj45GhzHtLXNPgtcMEH9woH2/wBkYNC6xrr+27RVNN6dRFRUxgIfC2ZwwS9x/U1o45A7ysWW1qXpPQREW2RERQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREH/9k=\",\n        \"requested_by\": \"API User\"\n    }\n}"},{"id":"168af7e6-178c-4291-b552-39cf886499bb","name":"NIN Phone Verification - Request Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"080000000-\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/nin-phone"},"status":"Unprocessable Entity","code":422,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 11:49:07 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"230"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"e6-iEpkA0xgDVzJnRzXJIJFg7v5YqQ\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Set-Cookie","value":"__cf_bm=cKbNvAIgYf6mLf2ezzsGWRgJJ9.2Jh0Si2xfVR8bRLc-1751802547-1.0.1.1-3eA3B_lyTCT3ucDPVka42lGu.xUVrfSc4we2VlkYwDT98dVDrSsqZup_9l3DnOlQ.ibJ_SnfLqRi6Xm0DZ0uMa6owgPV3C6.EtZ4ICi9iag; path=/; expires=Sun, 06-Jul-25 12:19:07 GMT; domain=.korapay.com; HttpOnly; Secure; SameSite=None"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95aee07e58ddcd30-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"validation_error\",\n    \"message\": \"It seems there`s an issue with your input. Please correct it and try again.\",\n    \"data\": {\n        \"id\": {\n            \"message\": \"id with value 080000000- fails to match the required pattern: /^\\\\d+$/\"\n        }\n    }\n}"},{"id":"6607ed3c-5a05-42eb-ac84-d6d40aba8372","name":"NIN Phone Verification - Not Found","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"08000000001\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/nin-phone"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 11:50:16 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"3f-Nmcea/jSg0pU3hWe8zFkZ2k4q+o\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95aee2313ad763f5-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"NIN phone data not found\",\n    \"data\": {}\n}"}],"_postman_id":"3f27f755-5ce0-4b7a-8f7b-e76fececb8ae"},{"name":"Phone Verification","id":"1fb0dc93-0c0e-41d7-9d8a-ead35da73ea2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"08000000000\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/phone","description":"<p>This endpoint allows you to verify the validity of a Nigerian phone number</p>\n<p><strong>Payload</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>id</td>\n<td>string</td>\n<td><code>Required</code> Phone number</td>\n</tr>\n<tr>\n<td>verification_consent</td>\n<td>boolean</td>\n<td><code>Required</code> Indicates whether the user has provided explicit consent for their ID to be verified</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","identities","ng","phone"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"c6ace1d8-f73c-4186-8f0a-619fa80afdab","name":"Phone Verification - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"08000000000\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/phone"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 11:50:41 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"126-6rKxyNUkQFbfhbi42EFykUVtTg0\""},{"key":"vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"content-security-policy","value":"frame-ancestors 'none'"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95aee2ca1edf63f5-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Phone number verified successfully\",\n    \"data\": {\n        \"reference\": \"VR-b59OlDsDcqM3xi4fa\",\n        \"id\": \"08000000000\",\n        \"id_type\": \"ng_phone\",\n        \"first_name\": \"JOHN\",\n        \"last_name\": \"DOE\",\n        \"middle_name\": \"MICHAEL\",\n        \"full_name\": \"JOHN MICHAEL DOE\",\n        \"date_of_birth\": \"1977-04-04\",\n        \"requested_by\": \"API User\"\n    }\n}"},{"id":"1407e25c-48cc-4475-bd36-6789d6ad8239","name":"Phone Verification - Request Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"080000000-\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/phone"},"status":"Unprocessable Entity","code":422,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 11:51:05 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"230"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"e6-iEpkA0xgDVzJnRzXJIJFg7v5YqQ\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95aee360eabb63f5-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"validation_error\",\n    \"message\": \"It seems there`s an issue with your input. Please correct it and try again.\",\n    \"data\": {\n        \"id\": {\n            \"message\": \"id with value 080000000- fails to match the required pattern: /^\\\\d+$/\"\n        }\n    }\n}"},{"id":"dd2bd27e-437c-441e-81ad-303ed39358e2","name":"Phone Verification - Not Found","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"08000000001\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/phone"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 11:51:19 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"42-VjQW9evCcmSPmPvunrIYFWxsse0\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95aee3b9684263f5-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Phone number data not found\",\n    \"data\": {}\n}"}],"_postman_id":"1fb0dc93-0c0e-41d7-9d8a-ead35da73ea2"},{"name":"CAC Verification","id":"65a159b2-60ba-4dbd-b7bf-3e15c8da4939","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"00000011\",\n    \"registration_type\": \"RC\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/cac","description":"<p>This endpoint allows you to verify the validity of a Nigerian corporate affairs commission(CAC)</p>\n<p><strong>Payload</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>id</td>\n<td>string</td>\n<td><code>Required</code> Corporate affairs commission number</td>\n</tr>\n<tr>\n<td>registration_type</td>\n<td>string</td>\n<td><code>Required</code> One of <code>RC</code>, <code>BN</code>, <code>IT</code>, <code>LP</code>, or <code>LLP</code></td>\n</tr>\n<tr>\n<td>registration_name</td>\n<td>string</td>\n<td><code>Optional</code> Business name</td>\n</tr>\n<tr>\n<td>verification_consent</td>\n<td>boolean</td>\n<td><code>Required</code> Indicates whether the user has provided explicit consent for their ID to be verified</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","identities","ng","cac"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"a9d89a9d-ec87-4ab5-8709-2791644ab382","name":"CAC Verification - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"00000011\",\n    \"registration_type\": \"RC\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/cac"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 11:56:04 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"1b89-i7BxnUOhQ4YUE94kJtVRvCULv2I\""},{"key":"vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"content-security-policy","value":"frame-ancestors 'none'"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95aeeab1ebfed4d5-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"CAC verified successfully\",\n    \"data\": {\n        \"reference\": \"VR-TCGSjd4tgYaquSE20\",\n        \"id\": \"RC00000011\",\n        \"id_type\": \"ng_cac\",\n        \"name\": \"John Doe Inc\",\n        \"email\": \"johnfakedoe@gmail.com\",\n        \"phone_number\": \"+1 000 000 0000\",\n        \"search_business_name\": null,\n        \"former_name\": null,\n        \"brand_name\": null,\n        \"registration_number\": \"RC00000000\",\n        \"registry_number\": \"00000000\",\n        \"vat_number\": \"00000000-0001\",\n        \"registration_date\": \"2017-06-09T00:00:00.000+00:00\",\n        \"registration_submission_date\": \"2017-05-31T11:22:07.713+00:00\",\n        \"date_dissolved\": null,\n        \"tin\": \"00000000-0001\",\n        \"jtb_tin\": null,\n        \"tax_office\": null,\n        \"website_email\": null,\n        \"type_of_entity\": \"PRIVATE COMPANY LIMITED BY SHARES\",\n        \"activity\": \"Information service activities\",\n        \"address\": \"1ST FLOOR,SUM HOUSE,Fake Street\",\n        \"state\": \"LAGOS\",\n        \"lga\": \"Lagos Mainland\",\n        \"city\": \"YABA\",\n        \"branch_address\": \"1ST FLOOR,SUM HOUSE,Fake Street, YABA, LAGOS STATE \",\n        \"head_office_address\": null,\n        \"objectives\": \"\",\n        \"company_status\": \"ACTIVE\",\n        \"last_updated_at\": \"2022-03-30T14:19:35.571+00:00\",\n        \"share_capital_in_words\": \"TEN MILLION NAIRA\",\n        \"paid_share_capital\": \"10000000\",\n        \"subscribed_share_capital\": \"10000000\",\n        \"shares_value\": \"0.01 NGN\",\n        \"activity_description\": \"Information service activities\",\n        \"shares_issued\": \"10000000\",\n        \"parent_country\": null,\n        \"company_contact_persons\": [\n            {\n                \"contacts\": {\n                    \"email\": [\n                        \"jeneki2000@yahoo.co.uk\"\n                    ],\n                    \"phone\": [\n                        \"08034926354\"\n                    ]\n                },\n                \"name\": \"Eboikpomwen  Eki \"\n            }\n        ],\n        \"country\": \"ng\",\n        \"key_personnel\": [\n            {\n                \"name\": \"PETER DOE\",\n                \"designation\": \"WITNESS\",\n                \"is_corporate\": false,\n                \"appointed_on\": null,\n                \"resigned_on\": null,\n                \"shares_type\": \"\",\n                \"shares_value\": null,\n                \"shares_count\": null,\n                \"occupation\": \"LAWYER\",\n                \"nationality\": null,\n                \"birth_year\": null,\n                \"birth_month\": null,\n                \"birth_date\": null,\n                \"date_of_birth\": null,\n                \"gender\": \"\",\n                \"address\": \"8C, NONE STREET, ZONE 4\",\n                \"country_of_residence\": \"NIGERIA\",\n                \"number\": \"\",\n                \"is_foreign\": \"false\",\n                \"document_type\": \"\",\n                \"document_issued_by\": null,\n                \"document_issued_on\": null,\n                \"document_number\": \"\",\n                \"email\": \"\",\n                \"phone_number\": \"\",\n                \"status\": \"ACTIVE\",\n                \"companies\": []\n            },\n            {\n                \"name\": \"SUSAN DOE\",\n                \"designation\": \"SECRETARY_COMPANY\",\n                \"is_corporate\": false,\n                \"appointed_on\": null,\n                \"resigned_on\": null,\n                \"shares_type\": \"\",\n                \"shares_value\": null,\n                \"shares_count\": null,\n                \"occupation\": \"SECRETARY\",\n                \"nationality\": \"NIGERIA\",\n                \"birth_year\": null,\n                \"birth_month\": null,\n                \"birth_date\": null,\n                \"date_of_birth\": null,\n                \"gender\": \"FEMALE\",\n                \"address\": \"11, NONE CRESCENT\",\n                \"country_of_residence\": \"NIGERIA\",\n                \"number\": \"\",\n                \"is_foreign\": \"false\",\n                \"document_type\": \"\",\n                \"document_issued_by\": null,\n                \"document_issued_on\": null,\n                \"document_number\": \"\",\n                \"email\": \"\",\n                \"phone_number\": \"\",\n                \"status\": \"ACTIVE\",\n                \"companies\": []\n            },\n            {\n                \"name\": \"MICHAEL DOE\",\n                \"designation\": \"DIRECTOR\",\n                \"is_corporate\": null,\n                \"appointed_on\": null,\n                \"resigned_on\": null,\n                \"shares_type\": null,\n                \"shares_value\": null,\n                \"shares_count\": null,\n                \"occupation\": \"BUSINESS\",\n                \"nationality\": \"NIGERIA\",\n                \"birth_year\": null,\n                \"birth_month\": null,\n                \"birth_date\": null,\n                \"date_of_birth\": null,\n                \"gender\": \"MALE\",\n                \"address\": \"1, NONE STREET, \",\n                \"country_of_residence\": \"NIGERIA\",\n                \"number\": null,\n                \"is_foreign\": \"false\",\n                \"document_type\": null,\n                \"document_issued_by\": null,\n                \"document_issued_on\": null,\n                \"document_number\": null,\n                \"email\": null,\n                \"phone_number\": null,\n                \"status\": \"ACTIVE\",\n                \"companies\": []\n            },\n            {\n                \"name\": \"JANE DOE  INC\",\n                \"designation\": \"SHAREHOLDER\",\n                \"is_corporate\": true,\n                \"appointed_on\": \"2021-03-17T14:07:43.000+00:00\",\n                \"resigned_on\": null,\n                \"shares_type\": \"ORDINARY\",\n                \"shares_value\": \"9990000\",\n                \"shares_count\": \"9990000\",\n                \"occupation\": null,\n                \"nationality\": null,\n                \"birth_year\": null,\n                \"birth_month\": null,\n                \"birth_date\": null,\n                \"date_of_birth\": null,\n                \"gender\": null,\n                \"address\": \"01 COASTAL HIGHWAY,LEWES DE 000000  USA,COUNTY OF SUSSEX\",\n                \"country_of_residence\": \"UNITED STATES\",\n                \"number\": null,\n                \"is_foreign\": \"true\",\n                \"document_type\": null,\n                \"document_issued_by\": null,\n                \"document_issued_on\": null,\n                \"document_number\": null,\n                \"email\": null,\n                \"phone_number\": null,\n                \"status\": \"ACTIVE\",\n                \"companies\": []\n            },\n            {\n                \"name\": \"JOHN DOE\",\n                \"designation\": \"SHAREHOLDER\",\n                \"is_corporate\": null,\n                \"appointed_on\": null,\n                \"resigned_on\": null,\n                \"shares_type\": \"ORDINARY\",\n                \"shares_value\": \"10000\",\n                \"shares_count\": \"10000\",\n                \"occupation\": null,\n                \"nationality\": null,\n                \"birth_year\": null,\n                \"birth_month\": null,\n                \"birth_date\": null,\n                \"date_of_birth\": null,\n                \"gender\": \"MALE\",\n                \"address\": \"1 NONE STREET,LEKKI\",\n                \"country_of_residence\": \"NIGERIA\",\n                \"number\": null,\n                \"is_foreign\": \"false\",\n                \"document_type\": null,\n                \"document_issued_by\": null,\n                \"document_issued_on\": null,\n                \"document_number\": null,\n                \"email\": null,\n                \"phone_number\": null,\n                \"status\": \"ACTIVE\",\n                \"companies\": []\n            },\n            {\n                \"name\": \"JOHN DOE INC\",\n                \"designation\": \"PERSONS WITH SIGNIFICANT CONTROL\",\n                \"is_corporate\": true,\n                \"appointed_on\": \"2022-03-30T14:42:16.554+00:00\",\n                \"resigned_on\": null,\n                \"shares_type\": null,\n                \"shares_value\": null,\n                \"shares_count\": null,\n                \"occupation\": null,\n                \"nationality\": null,\n                \"birth_year\": null,\n                \"birth_month\": null,\n                \"birth_date\": null,\n                \"date_of_birth\": null,\n                \"gender\": null,\n                \"address\": \"01 COASTAL HIGHWAY,LEWES DE 000000 \",\n                \"country_of_residence\": \"UNITED STATES\",\n                \"number\": null,\n                \"is_foreign\": \"true\",\n                \"document_type\": null,\n                \"document_issued_by\": null,\n                \"document_issued_on\": null,\n                \"document_number\": null,\n                \"email\": null,\n                \"phone_number\": null,\n                \"status\": \"ACTIVE\",\n                \"companies\": []\n            }\n        ],\n        \"activities\": [],\n        \"legal_entity_identifier_register\": [\n            {\n                \"legal_entity_identifier_code\": \"0000000000000000\",\n                \"legal_name\": \"John Doe PLC\",\n                \"legal_first_address_line\": \"1 FAKE CRICK AVENUE\",\n                \"legal_additional_address_line_1\": \"CAMBRIDGE BIOMEDICAL CAMPUS\",\n                \"legal_additional_address_line_2\": \"\",\n                \"legal_additional_address_line_3\": \"\",\n                \"legal_address_city\": \"CAMBRIDGE\",\n                \"legal_address_region\": \"GB-CAM\",\n                \"legal_address_country\": \"GB\",\n                \"legal_address_postal_code\": \"CB2 0AA\",\n                \"registration_authority_id\": \"R0000000\",\n                \"registration_authority_entity_id\": \"00000000\",\n                \"legal_jurisdiction\": \"GB\",\n                \"entity_category\": \"GENERAL\",\n                \"initial_registration_date\": \"2012-06-06\",\n                \"registration_last_update_date\": \"2021-08-21\",\n                \"registration_next_renewal_date\": \"2022-08-11\",\n                \"registration_managing_lou\": \"0000000000000000\",\n                \"registration_validation_sources\": \"FULLY_CORROBORATED\",\n                \"validation_authority_id\": \"RA000000\",\n                \"validation_authority_entity_id\": \"02700000\",\n                \"entity_status\": \"ACTIVE\",\n                \"status\": \"ISSUED\"\n            }\n        ],\n        \"central_index_key_register\": [\n            {\n                \"cik\": \"000000\",\n                \"entity_type\": \"operating\",\n                \"sic\": \"3711\",\n                \"sic_description\": \"Motor Vehicles & Passenger Car Bodies\",\n                \"name\": \"John Doe, Inc.\",\n                \"ein\": \"000000000000\",\n                \"description\": \"\",\n                \"website\": \"\",\n                \"investor_website\": \"\",\n                \"tickers\": [\n                    \"JOL\"\n                ],\n                \"state_of_incorporation\": \"DE\",\n                \"business_address_street_1\": \"3500 FAKE ST ROAD\",\n                \"mailing_address_city\": \"PALO ALTO\",\n                \"business_address_street_2\": null,\n                \"business_address_city\": \"PALO ALTO\",\n                \"business_address_state_or_country\": \"CA\",\n                \"business_address_zip_code\": \"123454\",\n                \"business_address_state_or_country_description\": \"CA\",\n                \"phone_number\": \"000-000-0000\",\n                \"former_names\": [\n                    {\n                        \"from\": \"2005-02-17T00:00:00.000Z\",\n                        \"to\": \"2017-01-27T00:00:00.000Z\",\n                        \"name\": \"JOL MOTORS INC\"\n                    }\n                ]\n            }\n        ],\n        \"filings\": [\n            {\n                \"date\": \"2020-10-31\",\n                \"name\": \"Dissolution\",\n                \"type\": \"Dissolution\",\n                \"status\": null,\n                \"type_code\": null\n            },\n            {\n                \"date\": \"2017-09-27\",\n                \"name\": \"Incorporation\",\n                \"type\": \"Incorporation\",\n                \"status\": null,\n                \"type_code\": null\n            }\n        ],\n        \"affiliates\": [\n            {\n                \"name\": \"John Doe 1\",\n                \"brand_name\": null,\n                \"short_name\": null,\n                \"company_number\": \"0000.000.000\",\n                \"country\": \"NG\"\n            },\n            {\n                \"name\": \"John Doe 2\",\n                \"brand_name\": null,\n                \"short_name\": null,\n                \"company_number\": \"0000.000.0000\",\n                \"country\": \"NG\"\n            }\n        ],\n        \"search_term\": \"RC00000011\",\n        \"requested_by\": \"API User\"\n    }\n}"},{"id":"4bb18c98-a3f0-4425-a8f3-b7da941431d0","name":"CAC Verification - Request Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"000000Y\",\n    \"registration_type\": \"RC\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/cac"},"status":"Unprocessable Entity","code":422,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 12:00:55 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"227"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"e3-Tiho4RHq81V/KFGlx0zrOmnGBQ0\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95aef1c73fb016c3-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"validation_error\",\n    \"message\": \"It seems there`s an issue with your input. Please correct it and try again.\",\n    \"data\": {\n        \"id\": {\n            \"message\": \"id with value 000000Y fails to match the required pattern: /^\\\\d+$/\"\n        }\n    }\n}"},{"id":"ff54ed66-1d17-445c-8a6b-118ae7c3306c","name":"CAC Verification - Not Found","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"00000019\",\n    \"registration_type\": \"RC\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ng/cac"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 12:01:21 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"39-nKrlswSevuYOEcqKNagodOXXIqA\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95aef269ef9e16c3-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"CAC data not found\",\n    \"data\": {}\n}"}],"_postman_id":"65a159b2-60ba-4dbd-b7bf-3e15c8da4939"}],"id":"04ee82aa-ea65-4b20-8579-aa4aee5bca0e","description":"<p>This folder contains endpoints for verifying Nigerian identities</p>\n","_postman_id":"04ee82aa-ea65-4b20-8579-aa4aee5bca0e"},{"name":"Ghana","item":[{"name":"Passport Verification","id":"a217425f-76d2-4b10-a648-501373af57e0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"G0000555\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/gh/passport","description":"<p>This endpoint allows you to verify the validity of a Ghanaian passport</p>\n<p><strong>Payload</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>id</td>\n<td>string</td>\n<td><code>Required</code> Passport number</td>\n</tr>\n<tr>\n<td>verification_consent</td>\n<td>boolean</td>\n<td><code>Required</code> Indicates whether the user has provided explicit consent for their ID to be verified</td>\n</tr>\n<tr>\n<td>validation</td>\n<td>object</td>\n<td><code>Optional</code> Additional validation fields for enhanced verification</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>Validation</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>first_name</td>\n<td>string</td>\n<td><code>Optional</code> First name of the individual for cross-verification</td>\n</tr>\n<tr>\n<td>last_name</td>\n<td>string</td>\n<td><code>Optional</code> Last name of the individual for cross-verification</td>\n</tr>\n<tr>\n<td>date_of_birth</td>\n<td>string (YYYY-MM-DD)</td>\n<td><code>Optional</code> Date of birth of the individual</td>\n</tr>\n<tr>\n<td>selfie</td>\n<td>string (URL or Base64)</td>\n<td><code>Optional</code> URL to a selfie image used for facial recognition</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","identities","gh","passport"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"5227dd01-62b5-4e3e-abf2-4aba866f332f","name":"Passport Verification - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"G0000555\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/gh/passport"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 12:17:50 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"414b-zLiLD/j8QpYnEhCiStoFUXh0Nck\""},{"key":"vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"content-security-policy","value":"frame-ancestors 'none'"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Set-Cookie","value":"__cf_bm=96v.KdiCA9uhPCzmjiS3qQL7GJko4In88B3PDBunpGg-1751804270-1.0.1.1-rgoiDhzzWie7d7h7BSobm_L8FofgEZvx0YkJgF_NWk1GJB.0Mdlxk6PAku.FTTCokP0TVGLJ.0J1wXT9zKfdcK7XveSUH2dqw3uEg6_OcFc; path=/; expires=Sun, 06-Jul-25 12:47:50 GMT; domain=.korapay.com; HttpOnly; Secure; SameSite=None"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95af0a923f5593db-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Passport verified successfully\",\n    \"data\": {\n        \"reference\": \"VR-NyS2LKsbUvQN1wkMI\",\n        \"id\": \"G0000555\",\n        \"id_type\": \"gh_passport\",\n        \"first_name\": \"SAMUEL\",\n        \"last_name\": \"KUDUS\",\n        \"middle_name\": \"MICHAEL\",\n        \"full_name\": \"SAMUEL MICHAEL KUDUS\",\n        \"gender\": \"male\",\n        \"date_of_birth\": \"1955-05-25\",\n        \"place_of_birth\": \"ACCRA\",\n        \"nationality\": \"GHANAIAN\",\n        \"issued_at\": \"ACCRA\",\n        \"issued_date\": \"2023-03-10\",\n        \"expired_date\": \"2030-03-11\",\n        \"image\": \"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\",\n        \"signature\": \"data:image/jpg;base64,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Rraw1VoucDXNeC6CYty6nmx9MjPfI9x7jorqkSzKxU3bjV172wud60NrOojigoKCartUrsemRHyl4scBycyUZLR5BHEBZG3un5bnsfrurqyGzX03Gu5yRciBC3LTlxy8cmEtOeiVk/E/YqGXTtjvvNkdbTVnygycGWKZpfxAwclpbnyMDKmnb230UO3ekaKOOF9NJZqcPHEmOT14+UhIeMkOLiSD91jFzZ8aunL7EXcXfbHT5MjXSUZmo3ta0t4ei8loOfJ4OBJH3UtzzQ08M088jY4YmOkke44DWMHIuJPgADKrL8Ptayw1+stCV0hFworhJPG0t4teyPETyOzg5AOPOF0vxA6rmsukobJRfVX32U0zYwwucYB/ecceHElrR58lWXxT9kJ23R923rn3B1q0yU9S2eNtmbyDGPfDg+k4gHJbGGgEf1Htbys3dq9Q7Pawtd4kih1JSiGilZK3g6qillaxz+JxiUAEPaPBGVZnQGmGaP0fYrIGkSU9PyqMkEmeU85OxnoOJAx7KrXxCaattk1np3UEVTFC67S8qtssQmY19M5gMpj8vaWn62++Me6llkysveFr9F2iSwaS03apOQkpLfBE8OxyDw3LgePXROOlAe9jJdK692+123HysErKWpDWkO/lPLyXFpBdyY8gD8YVoIpI5o45YpGSRva17HsILXNcMgtI6wR4Wg1VpWz6zslVZrvC59LMWuyx3F7Hs7a9ju8Ef5jpaszJhn32rVutd7duNrvbjTNgqPmHQVDamapjGWxx1IZIDg8c8Y2cnd/jyrcE5JP3JP8AiVFWgNodLbe1NXW281FVWTAxtqKotc6KIn9DAwNAz/U7yVKiSbtLdSPQSOwSP2Xw9rZGvY9oc1wLXBwyCHdEEHyD7hfSKo1VFYrJbp31FFZ6KmmeSXSw08cbySA3y0A+BhbVETEBERAREQEREBERAREQEREBERAREQEREBERAREQEREBEQqin/xS3h7pNKWRrz6bWT1srRJ05xIiZlv3aAcH8lWD2tcZNudEkzyS/wCyqccnta0/SMccN6w3HEHyQO+1U7c+R2otQ7r39zYpKS0x0VnpHSkyNbI6RrT6JYMZ+l57P05Vutt28dvtEZke8myURy93I9xA4z9h4A9gsce+VaukKbp6S1pp7WdNuDoilfNM+NkdfS07HPe8sGC6SMZ5xyNADsdgjPntYmgrRrLc3W9FrjWNt+UttrjItlK6N0THyciWcGP7c1hPJzz5IAVql75OSST9yn4n5PFTL4izWai1dbLPb6cTGzWSor6stDssY88ncusY4tbjHucK5qrdQ0TNS777hsdmOnpdOfw2oIcOZ9djG82dEe/v4Tl8OO8pG2eu4ve22lKkyOfJFSmllL3BzudM4x949sAYz7KS1Wb4YKmZ2ldR0TiPSprqDGMAEGWIcsn3zxCsyrx0l2IiKoIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAtJf7yzT1pul3qWNNJQ0/wAxIQ48y1mS4AAEZ8cfufOAt2oV+IK5/wAO2xu8bXytkramkpWGM4/VJ6jg45H0lrCD91LpZuKzVtbKdqLHbnmKS5aw1JU1072Rgy+nDJ6I5AYOTJkt4jGMhX6o6VtDSUtIzjwp4Y4RxaGjEbQ3oDoDrwqX7SUMestwNPzwQ87NpK0wtjcWcA6oIJ5uYcjm+VznZ6OGg5yrsqcV5CIi0yfhVz2ZaLpuHu/fvnJKhrrs2lilzyjfGJXubxd78WsAGPAVhaqc0tNU1AaHGGJ8oaTgH02l2P8AjhQf8O0cQ0FPcW8muuF5rKmVhOQ1zS1gDevsPdZ5bkamq1ew0DhdN1qg1Eha7UUkfok/QC173cx/vHOD+FYtVy+HmY18O4V0jbM2lrb++WFsjQAQ7k/OfdwDgHDJAVjVeOkuxERVBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQFGG623km41gp7fBcxR1NNUevE54c6J54lpbIGnP7O7x9lJ6JZlUc7Zbe0m3WnhbmSx1NbPIZayrbHwMjj+lozk8GDoA/k+6kZESTCCIiDWXuaOns14mldxjjoqhzzgnAEZ9goH2vrYdM7CTXWGu5uhpLlVco2BxhmLi1rcHIJaQCc/dS1uJ/4A1vkZ/2HX/8AZcqwzXmhofhhp2UrJYpaqt+TkLPp5zfMGWQuOf0OY3B+/jCzy6v8amku/DrQmk2yoZzNzNbX1lQRjHAh4h4/n+7zn8qclxu3lvdatC6Ro3vDnR2qmJcG8c828/B+3LC7JWaiXYiIqgiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiICIiAiIgIiKjQaron3LS+pKFnpcqi2VcTfVBLMvicPqDcHH3wqI2FlLrCh2n0JTzukbJX1lZcHRgOfCJZMFvRyOMbC4n7EFfoXJGyVj45GhzHtLXNPgtcMEH9woH2/wBkYNC6xrr+27RVNN6dRFRUxgIfC2ZwwS9x/U1o45A7ysWW1qXpPQREW2RERQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREBERAREQEREH/9k=\",\n        \"requested_by\": \"API User\"\n    }\n}"},{"id":"72e12098-d4c9-4014-b88d-b6928972b8e7","name":"Passport Verification - Request Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"G00005y\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/gh/passport"},"status":"Unprocessable Entity","code":422,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 12:18:12 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"267"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"10b-I/iEizobzu8HOgNqg13y9d7VezA\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95af0b198bd693db-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"validation_error\",\n    \"message\": \"It seems there`s an issue with your input. Please correct it and try again.\",\n    \"data\": {\n        \"id\": {\n            \"message\": \"id length must be 8 characters long\",\n            \"customErrorMessage\": \"id should only be 8 characters, no less, no more\"\n        }\n    }\n}"},{"id":"7872aeaf-045a-4312-a7c4-e4b144f4deb1","name":"Passport Verification - Not Found","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"G0000556\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/gh/passport"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 12:19:38 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"3e-E2zVGle7+FQBXdidOVwNc06NaEc\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95af0d355cba9409-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Passport data not found\",\n    \"data\": {}\n}"}],"_postman_id":"a217425f-76d2-4b10-a648-501373af57e0"},{"name":"Driver's License Verification","id":"1d34b766-cc4c-418a-ad19-9ddb5198cae3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"070667\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/gh/drivers-license","description":"<p>This endpoint allows you to verify the validity of a Ghanaian driver's license</p>\n<p><strong>Payload</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>id</td>\n<td>string</td>\n<td><code>Required</code> Driver's license number</td>\n</tr>\n<tr>\n<td>verification_consent</td>\n<td>boolean</td>\n<td><code>Required</code> Indicates whether the user has provided explicit consent for their ID to be verified</td>\n</tr>\n<tr>\n<td>validation</td>\n<td>object</td>\n<td><code>Optional</code> Additional validation fields for enhanced verification</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>Validation</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>first_name</td>\n<td>string</td>\n<td><code>Optional</code> First name of the individual for cross-verification</td>\n</tr>\n<tr>\n<td>last_name</td>\n<td>string</td>\n<td><code>Optional</code> Last name of the individual for cross-verification</td>\n</tr>\n<tr>\n<td>date_of_birth</td>\n<td>string (YYYY-MM-DD)</td>\n<td><code>Optional</code> Date of birth of the individual</td>\n</tr>\n<tr>\n<td>selfie</td>\n<td>string (URL or Base64)</td>\n<td><code>Optional</code> URL to a selfie image used for facial recognition</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","identities","gh","drivers-license"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"cee7e0bd-a529-4051-8448-cd5fd157507c","name":"Driver's License Verification - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"070667\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/gh/drivers-license"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 12:20:02 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"1aa7-CxOc/4MHdmnG2SrJ7on9d5obV4g\""},{"key":"vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"content-security-policy","value":"frame-ancestors 'none'"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95af0dc889569409-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Driver's license verified successfully\",\n    \"data\": {\n        \"reference\": \"VR-bP0TnZn1fA1yxV633\",\n        \"id\": \"070667\",\n        \"id_type\": \"gh_drivers_license\",\n        \"first_name\": \"Jerome\",\n        \"last_name\": \"Ayew\",\n        \"middle_name\": null,\n        \"full_name\": \"Jerome Ayew\",\n        \"date_of_birth\": \"1979-10-10\",\n        \"class_of_license\": \"B\",\n        \"nationality\": \"GHANAIAN\",\n        \"processing_center\": \"AS6\",\n        \"pin\": \"AYEW-0069-00-01\",\n        \"certificate_of_competence\": \"070667\",\n        \"certificate_date\": \"2020-02-05\",\n        \"issued_date\": \"GHANAIAN\",\n        \"expired_date\": \"2030-12-13\",\n        \"image\": \"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\",\n        \"requested_by\": \"API User\"\n    }\n}"},{"id":"9dac5a87-b22d-40db-97bc-8c7646e6e62e","name":"Driver's License Verification - Request Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"0706-\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/gh/drivers-license"},"status":"Unprocessable Entity","code":422,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 12:20:46 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"265"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"109-yHhF51CnjsaeZQyzYjKAQTZsba8\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95af0edc5a799409-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"validation_error\",\n    \"message\": \"It seems there`s an issue with your input. Please correct it and try again.\",\n    \"data\": {\n        \"id\": {\n            \"message\": \"id length must be at least 6 characters long\",\n            \"customErrorMessage\": \"id should have at least 6 characters!\"\n        }\n    }\n}"},{"id":"ef128e3f-0265-459f-85f6-f5b30706f0b8","name":"Driver's License Verification - Not Found","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"070633\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/gh/drivers-license"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 12:22:06 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"46-Qs5qf1v9vmTC3At+X9fJ8a1fzY8\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95af10cfecf1cdbd-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Driver's license data not found\",\n    \"data\": {}\n}"}],"_postman_id":"1d34b766-cc4c-418a-ad19-9ddb5198cae3"},{"name":"SSNIT Verification","id":"2f3e4af7-b8b4-418a-8282-2b98c4fecacf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"C987464748977\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/gh/ssnit","description":"<p>This endpoint allows you to verify the validity of a Ghanaian social security and national insurance trust(SSNIT)</p>\n<p><strong>Payload</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>id</td>\n<td>string</td>\n<td><code>Required</code> SSNIT number</td>\n</tr>\n<tr>\n<td>verification_consent</td>\n<td>boolean</td>\n<td><code>Required</code> Indicates whether the user has provided explicit consent for their ID to be verified</td>\n</tr>\n<tr>\n<td>validation</td>\n<td>object</td>\n<td><code>Optional</code> Additional validation fields for enhanced verification</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>Validation</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>first_name</td>\n<td>string</td>\n<td><code>Optional</code> First name of the individual for cross-verification</td>\n</tr>\n<tr>\n<td>last_name</td>\n<td>string</td>\n<td><code>Optional</code> Last name of the individual for cross-verification</td>\n</tr>\n<tr>\n<td>date_of_birth</td>\n<td>string (YYYY-MM-DD)</td>\n<td><code>Optional</code> Date of birth of the individual</td>\n</tr>\n<tr>\n<td>selfie</td>\n<td>string (URL or Base64)</td>\n<td><code>Optional</code> URL to a selfie image used for facial recognition</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","identities","gh","ssnit"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"b45b6129-6389-4840-b1fd-c94058402bcf","name":"SSNIT Verification - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"C987464748977\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/gh/ssnit"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 12:22:50 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"1a20-Wm5tGRdnOUVIujQlTq2IHC7lkGc\""},{"key":"vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"content-security-policy","value":"frame-ancestors 'none'"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95af11e4df41cdbd-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"SSNIT verified successfully\",\n    \"data\": {\n        \"reference\": \"VR-pB40tEM0pSK6VDM2M\",\n        \"id\": \"C987464748977\",\n        \"id_type\": \"gh_ssnit\",\n        \"first_name\": \"Kwame\",\n        \"last_name\": \"Asante\",\n        \"middle_name\": null,\n        \"full_name\": \"Kwame Asante\",\n        \"date_of_birth\": \"1985-11-12\",\n        \"card_serial\": \"00000012447866\",\n        \"nationality\": \"GHANAIAN\",\n        \"fss_no\": \"C987464748977\",\n        \"gender\": \"male\",\n        \"image\": \"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\",\n        \"requested_by\": \"API User\"\n    }\n}"},{"id":"1409100b-6555-499d-ba3e-5712555110da","name":"SSNIT Verification - Request Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"C987464748-\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/gh/ssnit"},"status":"Unprocessable Entity","code":422,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 12:23:10 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"269"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"10d-QJfoKArbmLjSQCfKKIOC1NXq7L0\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95af1264dfc7cdbd-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"validation_error\",\n    \"message\": \"It seems there`s an issue with your input. Please correct it and try again.\",\n    \"data\": {\n        \"id\": {\n            \"message\": \"id length must be 13 characters long\",\n            \"customErrorMessage\": \"id should only be 13 characters, no less, no more\"\n        }\n    }\n}"},{"id":"dbb7ca9a-388f-4a85-8cca-3dc2fba23b40","name":"SSNIT Verification - Not Found","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"C987464748666\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/gh/ssnit"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 12:23:39 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"3b-9wycV3EYRgAdIiSuXv73IqHk+Y0\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95af13158d9ecdbd-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"SSNIT data not found\",\n    \"data\": {}\n}"}],"_postman_id":"2f3e4af7-b8b4-418a-8282-2b98c4fecacf"},{"name":"Voter's Card Verification (GVC)","id":"bc60ca11-7fb7-4a29-98a0-013790c90437","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"9001330422\",\n    \"type\": \"old_voters_card\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/gh/voters-card","description":"<p>This endpoint allows you to verify the validity of a Ghanaian voter's card(GVC)</p>\n<p><strong>Payload</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>id</td>\n<td>string</td>\n<td><code>Required</code> Voter's card number</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td><code>Required</code> One of <code>old_voters_card</code> or <code>new_voters_card</code></td>\n</tr>\n<tr>\n<td>verification_consent</td>\n<td>boolean</td>\n<td><code>Required</code> Indicates whether the user has provided explicit consent for their ID to be verified</td>\n</tr>\n<tr>\n<td>validation</td>\n<td>object</td>\n<td><code>Optional</code> Additional validation fields for enhanced verification</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>Validation</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>first_name</td>\n<td>string</td>\n<td><code>Optional</code> First name of the individual for cross-verification</td>\n</tr>\n<tr>\n<td>last_name</td>\n<td>string</td>\n<td><code>Optional</code> Last name of the individual for cross-verification</td>\n</tr>\n<tr>\n<td>date_of_birth</td>\n<td>string (YYYY-MM-DD)</td>\n<td><code>Optional</code> Date of birth of the individual</td>\n</tr>\n<tr>\n<td>selfie</td>\n<td>string (URL or Base64)</td>\n<td><code>Optional</code> URL to a selfie image used for facial recognition</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","identities","gh","voters-card"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"27a1c933-c69d-424e-adcf-49c0ababfcfa","name":"Voter's Card Verification (GVC) - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"9001330422\",\n    \"type\": \"old_voters_card\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/gh/voters-card"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 12:24:15 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"1a38-IQ+tb5ffmopTDb/RahrW1iSbZTc\""},{"key":"vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"content-security-policy","value":"frame-ancestors 'none'"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95af13f50a83cdbd-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Voter's card verified successfully\",\n    \"data\": {\n        \"reference\": \"VR-o0Wq48G5PYCtY3nCJ\",\n        \"id\": \"9001330422\",\n        \"id_type\": \"gh_voters_card\",\n        \"first_name\": \"Kamaldeen\",\n        \"last_name\": \"Semenyo\",\n        \"middle_name\": null,\n        \"full_name\": \"Kamaldeen Semenyo\",\n        \"date_of_birth\": null,\n        \"polling_station\": \"G161613\",\n        \"nationality\": \"GHANAIAN\",\n        \"age\": 27,\n        \"voter_type\": \"old_voters_card\",\n        \"gender\": \"male\",\n        \"image\": \"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\",\n        \"requested_by\": \"API User\"\n    }\n}"},{"id":"fc20cacc-8770-4c55-a9e8-b872378165c4","name":"Voter's Card Verification (GVC) - Request Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"90013304-\",\n    \"type\": \"old_voters_card\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/gh/voters-card"},"status":"Unprocessable Entity","code":422,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 12:24:39 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"269"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"10d-h2mggDVw0hVWObGRN/ms2RlpM8U\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95af148f1f2bcdbd-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"validation_error\",\n    \"message\": \"It seems there`s an issue with your input. Please correct it and try again.\",\n    \"data\": {\n        \"id\": {\n            \"message\": \"id length must be 10 characters long\",\n            \"customErrorMessage\": \"id should only be 10 characters, no less, no more\"\n        }\n    }\n}"},{"id":"89fc15f1-182e-47da-90a1-51c8fdfcaa1d","name":"Voter's Card Verification (GVC) - Not Found","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"9001330429\",\n    \"type\": \"old_voters_card\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/gh/voters-card"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 12:25:10 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"42-jQ/o4+zSGCrxuW4h9MshnvlyIFA\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95af154fda87cdbd-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Voter's card data not found\",\n    \"data\": {}\n}"}],"_postman_id":"bc60ca11-7fb7-4a29-98a0-013790c90437"}],"id":"7d2d01d0-0ec3-476d-a388-3921da24877e","description":"<p>This folder contains endpoints for verifying Ghanaian identities</p>\n","_postman_id":"7d2d01d0-0ec3-476d-a388-3921da24877e"},{"name":"Kenya","item":[{"name":"Passport Verification","id":"887cc409-96af-4d69-a108-309a921d6ed5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"A2011111\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ke/passport","description":"<p>This endpoint allows you to verify the validity of a Kenyan passport</p>\n<p><strong>Payload</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>id</td>\n<td>string</td>\n<td><code>Required</code> Passport number</td>\n</tr>\n<tr>\n<td>verification_consent</td>\n<td>boolean</td>\n<td><code>Required</code> Indicates whether the user has provided explicit consent for their ID to be verified</td>\n</tr>\n<tr>\n<td>validation</td>\n<td>object</td>\n<td><code>Optional</code> Additional validation fields for enhanced verification</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>Validation</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>first_name</td>\n<td>string</td>\n<td><code>Optional</code> First name of the individual for cross-verification</td>\n</tr>\n<tr>\n<td>last_name</td>\n<td>string</td>\n<td><code>Optional</code> Last name of the individual for cross-verification</td>\n</tr>\n<tr>\n<td>date_of_birth</td>\n<td>string (YYYY-MM-DD)</td>\n<td><code>Optional</code> Date of birth of the individual</td>\n</tr>\n<tr>\n<td>selfie</td>\n<td>string (URL or Base64)</td>\n<td><code>Optional</code> URL to a selfie image used for facial recognition</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","identities","ke","passport"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"d8c2b95b-017a-4400-a24c-d9cdebaddd8c","name":"Passport Verification - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"A2011111\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ke/passport"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 12:25:46 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"19eb-6nYq9mOd2v6xdFeWMTQIe+Udgwk\""},{"key":"vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"content-security-policy","value":"frame-ancestors 'none'"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95af162dde2dcdbd-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Passport verified successfully\",\n    \"data\": {\n        \"reference\": \"VR-qRn7zb7AlLf0ZPxq5\",\n        \"id\": \"A2011111\",\n        \"id_type\": \"ke_passport\",\n        \"first_name\": \"Alfred\",\n        \"last_name\": \"Anyembe\",\n        \"middle_name\": null,\n        \"full_name\": \"Alfred Anyembe\",\n        \"date_of_birth\": \"1989-09-09\",\n        \"nationality\": \"KENYAN\",\n        \"gender\": \"male\",\n        \"image\": \"/9j/4AAQSkZJRgABAQAAAQABAAD/4gHYSUNDX1BST0ZJTEUAAQEAAAHIAAAAAAQwAABtbnRyUkdCIFhZWiAH4AABAAEAAAAAAABhY3NwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAA9tYAAQAAAADTLQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAlkZXNjAAAA8AAAACRyWFlaAAABFAAAABRnWFlaAAABKAAAABRiWFlaAAABPAAAABR3dHB0AAABUAAAABRyVFJDAAABZAAAAChnVFJDAAABZAAAAChiVFJDAAABZAAAAChjcHJ0AAABjAAAADxtbHVjAAAAAAAAAAEAAAAMZW5VUwAAAAgAAAAcAHMAUgBHAEJYWVogAAAAAAAAb6IAADj1AAADkFhZWiAAAAAAAABimQAAt4UAABjaWFlaIAAAAAAAACSgAAAPhAAAts9YWVogAAAAAAAA9tYAAQAAAADTLXBhcmEAAAAAAAQAAAACZmYAAPKnAAANWQAAE9AAAApbAAAAAAAAAABtbHVjAAAAAAAAAAEAAAAMZW5VUwAAACAAAAAcAEcAbwBvAGcAbABlACAASQBuAGMALgAgADIAMAAxADb/2wBDAAUDBAQEAwUEBAQFBQUGBwwIBwcHBw8LCwkMEQ8SEhEPERETFhwXExQaFRERGCEYGh0dHx8fExciJCIeJBweHx7/2wBDAQUFBQcGBw4ICA4eFBEUHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh7/wAARCACsAJYDASIAAhEBAxEB/8QAHAAAAAcBAQAAAAAAAAAAAAAAAAECAwQFBwYI/8QAQRAAAgEDAgMFBQUGBQIHAAAAAQIDAAQRBSEGEjEHQVFhgRMUInGRMkKhscEIFSNSYnIWJDOS4ReCJUN0g6LR8P/EABkBAAMBAQEAAAAAAAAAAAAAAAABAgMEBf/EAB8RAQEBAQACAwEBAQAAAAAAAAABAhEDIRIxQRMiUf/aAAwDAQACEQMRAD8A1WgKFAVztR0YFFR5oA6MUVGKAMVXcT69p3DmlNqGoyFUB5UUbs7Y6CrEda89duevPqnF81hHKfd7D+Cq9AWx8R+u3pTk6VvEjiLtf1+7uT+71hsoF2ACczZ8STVHH2n8Yx3Cv+/Z5APh5Sq4+mK5GOyvJ25o4HKncMdhijfS75d/ZA/Jqv45L/VbRwZ2yzNPHbcR2yGJsJ7xFsV8Sw762eCSOeGOeFw8UihkYHIIPQ14sYTwcomjePfbmG31rcP2eeL5py3Ct9LzqsZlsix3XH2o/l3jw3pazOdiWzUAaJqLNQZeaLNJJpBagFk0WaRzUWaAcoU3zUKAjHpRUoiixQsVHRUKAVmhmizQoAp50treW5kYKkKNIxPgBn9K806bYLqV3c61qK85uJ2kRCNiSckn67Ct37SrhrfgPVmQ8rvCIgf73VfyJrHr0m0t0VUX+Go27hR3k9Lxn5X2h3KgEgAACoDg81TLS6a5PLL7JlJ25VximLsCAOv3h0zUTXt0/wA/XQiRXjKTIksZ2KsM5qTwfEnDvH2j6lDIy2bXSAnqUVvhI8xvVMk1x7UkTvj+UAYq4AN3o8w29pEOYf8A39a0zXPvD062xI8KRneoGgah+8+H9O1EAj3m1jlIPiVGfxzUvmpMC2NNlqJmptmoBfNQ5vOms+dAHzoM7k0KbBNCgiiKTSzSTQsmhRmioAUBQoUBzfafGZeCroKOk9ux+QmTP51k2qc7XDgMojcnnfYmNe7APUk4Hl59K1DtVv7my4dijhSForqf2U5dckKMMMeByOtZzeQZ5wm5LdKnVdHhz6cdpMN2LhGbJkB+M7crb9wwMVO1eOaR2kyNxtR3V5DYtdSPFLIIUHKkWMsxOMb9NqZ1rWoo4YpY9PuFkdQPYBlLc3fvnAx86j3a6JJM8tV6iXnhVvahVl5pDG5VmX+Udw+eDXRaWsjRlH5cyo6EqMA5Bxnz6ZxVJFPHNODECY3QNuc4bvFdBpBwy5O2auWsNSNp7MM/9OdBJGAbTI22+01dAayzsGvZ5pdStld3s1tYHUFiVR+d1wPDIH4VqLmqcms/G8JY02TQY0gmgh5o803mjBoBwGhSQaFASjSSKWaKhXSDSaUwpNAlChQpJNBuN7ardpuzy9mjJD2skc648jg59GrO9PvlvNPS5TBMqZO/Ru/8a27UrODUtPuNPuUDw3MbROpHUEYrzHaah/hniC90e+yUguGQsOg5SRnHmKfx7F+Pfxq7jhilaeAXCwKjZnuDuS56Ko8cd/dVTqWk2fN7JHuDGrcwcMdm8ckfnSeG9QsZZJriJYZr8Ss2JObGD0xg+HfUe54k1L94TWr2dtECxYHncj0qLm99OnOsXP8AqnFYJKlszqTjMTr94d4I7jVrJeC00qaZjgqhwfPoK4vVr62ju45ORBcc4ZvZjHNjxpy81ObWb6GytI39nJIFVe9iSB+ZrWZc+9z6eg+wPTZ7Dgprm4ieNryRXTmXBKBdj8sk137HvqNpNqun6TZ2CfZt4EiG2Ogx07qec1N+2FvSCaQzUGO9IJpArNGDTYNKBoB0GhSQaFBp7UmltSKCEaQRSjSSaFEt0pBpbdKakZURndlVVBZmY4AHeSe4UGUDXnX9o/SXteMF1KIfw723RmKjHK4+E/UAfStF4q7X+FdId7aweTWLsZAFuQIc+ch+Y+yDXF8Qa1/jWxF3ewxqr80YiQ5CBWIwD1zuDn+oU5fj7POfneMIM08Nw0sJdGTqwOD4eNLl1C6eIs7MzdOYk+ldLrvCF3ES9k6TJno55WG/y3rm7jSdTjcq8QGPMVtLms7nU9cNQsZW5jJv+J8K0/sI0pL7j7TZbhA8EDtJgrsXCEj6Hf0rhNL0eRv9UhB3hep/Su/4b1FuG4G1C1lEElqhcMO44wB/3HbHfmlvX5Dzi87Xp5m2ptmrkuAOPNJ4xtX90DW19Coa4tJNyvdzKfvJnv6jbIrpmfNZWc+yKY70lmxTbP50gvQD3MKUDUcNSlakEhTtQpKmhQFs1NmnGptqFQg0VHjJAHU1k3af2sQ6W82kcNMk94uUlvdikR7wnczf1dB3Zpyd+g7LjbjbQ+FVEV9K016y8y2kJHPjxYnZB5nc9wNedu07tP1riZGtBMLTTmba3gOFbH8x6t67eQrkeItWuZ5pJLid5p5WLSyMxJJPUknqaqblixtIx1OSa2ziT7RdJYc+8ksThYgvqTk/p9Ku9H4iudIkblQXFtKQ0sDMV3GwdWH2WxtncEbEEVz963JISDtzfkKZSYlOVumdvKrslKWy9jQ24s0W5XIvhbNjeO7iZCP+5Ayn8PlVff3+jzDn/e2nA/8AqOb8AM1wV1yFgOcg/Ko3L/Uaz/jPytf76/Xaya/oloMrcT3rjolvGUX/AHv+gqovdau9VlVWCwQI3NFbx/ZU/wAxJ3ZvM+mKoQo79zUq2bl+VVMSe2et2r/SNRu7C7S6sLqa2uYN0liblYHyNbR2f9rnvDLY8VMiN0W9RcD/ANxR0/uHqKwe3YB81IMhSRWVjVXM0iXj2PHOksSSxSJJG68yOhBVge8EdRQ5/E15s4F451Xh2ZVhk9vZE5ktZD8B81/kPmPUGt54c17T+INOW+0+UlekkbbPE3gw/Xoaw1mxcvV2H86Wr1E5qUr1BpyyihUVWoUB0zU2acfrVdxDqttoeg3+s3mPYWUDTMP5iBsvqcD1oWzrtt46bSLeThvS35b2eIe8zK28KN90f1EdT3A+Jrz5OcjPenxY8u+rLiK/ur+/k1G9kL3NwTNMfFieY+m+B5Cuf1K49nHcOpyFiOPUYH510ZzJGdvVA8zTxueYszyAj1qSd9VwDtFyoPQUzokIcOzDKpgeuc/pSrMlpZJDuxkJzVRJ+9k5y6gj4TUVmKhdzvQDlpZGz1ampWztndN6oBfHEmRSNiNqXdEPa82N1xTUJGFohD6GnojsN6al2bFLjOMGgJ1u+CBTrvvmo8YxvSpGywHlQFhaSYA8z0rqeD+Ib3QNTS7s5PJ0J+GRe9T/APtutcZay/x8dyip9tL8QHeN6VnRHqnQtWtNY02LULJ+aKTqD9pG71PmP+asAaxLsf4gbTteTS53Hu2o4Tc/ZmAPIfXdfUVtanYVzanKuHloUlTihUm6x6xz9qTXfc+GNN4fifEmo3PtpgD/AOVH09C5H+2tlIJOAMk9K8lftBa2Na7S7z2UnPb2OLSEg7YT7R9XL1eJ2nqud1iYIvO32QeU+QO1c1rIdLaQ5whVIxv3hifyAq71ZRcW8sJJHtE2+fd+lU2n/wCftEafIaCXldT44FboPWMHu9hHGdpGXnf5n/jFV1oQqvnxzVvCxlkLtjG4/wCKqnTkaQdxJAxThIyvufnTcjYnbzFEx5Tim5Tl80yPr8VtKhPdUeAkkCn4STBIf6Tmo0J+ICg0m62ZT5UFJwMGhe7CPzFJjPw4pklQzfdJp1jk5HdUIHNSIH33NHAct5OW4f8Asb8qsbCQhDId87LVbyFLlD91tsj8qkWUhaNB8sCkHQJNJEsc0TlZY2V0bvDDcH616b0HUE1bRbLU0wBdQLKQO4kfEPQ5ry4zbAeFbl2G6iLrhOWwLZayuCAM/cccw/HmrHyT1040IUKCmhWK3QcVarHoXDOpa1Ice52zyLnvfGEHqxFeJNSkea7EsjF2kc85PexOSfXevSn7Teue68O6fw/E4El/N7xMAdxHH9kern/415mvSVM2Dup5xW+JyJqVdP8AwF8V2BqLahVW6dRgyOrMPA4IpyV/aWLOD3cwqv02f2ntQWySoP0P/NaBNtNuZP6siod4qrLy5xk9KmWg/jE+WKpw/vWsFQTy8xHoKZItwvI5U9RTDGpOpkNqDqmMLgbVGI5mxSoSrYf5STzU1DiPxA1PK8lkxHhiq+PY06SZf/6cJHgRTUZOAakXI59MR9iVb8OlRYT8JFP9H4eBpZG21NKadjPcdqCSLecOpSQDIGR6UrSWLFM9F3qNIOTMg6AHP0p/S/hh+dKnFykvxb7mtK7DNRW04qezZvhvrdoxv99fjX8m+tZbG/xir/h6/k03VbO/iOHtpllGPI7j6ZqNTsOPUamhRRskiiSIgxuAyHxBGR+BoVzrYT22cQrxD2gahcQyFrW2ItbY4xlI9s+rcx9aza8OWcj5VuHHHYhxLZSSXHD0sWu2hOViJEV0g8OUnlf5qQfKsa17SNQ0q6a21SyvNNuOns7uFozny5hv6V0T6SgaVKGt2iP3Dj0qogLWmryQg5GWUeYIyKkK0trdH4eYNsQPzqFeyiS8hdDhw4GfHen0lvayShGuH+GONS2/ecbVC4ejzM87dEUkn86m8ROILJbeMY9o2PQUiGMWuiSONmdfzpkpy3NNJIfvEml2qZ+I0UMRKBiNm6VKVeVcdBTgFcEi1I7jVem+flU+5P8Al28RUFO+i/Zpts3tLF4TnODioMTcrYPfUixfklwehpu9j5J2x0zkUX66Ra0tGBANR4nyvKetHkqCO+joOz3Jb+DHjB2LHv8AlU23ccoUHptVYy8kiE965/GpcB+HPfRBxZwNl+tXFqw5lFUdoTmri2yMEUqUej+y7Uv3lwVZOzc0ttm2k33+D7J/2laFcV2H6zb2l1qFjezLDbzRrMCT0dTynHzDD6UKw1JK0lemmXaq7iX3duHr73+CG6t0t3YxTxiRDttswI64q1Yb1Q8eEjhS8x97kU/LnFFvIrM7ZHmDjPhDhpR7VbR7KTvNtIVBP9pyKyzWtHg0+dZ4L1p0R1JV0AOM+INa/wBpDsLR2BwQSaxO+lkaOdWdiMd5rLGtf9d3l8fjk+k7WcTaysfVU2pzV0P7vjjHRm3x4YpqUf8Aiknp+lSdW6wr3AGu55ivMfJGp8B0pDfZJz31Il+yajybDFANTEmJvlUMbVIckg0w9KgEOHBp66+IIx7xg/Oo9Py7xL86OgyUwcipNpu2GAO3U0ypPNin4j8JPpSgtM35/jr3fD+ppy05nYIgZz4KMn8Kk26q2pRcyq2EPUZrtOG3b2gAwB4AYrLfk+NbeLw/OfaPwlwVxNr7MmnabhYwC7zyLEAD/dv9BWkaJ2NX2EOr65bwgdUtIjI3y5mwPwNW/ZO7LrMsY+y9u3N6EEVpoqZ5bZ1O/HMa4pOFuFND4cjYadalpnXlknnPtJGHhuMAeQAoVeUKVpcf/9k=\",\n        \"requested_by\": \"API User\"\n    }\n}"},{"id":"c97ac66d-9c92-403d-9ec5-9536eac69e23","name":"Passport Verification - Request Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"A20111-\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ke/passport"},"status":"Unprocessable Entity","code":422,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 12:26:07 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"265"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"109-2kK+MRFT/PlTzX2+X5PCFp+vXHc\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95af16b4183fcdbd-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"validation_error\",\n    \"message\": \"It seems there`s an issue with your input. Please correct it and try again.\",\n    \"data\": {\n        \"id\": {\n            \"message\": \"id length must be at least 8 characters long\",\n            \"customErrorMessage\": \"id should have at least 8 characters!\"\n        }\n    }\n}"},{"id":"98854c3c-0fe0-47a4-bcb7-d17d7b9a8e55","name":"Passport Verification - Not Found","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"A2011156\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ke/passport"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 12:26:27 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"3e-E2zVGle7+FQBXdidOVwNc06NaEc\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95af173388bdcdbd-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Passport data not found\",\n    \"data\": {}\n}"}],"_postman_id":"887cc409-96af-4d69-a108-309a921d6ed5"},{"name":"National ID Verification","id":"5835c3fb-554d-4924-99c0-54e52a5ccc87","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"25219766\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ke/national-id","description":"<p>This endpoint allows you to verify the validity of a Kenyan national identity</p>\n<p><strong>Payload</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>id</td>\n<td>string</td>\n<td><code>Required</code> National ID number</td>\n</tr>\n<tr>\n<td>verification_consent</td>\n<td>boolean</td>\n<td><code>Required</code> Indicates whether the user has provided explicit consent for their ID to be verified</td>\n</tr>\n<tr>\n<td>validation</td>\n<td>object</td>\n<td><code>Optional</code> Additional validation fields for enhanced verification</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>Validation</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>first_name</td>\n<td>string</td>\n<td><code>Optional</code> First name of the individual for cross-verification</td>\n</tr>\n<tr>\n<td>last_name</td>\n<td>string</td>\n<td><code>Optional</code> Last name of the individual for cross-verification</td>\n</tr>\n<tr>\n<td>date_of_birth</td>\n<td>string (YYYY-MM-DD)</td>\n<td><code>Optional</code> Date of birth of the individual</td>\n</tr>\n<tr>\n<td>selfie</td>\n<td>string (URL or Base64)</td>\n<td><code>Optional</code> URL to a selfie image used for facial recognition</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","identities","ke","national-id"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"35c010c0-0e04-43a7-8e7f-3115d530bb5e","name":"National ID Verification - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"25219766\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ke/national-id"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 12:27:45 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"1a10-5KhpxeOQ4op94i7oXGnOHZ7Somk\""},{"key":"vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"content-security-policy","value":"frame-ancestors 'none'"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95af19195ab33545-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"National identity verified successfully\",\n    \"data\": {\n        \"reference\": \"VR-IpR2VW4h7qcPu0Uil\",\n        \"id\": \"25219766\",\n        \"id_type\": \"ke_national_id\",\n        \"first_name\": \"Josephine\",\n        \"last_name\": \"Okunmu\",\n        \"middle_name\": \"Mary\",\n        \"full_name\": \"Josephine Mary Okunmu\",\n        \"date_of_birth\": \"2002-06-03\",\n        \"nationality\": \"KENYAN\",\n        \"gender\": \"female\",\n        \"type\": \"id\",\n        \"image\": \"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\",\n        \"requested_by\": \"API User\"\n    }\n}"},{"id":"9e8ecaa6-6b13-469d-ac56-87bb40eae3d6","name":"National ID Verification - Request Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"252197-\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ke/national-id"},"status":"Unprocessable Entity","code":422,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 12:28:18 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"265"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"109-2kK+MRFT/PlTzX2+X5PCFp+vXHc\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95af19e818a03545-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"validation_error\",\n    \"message\": \"It seems there`s an issue with your input. Please correct it and try again.\",\n    \"data\": {\n        \"id\": {\n            \"message\": \"id length must be at least 8 characters long\",\n            \"customErrorMessage\": \"id should have at least 8 characters!\"\n        }\n    }\n}"},{"id":"844e1ad8-6e49-441f-9efe-ed5efe5b5512","name":"National ID Verification - Not Found","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"25219711\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ke/national-id"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 12:29:01 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"41-afqxVu0SQqs+2/Is4RwkVq6V7ak\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95af1af4ddf03545-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"National ID data not found\",\n    \"data\": {}\n}"}],"_postman_id":"5835c3fb-554d-4924-99c0-54e52a5ccc87"},{"name":"Tax Pin Verification","id":"eddee6a5-c38c-47b0-aa10-2c3d67a2886c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"A009274635J\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ke/tax-pin","description":"<p>This endpoint allows you to verify the validity of a Kenyan tax pin</p>\n<p><strong>Payload</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Data Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>id</td>\n<td>string</td>\n<td><code>Required</code> Tax pin number</td>\n</tr>\n<tr>\n<td>verification_consent</td>\n<td>boolean</td>\n<td><code>Required</code> Indicates whether the user has provided explicit consent for their ID to be verified</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["merchant","api","v1","identities","ke","tax-pin"],"host":["https://api.korapay.com"],"query":[],"variable":[]}},"response":[{"id":"0194c515-5c0f-46c7-b4b3-a8741d63b383","name":"Tax Pin Verification - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"A009274635J\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ke/tax-pin"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 12:31:10 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"1a5-yohjOYZ1PH4/a5iRmrsZzHfmvxc\""},{"key":"vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-store"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"content-security-policy","value":"frame-ancestors 'none'"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95af1e17da53eefb-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"Tax pin verified successfully\",\n    \"data\": {\n        \"reference\": \"VR-HqsDcsohjjsz8Z9Z0\",\n        \"id\": \"A009274635J\",\n        \"id_type\": \"ke_tax_pin\",\n        \"pin\": \"A009274635J\",\n        \"pin_current_status\": \"Registered\",\n        \"pin_status\": \"Active\",\n        \"effective_from_date\": \"2022-12-31\",\n        \"effective_to_date\": null,\n        \"itax_status\": \"iPage Updated\",\n        \"obligation_name\": \"Income Tax - Resident Individual\",\n        \"taxpayer_name\": \"Masoud Onyango\",\n        \"requested_by\": \"API User\"\n    }\n}"},{"id":"d3ca5d83-2f28-4f40-87c2-89bc30c2b925","name":"Tax Pin Verification - Request Validation Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"A00927463-\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ke/tax-pin"},"status":"Unprocessable Entity","code":422,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 12:29:34 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"269"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"10d-4wfJPqXTOWH5cHhCkRaI6lTfq1A\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95af1bbf89dd3545-LHR"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"error\": \"validation_error\",\n    \"message\": \"It seems there`s an issue with your input. Please correct it and try again.\",\n    \"data\": {\n        \"id\": {\n            \"message\": \"id length must be 11 characters long\",\n            \"customErrorMessage\": \"id should only be 11 characters, no less, no more\"\n        }\n    }\n}"},{"id":"bd388edf-dc15-4e7f-9ff6-3b929c5aa717","name":"Tax Pin Verification - Not Found","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"id\": \"A0092746311\",\n    \"verification_consent\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.korapay.com/merchant/api/v1/identities/ke/tax-pin"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 06 Jul 2025 12:30:05 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"3d-OnYjULZ8I8Yle3ZDx79TkLSHe4U\""},{"key":"vary","value":"Accept-Encoding"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"95af1c825d633545-LHR"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": false,\n    \"message\": \"Tax pin data not found\",\n    \"data\": {}\n}"}],"_postman_id":"eddee6a5-c38c-47b0-aa10-2c3d67a2886c"}],"id":"ff892c03-e6f7-49a5-98f5-598645586100","description":"<p>This folder contains endpoints for verifying Kenyan identities</p>\n","_postman_id":"ff892c03-e6f7-49a5-98f5-598645586100"}],"id":"c9688c6c-b5ba-4a6a-8b9a-e3797d94fe49","description":"<p>This section of the documentation contains API requests and responses for Identity</p>\n","_postman_id":"c9688c6c-b5ba-4a6a-8b9a-e3797d94fe49"},{"name":"Utility","item":[{"name":"Upload Payout Document","id":"7b363689-d976-417b-bb45-88266056f1a7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","uuid":"7868058f-186e-48fa-b01c-dfb36fc9c854","value":null},{"key":"purpose","value":"payout_supporting_document","type":"text","uuid":"1b520c1e-c78e-4039-a299-88beb9d51ed3"},{"key":"reference","value":"test-ref-01","type":"text","uuid":"1c883901-e08b-4d71-8fbc-407cd8ee7753"}]},"url":"https://utilities.korapay.com/api/v1/files","description":"<p>To Upload supporting documents used for USD Payouts. The token used here is Bearer + your secret key retrieved on the merchant portal.</p>\n","urlObject":{"protocol":"https","path":["api","v1","files"],"host":["utilities","korapay","com"],"query":[],"variable":[]}},"response":[{"id":"503d006c-088b-4c43-a475-1ec7f9381b45","name":"Successful Upload Payout Document","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","uuid":"7868058f-186e-48fa-b01c-dfb36fc9c854"},{"key":"purpose","value":"payout_supporting_document","type":"text","uuid":"1b520c1e-c78e-4039-a299-88beb9d51ed3"},{"key":"reference","value":"test-ref-01","type":"text","uuid":"1c883901-e08b-4d71-8fbc-407cd8ee7753"}]},"url":"https://utilities.korapay.com/api/v1/files"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"File upload successful\",\n    \"data\": {\n        \"reference\": \"test-ref-03\",\n        \"purpose\": \"payout_supporting_document\"\n    }\n}"},{"id":"81e9909e-6cb2-4fde-812e-0d3526bfe4bd","name":"Too Large Upload Payout Document","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","uuid":"7868058f-186e-48fa-b01c-dfb36fc9c854"},{"key":"purpose","value":"payout_supporting_document","type":"text","uuid":"1b520c1e-c78e-4039-a299-88beb9d51ed3"},{"key":"reference","value":"test-ref-01","type":"text","uuid":"1c883901-e08b-4d71-8fbc-407cd8ee7753"}]},"url":"https://utilities.korapay.com/api/v1/files"},"status":"Payload Too Large","code":413,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":null},{"id":"74c186d5-b97d-4b59-9c99-5e53dca36c52","name":"Invalid Upload Payout Document","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","uuid":"7868058f-186e-48fa-b01c-dfb36fc9c854"},{"key":"purpose","value":"payout_supporting_document","type":"text","uuid":"1b520c1e-c78e-4039-a299-88beb9d51ed3"},{"key":"reference","value":"test-ref-01","type":"text","uuid":"1c883901-e08b-4d71-8fbc-407cd8ee7753"}]},"url":"https://utilities.korapay.com/api/v1/files"},"status":"Unprocessable Content","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"error\": \"validation_error\",\n    \"message\": \"It seems there`s an issue with your input. Please correct it and try again.\",\n    \"data\": null\n}"}],"_postman_id":"7b363689-d976-417b-bb45-88266056f1a7"},{"name":"Upload Card Issuing KYC Data","id":"60182361-17da-4d0a-bc9a-37464d1287b6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","uuid":"7868058f-186e-48fa-b01c-dfb36fc9c854","description":"<p>Image file</p>\n","value":null},{"key":"purpose","value":"cardholder_selfie","type":"text","uuid":"1b520c1e-c78e-4039-a299-88beb9d51ed3","description":"<p>Can be any of cardholder_selfie, cardholder_id_front or cardholder_id_back</p>\n"},{"key":"reference","value":"test-ref-01","type":"text","uuid":"1c883901-e08b-4d71-8fbc-407cd8ee7753","description":"<p>Unique reference</p>\n"}]},"url":"https://utilities.korapay.com/api/v1/files","description":"<p>To Upload KYC data required for cardholder creation. The token used here is Bearer + your secret key retrieved on the merchant portal</p>\n","urlObject":{"protocol":"https","path":["api","v1","files"],"host":["utilities","korapay","com"],"query":[],"variable":[]}},"response":[{"id":"4944461c-8c66-415e-8567-0b5020390b56","name":"Upload Card Issuing KYC Data - Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","uuid":"7868058f-186e-48fa-b01c-dfb36fc9c854"},{"key":"purpose","value":"payout_supporting_document","type":"text","uuid":"1b520c1e-c78e-4039-a299-88beb9d51ed3"},{"key":"reference","value":"test-ref-01","type":"text","uuid":"1c883901-e08b-4d71-8fbc-407cd8ee7753"}]},"url":"https://utilities.korapay.com/api/v1/files"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"message\": \"File upload successful\",\n    \"data\": {\n        \"reference\": \"test-ref-01\",\n        \"purpose\": \"cardholder_selfie\"\n    }\n}"},{"id":"0e078a2d-e04a-4305-87ae-b35291bd74a3","name":"Upload Card Issuing KYC Data - Data Too Large","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","uuid":"7868058f-186e-48fa-b01c-dfb36fc9c854"},{"key":"purpose","value":"cardholder_selfie","type":"text","uuid":"1b520c1e-c78e-4039-a299-88beb9d51ed3"},{"key":"reference","value":"test-ref-01","type":"text","uuid":"1c883901-e08b-4d71-8fbc-407cd8ee7753"}]},"url":"https://utilities.korapay.com/api/v1/files"},"status":"Payload Too Large","code":413,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":null},{"id":"502360c5-d749-4b83-8fb8-a1d93211ec5e","name":"Upload Card Issuing KYC Data - Invalid Upload Data","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","uuid":"7868058f-186e-48fa-b01c-dfb36fc9c854"},{"key":"purpose","value":"cardholder_selfie","type":"text","uuid":"1b520c1e-c78e-4039-a299-88beb9d51ed3"},{"key":"reference","value":"test-ref-01","type":"text","uuid":"1c883901-e08b-4d71-8fbc-407cd8ee7753"}]},"url":"https://utilities.korapay.com/api/v1/files"},"status":"Unprocessable Content","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n    \"error\": \"validation_error\",\n    \"message\": \"It seems there`s an issue with your input. Please correct it and try again.\",\n    \"data\": null\n}"}],"_postman_id":"60182361-17da-4d0a-bc9a-37464d1287b6"}],"id":"9ada1e84-0f74-4c9c-b220-7016f156ff38","description":"<p>This is for additional APIs used within Kora infrastructure</p>\n","_postman_id":"9ada1e84-0f74-4c9c-b220-7016f156ff38"}],"event":[{"listen":"prerequest","script":{"id":"7306111e-09f4-4023-80bb-69e4f9536d89","type":"text/javascript","requests":{},"exec":[""]}},{"listen":"test","script":{"id":"e5fbf58b-f6a1-432b-9ffd-e8d51e6afdc6","type":"text/javascript","requests":{},"exec":[""]}}],"variable":[{"key":"baseurl","value":"https://api.korapay.com"},{"key":"secret_key","value":"sk_******"},{"key":"public_key","value":"pk_live_f2AjfQGDFwoNmPaz8En7W6wU2n21QpW1jBt6NYLF"}]}