{"info":{"_postman_id":"7e1f7326-12aa-4efa-9983-031ba436cd67","name":"Finecore Partners BAAS Documentation","description":"

Finecore BAAS API Documentation

Welcome to the official API documentation for Finecore Partners' Backend-as-a-Service (BAAS) platform. This collection includes endpoints for managing wallets and accounts, including both static and dynamic account generation.

Available Services

Wallet Management
\n
- Create and retrieve wallet details
  \n
- Check balances
  \n
- View transaction history
  \n
\n
Account Management
\n
- Generate static accounts for users or organizations
  \n
- Create dynamic virtual accounts for one-time or scoped use
  \n
- Link accounts to wallets
  \n
\n

For questions or technical support, contact our team at tech@finecore.co.

Getting Started

Set up your environment variables (e.g. https://api.finecore.co/v1, {{API_KEY}})
\n
Use your API key in the X-API-Key header:
\n
X-API-Key: {{API_KEY}}
\n
Explore the endpoints organized by service in this collection
\n
Review the example requests and responses for correct formatting
\n

Notes

This is the v1 version of the Finecore BAAS API.
\n
All responses are returned in JSON format.
\n
Ensure your API key is kept secure and not exposed in public environments.
\n
Error responses will contain helpful messages and status codes.
\n

Web Hook Events

This document outlines the webhook event types and their associated data structures.

Webhook Event Types

customer_bank_transfer: Represents a customer bank transfer event.
\n
bank_transfer: Represents a merchant bank transfer event.
\n
customer_wallet_debited: Represents an event where a customer's wallet is debited.
\n
customer_wallet_credited: Represents an event where a customer's wallet is credited.
\n
wallet_to_wallet_transfer: Represents a wallet-to-wallet transfer event.
\n
batch_bank_transfer: Represents a batch bank transfer event.
\n
account_funded: Represents an event where an account is funded.
\n

🔔 Webhook Response

When an event occurs, a webhook will be sent with the following JSON structure:

{\n\"event\": \"customer_bank_transfer\",\n\"data\":{\n  \"id\": \"5a8d6c3e-bbf4-4f4b-80b9-8f2877363eae\",\n  \"user_id\": \"2c8e91cd-7ae4-4b34-bc9f-39e72b2dd9c4\",\n  \"merchant_id\": \"77b2d420-531c-44e7-a0fd-3d7e87b264dc\",\n  \"reference\": \"TXN-239487293847\",\n  \"amount\": 1500.75,\n  \"currency\": \"NGN\",\n  \"status\": \"COMPLETED\",\n  \"balance_before\": 3500.00,\n  \"balance_after\": 2000.25,\n  \"environment\": \"SANDBOX\",\n  \"type\": \"DEBIT\",\n  \"category\": \"BANK_TRANSFER\",\n  \"source\": \"wallet\",\n  \"destination\": \"merchant_account\",\n  \"description\": \"Payment for Order #12345\",\n  \"metadata\": {\n    \"order_id\": \"12345\",\n    \"channel\": \"web\"\n  },\n  \"created_at\": \"2025-05-01T13:25:43Z\"\n}\n}\n\n

📝 Field Descriptions

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
`id`	UUID	Unique identifier for the webhook event
`user_id`	UUID	The user associated with the transaction
`merchant_id`	UUID	The merchant involved in the transaction
`reference`	String	Unique transaction reference
`amount`	Float	Transaction amount
`currency`	String	ISO currency code (e.g., NGN, USD)
`status`	String	Status of the transaction (COMPLETED, FAILED, etc.)
`balance_before`	Float	Balance before the transaction
`balance_after`	Float	Balance after the transaction
`environment`	String	Environment (LIVE, SANDBOX)
`type`	String	Type of transaction (CREDIT, DEBIT)
`category`	String	Category of transaction (e.g., BANK_TRANSFER, CREDIT_CUSTOMER_WALLET, etc)
`source`	String	Origin of funds (e.g., WALLET, CARD)
`destination`	String	Destination of funds
`description`	String	Description of the transaction
`metadata`	Object	Custom metadata (key-value pairs)
`created_at`	Timestamp	ISO 8601 timestamp when the webhook event was triggered

Webhook Documentation

This webhook system allows Finecore to send event notifications to your server in real-time. The webhook delivers a JSON payload via an HTTP POST request to your specified webhook URL.

How It Works:

The server sends a POST request to your webhookUrl with a JSON payload.
\n
The payload is signed using an HMAC-SHA256 signature generated with your secretKey.
\n
The request includes headers to help you verify authenticity and ensure security.
\n

Headers:

Content-Type: application/json
\n
X-Webhook-Signature: {HMAC_SHA256_SIGNATURE}
\n
X-Webhook-Timestamp: {ISO_8601_UTC_TIMESTAMP}
\n

Example:

X-Webhook-Signature: b1946ac92492d2347c6235b4d2611184
X-Webhook-Timestamp: 2025-05-08T12:34:56.789Z

Payload:

The payload is a JSON object that contains the data relevant to the event. The structure will vary based on the event type.

Example payload:

{\n\"event\": \"customer_bank_transfer\",\n\"data\":{\n  \"id\": \"5a8d6c3e-bbf4-4f4b-80b9-8f2877363eae\",\n  \"user_id\": \"2c8e91cd-7ae4-4b34-bc9f-39e72b2dd9c4\",\n  \"merchant_id\": \"77b2d420-531c-44e7-a0fd-3d7e87b264dc\",\n  \"reference\": \"TXN-239487293847\",\n  \"amount\": 1500.75,\n  \"currency\": \"NGN\",\n  \"status\": \"COMPLETED\",\n  \"balance_before\": 3500.00,\n  \"balance_after\": 2000.25,\n  \"environment\": \"SANDBOX\",\n  \"type\": \"DEBIT\",\n  \"category\": \"BANK_TRANSFER\",\n  \"source\": \"wallet\",\n  \"destination\": \"merchant_account\",\n  \"description\": \"Payment for Order #12345\",\n  \"metadata\": {\n    \"order_id\": \"12345\",\n    \"channel\": \"web\"\n  },\n  \"created_at\": \"2025-05-01T13:25:43Z\"\n}\n}\n\n

Verifying the Webhook:

Compute an HMAC-SHA256 hash of the raw request body using your secretKey.
\n
Compare your computed hash with the value in the X-Webhook-Signature header.
\n
Check that the X-Webhook-Timestamp is recent (recommended within 5 minutes) to prevent replay attacks.
\n

Example verification steps:

Extract X-Webhook-Signature and X-Webhook-Timestamp from the headers.
\n
Compute:
\n
signature = HMAC_SHA256(secretKey, rawBody)
\n
Compare:
\n
If signature === X-Webhook-Signature → ✅ valid.
\n

Webhook Retry Policy

To ensure reliable delivery, Finecore’s webhook system implements an automatic retry mechanism when delivering webhook events to your endpoint.

Behavior:

Number of retries: 3 attempts in total (1 initial + 2 retries).
\n
Retry interval: Exponential backoff starting at 100 milliseconds:
\n
- 1st attempt: immediately.
  \n
- 2nd attempt: after 5 seconds.
  \n
- 3rd attempt: after 10 seconds.
  \n
\n
Timeout: Each webhook request will timeout after 30 seconds if your server does not respond.
\n
Retry triggers: Retries occur if:
\n
- Your server is unreachable (network error).
  \n
- Your server responds with a non-2xx HTTP status code.
  \n
- Your server takes too long to respond (exceeds 30 seconds).
  \n
\n

Stopping Condition:

If your server responds with a 2xx HTTP status code, the webhook is considered delivered and no further retries are attempted.

Best Practices for Your Endpoint:

Always respond with a 2xx HTTP status code to acknowledge successful receipt.
\n
Validate the X-Webhook-Signature header to ensure the request’s authenticity.
\n
Process webhook payloads idempotently to avoid duplicate side effects in case of retries.
\n

Example Retry Flow:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Attempt	Wait before retry	Notes
1st	Immediate	Initial delivery attempt
2nd	5s	First retry if needed
3rd	10s	Second retry if needed

Important Notes:

Always acknowledge receipt with a 200 OK HTTP status code.
\n
Make sure your endpoint is secure and can handle requests at scale.
\n
Your server should verify the signature and timestamp before processing the webhook payload.
\n

For technical support or questions, contact tech@finecore.co.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Finecore BAAS API Documentation","slug":"finecore-baas-api-documentation"}],"owner":"38720320","collectionId":"7e1f7326-12aa-4efa-9983-031ba436cd67","publishedId":"2sB2j4eW8P","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-07-25T22:18:46.000Z"},"item":[{"name":"Wallet","item":[{"name":"Transaction","item":[{"name":"Fetch customer transaction","id":"0777b6a9-66af-4478-9d9d-6d5429335ed9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"url":"{{BASE_URL}}/transactions/customer/:customer_id/:reference","description":"

Fetch Transaction by Customer ID and Reference

Endpoint: GET /v1/transactions/customer/:customer_id/:reference

Description:
This endpoint retrieves a specific transaction for a given customer based on their unique customer_id and a unique transaction reference.

Parameters:

customer_id (path parameter): The unique identifier for the customer whose transaction is being fetched.
\n
reference (path parameter): The unique reference code of the transaction you want to retrieve.
\n

Response:

On success, returns the transaction details including:
\n
- Amount
  \n
- Status (e.g., FAILED, COMPLETE, PENDING)
  \n
- Date of transaction
  \n
- Transaction type (CREDIT or DEBIT)
  \n
- Metadata (optional)
  \n
\n
Error Handling:
\n
- If the transaction is not found, a 404 Not Found response is returned.
  \n
- If an error occurs, a relevant error message with status code is returned.
  \n
\n

Example Request:

Notes:

Ensure that the customer_id and reference are correctly passed as path parameters.
\n
Include the X-API-Key header for authentication:
\n
X-API-Key: {{API_KEY}}
\n

\n","urlObject":{"path":["transactions","customer",":customer_id",":reference"],"host":["{{BASE_URL}}"],"query":[],"variable":[{"type":"any","value":"7d2efa20-bb75-4425-8342-2a68eba6191a","key":"customer_id"},{"type":"any","value":"TXN-1746014787-16c444e2f2af52ea","key":"reference"}]}},"response":[{"id":"b6883068-6762-451b-95e6-58ea981c8b1c","name":"New Request","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://api.finecore.co/v1/transactions/customer/:customer_id/:reference","protocol":"http","host":["api","finecore","co"],"path":["v1","transactions","customer",":customer_id",":reference"],"variable":[{"key":"customer_id","value":"2da3424b-1d1e-4155-a65e-d2347c37a73c"},{"key":"reference","value":"TXN-1736445726-87dc1349d8f78a0a"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Vary","value":"Origin"},{"key":"Date","value":"Thu, 09 Jan 2025 18:57:54 GMT"},{"key":"Content-Length","value":"350"}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 200,\n \"status\": \"success\",\n \"data\": {\n \"id\": \"509eae9c-9373-486d-b25d-0c46994b66f9\",\n \"user_id\": \"2da3424b-1d1e-4155-a65e-d2347c37a73c\",\n \"reference\": \"TXN-1736445726-87dc1349d8f78a0a\",\n \"currency\": \"NGN\",\n \"environment\": \"SANDBOX\",\n \"status\": null,\n \"balance_after\": 600,\n \"balance_before\": 400,\n \"metadata\": null,\n \"type\": \"CREDIT\",\n \"category\": \"CREDIT_CUSTOMER_WALLET\"\n }\n}"}],"_postman_id":"0777b6a9-66af-4478-9d9d-6d5429335ed9"},{"name":"Fetch customer transactions","id":"4cbdd5ed-bd11-4733-94e1-19a411f407be","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"url":"{{BASE_URL}}/transactions/customer/:customer_id","description":"

Fetch All Transactions by Customer ID

Endpoint: GET /v1/transactions/customer/:customer_id

Description:
This endpoint retrieves all transactions associated with a specific customer identified by their unique customer_id. Use this to view the complete transaction history for a customer.

Parameters:

customer_id (path parameter): The unique identifier for the customer whose transactions are being fetched.

Response:

On success, returns a list of transactions with details including:
\n
- Amount
  \n
- Status (e.g., successful, failed)
  \n
- Date of transaction
  \n
- Transaction type (credit or debit)
  \n
- Metadata (optional)
  \n
\n
Error Handling:
\n
- If no transactions are found for the given customer, returns an empty list.
  \n
- If the customer ID is invalid, a 404 Not Found response is returned.
  \n
- Any other errors will return a relevant error message with a corresponding status code.
  \n
\n

Notes:

Ensure that the customer_id is passed correctly as a path parameter.
\n
Include the X-API-Key header for authentication:
\n
X-API-Key: {{API_KEY}}
\n

\n","urlObject":{"path":["transactions","customer",":customer_id"],"host":["{{BASE_URL}}"],"query":[],"variable":[{"type":"any","value":"6e042473-0f89-4697-a1f8-3772f123590c","key":"customer_id"}]}},"response":[{"id":"ca71e5a8-2802-46c9-b324-8733e58a6372","name":"Fetch customer transactions","originalRequest":{"method":"GET","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"url":{"raw":"http://api.finecore.co/v1/transactions/customer/:customer_id","protocol":"http","host":["api","finecore","co"],"path":["v1","transactions","customer",":customer_id"],"variable":[{"key":"customer_id","value":"2da3424b-1d1e-4155-a65e-d2347c37a73c"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Vary","value":"Origin"},{"key":"Date","value":"Wed, 12 Feb 2025 14:00:09 GMT"},{"key":"Content-Length","value":"1149"}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 200,\n \"status\": \"success\",\n \"data\": [\n {\n \"id\": \"a0d95df4-b004-4c38-95b8-b9308d0340c1\",\n \"user_id\": \"2da3424b-1d1e-4155-a65e-d2347c37a73c\",\n \"reference\": \"TXN-1736446870-9572309761397768\",\n \"currency\": \"NGN\",\n \"environment\": \"SANDBOX\",\n \"status\": null,\n \"amount\": 200,\n \"balance_after\": 1000,\n \"balance_before\": 800,\n \"metadata\": \"eyJyZWFzb24iOiAiZm9yIGNvbXBsZXRpb24gb2YgdGFzayJ9\",\n \"type\": \"CREDIT\",\n \"category\": \"CREDIT_CUSTOMER_WALLET\",\n \"total_items\": 3\n },\n {\n \"id\": \"f94d933c-75c3-42c5-8f6c-ceb7e64f8d80\",\n \"user_id\": \"2da3424b-1d1e-4155-a65e-d2347c37a73c\",\n \"reference\": \"TXN-1736445802-9e8bc1decbdc2178\",\n \"currency\": \"NGN\",\n \"environment\": \"SANDBOX\",\n \"status\": null,\n \"amount\": 0,\n \"balance_after\": 800,\n \"balance_before\": 600,\n \"metadata\": null,\n \"type\": \"CREDIT\",\n \"category\": \"CREDIT_CUSTOMER_WALLET\",\n \"total_items\": 3\n },\n {\n \"id\": \"509eae9c-9373-486d-b25d-0c46994b66f9\",\n \"user_id\": \"2da3424b-1d1e-4155-a65e-d2347c37a73c\",\n \"reference\": \"TXN-1736445726-87dc1349d8f78a0a\",\n \"currency\": \"NGN\",\n \"environment\": \"SANDBOX\",\n \"status\": null,\n \"amount\": 0,\n \"balance_after\": 600,\n \"balance_before\": 400,\n \"metadata\": null,\n \"type\": \"CREDIT\",\n \"category\": \"CREDIT_CUSTOMER_WALLET\",\n \"total_items\": 3\n }\n ],\n \"meta\": {\n \"page\": 1,\n \"limit\": 10,\n \"totalItems\": 3,\n \"totalPages\": 1\n }\n}"}],"_postman_id":"4cbdd5ed-bd11-4733-94e1-19a411f407be"}],"id":"52473f67-4bb6-4402-881d-1f84a97e4609","description":"

Transaction Endpoints (Wallet)

This folder contains endpoints for fetching transaction details related to wallets in the Finecore BAAS platform.

Available Actions:

Fetch Transaction by Customer ID and Reference
\n
- Retrieve a specific transaction using the customer ID and transaction reference.
  \n
- Use this endpoint to get detailed information about a single transaction.
  \n
\n
Fetch All Transactions by Customer ID
\n
- Retrieve all transactions associated with a specific customer ID.
  \n
- This can be used to view the complete transaction history for a customer.
  \n
\n
Fetch Transaction by Reference
\n
- Retrieve a transaction based on the transaction reference.
  \n
- Use this endpoint to find a specific transaction using its unique reference code.
  \n
\n

Notes:

The customer_id and reference parameters are essential for fetching specific transactions.
\n
Transactions are returned with details such as amount, status, date, and type (credit/debit).
\n
Make sure to include the required X-API-Key in the header:
\n
X-API-Key: {{API_KEY}}
\n

\n","_postman_id":"52473f67-4bb6-4402-881d-1f84a97e4609"},{"name":"Create customer wallet","id":"1296c154-0786-4669-b2d4-96700e3299f1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"bvn\": \"31034529415\",\r\n \"first_name\": \"Leo\",\r\n \"last_name\": \"Doe\",\r\n \"date_of_birth\": \"20-09-2000\",\r\n \"phone_number\": \"03013452943\",\r\n \"email\": \"igbayomarvelous02@gmail.com\",\r\n \"address\": \"No 12, Rahama Road, Kaduna\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/wallets","description":"

Create Wallet

Endpoint: POST /v1/wallets

Description:
This endpoint allows the creation of a new wallet for a customer. You need to provide the customer's personal information, such as BVN, name, date of birth, phone number, email, and address. A wallet will be created and linked to the provided customer details.

Request Body:
The request body must contain the following fields:

bvn (string): The customer's Bank Verification Number (BVN) for identity verification.
\n
first_name (string): The first name of the customer, default is John/Doe for sandbox environment.
\n
last_name (string): The last name of the customer.
\n
date_of_birth (string): The customer's date of birth in DD-MM-YYYY(15-01-1990) format.
\n
phone_number (string): The customer's phone number.
\n
email (string): The customer's email address.
\n
address (string): The customer's residential address.
\n
On success, returns the details of the created wallet, including:
\n
- Wallet ID
  \n
- Customer details (name, email, etc.)
  \n
- Wallet balance (initially 0)
  \n
\n
Error Handling:
\n
- If required fields are missing or invalid, a 400 Bad Request response is returned.
  \n
- If there are issues with the provided BVN, a 422 Unprocessable Entity response is returned.
  \n
- Other errors will return a relevant error message with the corresponding status code.
  \n
\n

Notes:

Ensure that all required fields are included in the request body.
\n
Include the X-API-Key header for authentication:
\n
X-API-Key: {{API_KEY}}
\n

\n","urlObject":{"path":["wallets"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"62cd3e94-6e62-4b5b-87d2-501ce2a91f13","name":"Create customer wallet","originalRequest":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"bvn\": \"21616301079\",\r\n \"first_name\": \"Salu\",\r\n \"last_name\": \"Belben\",\r\n \"date_of_birth\": \"12-11-1997\",\r\n \"phone_number\": \"09063054331\",\r\n \"email\": \"salu@gmail.com\",\r\n \"address\": \"No 10, Adewale Ajasin University\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/wallets"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 04 Apr 2025 08:58:31 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Content-Length","value":"555"},{"key":"Connection","value":"keep-alive"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=MCBXGzK5pYn8RvLPa1i7lNfemrw0t6ZBkU5j%2BvmqRfyZpk7LbdLYrld5niictW5oOruFE2JrVPOKzh27RMDI8SP9AU47QZyPTKJwnMbci%2F8bzcQzpd%2FTnvpoOAPGyVeO73I%3D\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"92af9aa96e599535-LHR"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"},{"key":"server-timing","value":"cfL4;desc=\"?proto=TCP&rtt=135698&min_rtt=135698&rtt_var=67849&sent=3&recv=5&lost=0&retrans=0&sent_bytes=0&recv_bytes=591&delivery_rate=0&cwnd=249&unsent_bytes=0&cid=0000000000000000&ts=0&x=0\""}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Customer wallet created successfully\",\n \"data\": {\n \"id\": \"964aaac3-2db7-4f88-809e-23d8c3667dd2\",\n \"merchant_id\": \"c0f0faec-5f1a-450f-84c7-20c7a18d1249\",\n \"environment\": \"SANDBOX\",\n \"currency\": \"NGN\",\n \"bank_name\": \"Xpresswallet\",\n \"bank_code\": \"100040\",\n \"account_name\": \"Salu Belben\",\n \"account_number\": \"4401630673\",\n \"updated_at\": \"2025-04-04T08:58:29.638524Z\",\n \"created_at\": \"2025-04-04T08:58:29.638524Z\",\n \"booked_balance\": 0,\n \"available_balance\": 0,\n \"status\": \"ACTIVE\",\n \"updated\": false,\n \"wallet_type\": \"Customer\",\n \"user_id\": \"ed382df0-b6f6-4210-bc8b-5dd7d6721caa\"\n }\n}"}],"_postman_id":"1296c154-0786-4669-b2d4-96700e3299f1"},{"name":"Fetch Customer Wallets","id":"97e5ba3c-fe29-4d24-915d-0f39e6328096","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"url":"{{BASE_URL}}/wallets?page_number=1&page_size=5","description":"

Fetch Wallets (Paginated)

Endpoint: GET /v1/wallets

Description:
This endpoint allows you to fetch a list of customer wallets with pagination. You can specify the page number and limit to control how many wallets are returned per request. This is useful when you need to retrieve a large set of wallets in chunks.

Query Parameters:

page (integer): The page number to retrieve. Defaults to 1 if not provided.
\n
limit (integer): The number of wallets to return per page. Defaults to 10 if not provided. The maximum allowed value is 100.
\n

Response:

On success, returns a paginated list of wallets with the following details:
\n
- Customer information (e.g., name, email, etc.)
  \n
- Wallet balance
  \n
- Pagination details (e.g., current page, total pages, etc.)
  \n
\n
Error Handling:
\n
- If the page or limit parameters are invalid (e.g., negative numbers or non-integer values), a 400 Bad Request response is returned.
  \n
- Any other errors will return a relevant error message with the corresponding status code.
  \n
\n

Notes:

Ensure that the page and limit query parameters are provided for pagination.
\n
Include the X-API-Key header for authentication:
\n
X-API-Key: {{API_KEY}}
\n

\n","urlObject":{"path":["wallets"],"host":["{{BASE_URL}}"],"query":[{"key":"page_number","value":"1"},{"key":"page_size","value":"5"}],"variable":[]}},"response":[{"id":"de5d45a5-4996-4683-aad0-9e2553e3b782","name":"Fetch Customer Wallets","originalRequest":{"method":"GET","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"url":"{{BASE_URL}}/wallets"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Date","value":"Fri, 04 Apr 2025 11:36:02 GMT"},{"key":"Content-Length","value":"553"},{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Successfully fetched wallets\",\n \"data\": [\n {\n \"id\": \"964aaac3-2db7-4f88-809e-23d8c3667dd2\",\n \"merchant_id\": \"c0f0faec-5f1a-450f-84c7-20c7a18d1249\",\n \"environment\": \"SANDBOX\",\n \"currency\": \"NGN\",\n \"bank_name\": \"Xpresswallet\",\n \"bank_code\": \"100040\",\n \"account_name\": \"Salu Belben\",\n \"account_number\": \"4401630673\",\n \"updated_at\": \"2025-04-04T08:58:29.638524Z\",\n \"created_at\": \"2025-04-04T08:58:29.638524Z\",\n \"booked_balance\": 100,\n \"available_balance\": 100,\n \"status\": \"ACTIVE\",\n \"updated\": false,\n \"wallet_type\": \"Customer\",\n \"user_id\": \"ed382df0-b6f6-4210-bc8b-5dd7d6721caa\"\n }\n ]\n}"}],"_postman_id":"97e5ba3c-fe29-4d24-915d-0f39e6328096"},{"name":"Fetch wallet","id":"8ad4adb2-4d24-4f1a-a582-b5bf56cf3fe5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"url":"{{BASE_URL}}/wallets/:customer_id","description":"

Fetch Customer Wallet

Endpoint: GET /v1/wallets/:customer_id

Description:
This endpoint allows you to fetch the details of a customer's wallet using their unique customer_id. The response will contain the wallet information such as the current balance and other associated customer details.

Parameters:

customer_id (path parameter): The unique identifier of the customer whose wallet is being fetched.

Response:

On success, returns the wallet details, including:
\n
- Customer information (e.g., name, email, etc.)
  \n
- Wallet balance
  \n
- Additional metadata (if available)
  \n
\n
Error Handling:
\n
- If the customer wallet does not exist, a 404 Not Found response is returned.
  \n
- If the customer_id is invalid, a 400 Bad Request response is returned.
  \n
- Any other errors will return a relevant error message with the corresponding status code.
  \n
\n

Notes:

Ensure that the customer_id is passed correctly as a path parameter.
\n
Include the X-API-Key header for authentication:
\n
X-API-Key: {{API_KEY}}
\n

\n","urlObject":{"path":["wallets",":customer_id"],"host":["{{BASE_URL}}"],"query":[],"variable":[{"type":"any","value":"7d2efa20-bb75-4425-8342-2a68eba6191a","key":"customer_id"}]}},"response":[{"id":"c5e4b648-37a5-4676-87f2-2a06e031adc6","name":"Fetch wallet","originalRequest":{"method":"GET","header":[{"key":"X-API-Key","value":"ftk_3a2bd23ad130b5167035e92566d515eb_564794739","type":"text"}],"url":{"raw":"{{BASE_URL}}wallets/:customer_id","host":["{{BASE_URL}}wallets"],"path":[":customer_id"],"variable":[{"key":"customer_id","value":"{{X-API-Key}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Date","value":"Fri, 04 Apr 2025 11:38:28 GMT"},{"key":"Content-Length","value":"550"},{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Successfully fetched wallet\",\n \"data\": {\n \"id\": \"964aaac3-2db7-4f88-809e-23d8c3667dd2\",\n \"merchant_id\": \"c0f0faec-5f1a-450f-84c7-20c7a18d1249\",\n \"environment\": \"SANDBOX\",\n \"currency\": \"NGN\",\n \"bank_name\": \"Xpresswallet\",\n \"bank_code\": \"100040\",\n \"account_name\": \"Salu Belben\",\n \"account_number\": \"4401630673\",\n \"updated_at\": \"2025-04-04T08:58:29.638524Z\",\n \"created_at\": \"2025-04-04T08:58:29.638524Z\",\n \"booked_balance\": 100,\n \"available_balance\": 100,\n \"status\": \"ACTIVE\",\n \"updated\": false,\n \"wallet_type\": \"Customer\",\n \"user_id\": \"ed382df0-b6f6-4210-bc8b-5dd7d6721caa\"\n }\n}"}],"_postman_id":"8ad4adb2-4d24-4f1a-a582-b5bf56cf3fe5"},{"name":"Credit customer","id":"61c279b0-7348-4d46-9daf-efb228a6a67f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"amount\": 15,\r\n \"customer_id\": \"5939b1f5-0590-480a-bd4a-d77c19cd0ded\",\r\n \"reference\": \"38bDlOwxUmrDv3yzP46mZyiEaZWpYVcxMHLd\",\r\n \"metadata\": {\r\n \"reason\": \"for completion of task\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/wallets/credit","description":"

Credit Customer Wallet

Endpoint: POST /v1/wallets/credit

Description:
This endpoint allows you to credit a customer's wallet with a specified amount. You need to provide the customer_id, amount, and optional reference. If a reference is provided by the client, it will be used; otherwise, a reference will be automatically generated.

Request Body:
The request body must contain the following fields:

amount (float): The amount to credit to the customer's wallet.
\n
customer_id (string): The unique identifier of the customer whose wallet is being credited.
\n
reference (string, optional): The unique reference for the transaction. If not provided, a reference will be automatically generated for you.
\n
metadata (object, optional): Additional information regarding the transaction. In this case, a reason field can be included, such as the purpose for the credit.
\n
If no reference is provided, the system will generate one.
\n

Response:

On success, returns a confirmation of the credited amount along with the transaction details:
\n
- Amount credited
  \n
- Customer wallet balance (updated)
  \n
- Transaction reference
  \n
- Metadata (if included)
  \n
\n
Error Handling:
\n
- If any required fields are missing or invalid, a 400 Bad Request response is returned.
  \n
- If the customer_id does not exist, a 404 Not Found response is returned.
  \n
- If the amount is negative or invalid, a 400 Bad Request response is returned.
  \n
- Any other errors will return a relevant error message with the corresponding status code.
  \n
\n

\n","urlObject":{"path":["wallets","credit"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"e483ee30-abfc-46d2-9cae-8522facdd0b6","name":"Credit customer","originalRequest":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"amount\": 50,\r\n \"customer_id\": \"ed382df0-b6f6-4210-bc8b-5dd7d6721caa\",\r\n \"reference\": \"38bDlOwxUmrDv3yzP46mZyiEaZWpYVcxMHLd\",\r\n \"metadata\": {\r\n \"reason\": \"for completion of task\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"http://api.finecore.co/v1/wallets/credit"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin","uuid":"363b784c-3f5f-4262-92ee-f28193ce3773"},{"key":"Date","value":"Fri, 04 Apr 2025 11:28:25 GMT","uuid":"d7f924ee-a3a2-4b06-b908-322614d6911c"},{"key":"Content-Length","value":"483","uuid":"3512f701-273e-4d21-a8df-43ea58a30073"},{"key":"Content-Type","value":"application/json","description":"","type":"text","uuid":"09f94923-80f3-464a-b23b-21ae03603031"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Successfully credit customer wallet\",\n \"data\": {\n \"id\": \"f92abf64-ca8a-44f5-b633-bdbf1f202546\",\n \"reference\": \"TXN-1743766099-328df4d3f44bcafc\",\n \"currency\": \"NGN\",\n \"environment\": \"SANDBOX\",\n \"balance_after\": 100,\n \"balance_before\": 50,\n \"merchant_id\": \"c0f0faec-5f1a-450f-84c7-20c7a18d1249\",\n \"metadata\": \"eyJyZWFzb24iOiAiZm9yIGNvbXBsZXRpb24gb2YgdGFzayJ9\",\n \"amount\": 50,\n \"status\": \"COMPLETED\",\n \"destination\": null,\n \"description\": null,\n \"type\": \"CREDIT\",\n \"category\": \"CREDIT_CUSTOMER_WALLET\"\n }\n}"}],"_postman_id":"61c279b0-7348-4d46-9daf-efb228a6a67f"},{"name":"Fetch transaction by reference","id":"e3c66b1c-ac82-4b6b-a6f4-4b7430e25b48","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"url":"{{BASE_URL}}/transactions/TXN-1746091774-9a097fcb63592df3","description":"

Fetch Transaction by Reference

Endpoint: GET /v1/transactions/:reference

Description:
This endpoint retrieves a specific transaction using its unique transaction reference. The reference is typically a code generated for each transaction to track it in the system.

Parameters:

reference (path parameter): The unique reference code of the transaction you want to retrieve. This reference is assigned to each transaction at the time of creation.

Response:

On success, returns the transaction details including:
\n
- Amount
  \n
- Status (e.g., successful, failed)
  \n
- Date of transaction
  \n
- Transaction type (credit or debit)
  \n
- Metadata (optional)
  \n
\n
Error Handling:
\n
- If the transaction is not found, a 404 Not Found response is returned.
  \n
- If an invalid reference is provided, a 400 Bad Request response is returned.
  \n
- Any other errors will return a relevant error message with status code.
  \n
\n

Notes:

Ensure that the reference is passed correctly as a path parameter.
\n
Include the X-API-Key header for authentication:
\n
X-API-Key: {{API_KEY}}
\n

\n","urlObject":{"path":["transactions","TXN-1746091774-9a097fcb63592df3"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"0e72e936-e51a-4b41-9d70-c8ae8edad036","name":"Fetch transaction by reference","originalRequest":{"method":"GET","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"url":"{{BASE_URL}}/transactions/TXN-1745837500-8d8c8442b1ed68e7"},"status":"OK","code":200,"_postman_previewlanguage":"plain","header":[{"key":"Vary","value":"Origin","uuid":"6f594550-6bf8-4e37-af11-eae4e48de43f"},{"key":"Date","value":"Wed, 30 Apr 2025 08:58:15 GMT","uuid":"b56c7651-0e3c-4e20-bac2-bd6c87696333"},{"key":"Content-Length","value":"602","uuid":"d59b9528-e67c-49b4-b1b5-360863ab038f"},{"key":"Content-Type","value":"text/plain; charset=utf-8","uuid":"60f5ca57-66fe-4dee-b820-49d85219dfbf"}],"cookie":[],"responseTime":null,"body":"{\"success\":true,\"message\":\"Successfully fetched transactions\",\"data\":{\"id\":\"4b74a5b6-6419-4621-9bfd-0b20da820748\",\"user_id\":\"38d48e8a-6bb4-4565-b67a-a5dbb51fb755\",\"merchant_id\":\"cf07ad9f-35c1-4036-9f01-9e03f6c2f22b\",\"reference\":\"TXN-1745837500-8d8c8442b1ed68e7\",\"currency\":\"NGN\",\"environment\":\"SANDBOX\",\"from_wallet_id\":\"33218f41-4067-4bb4-b3d4-1bc32f202583\",\"to_wallet_id\":\"d7d68f02-82cb-455d-805f-7613246ab67b\",\"amount\":100,\"status\":\"COMPLETED\",\"balance_after\":100,\"balance_before\":0,\"metadata\":\"eyJyZWFzb24iOiAiZm9yIGNvbXBsZXRpb24gb2YgdGFzayJ9\",\"type\":\"CREDIT\",\"category\":\"CREDIT_CUSTOMER_WALLET\"}}\n"}],"_postman_id":"e3c66b1c-ac82-4b6b-a6f4-4b7430e25b48"},{"name":"Wallet to wallet transfer","id":"c50370e5-1ef7-4376-8c03-2593488fc17e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"amount\": 1000,\r\n \"from_wallet_id\": \"23f59762-8dea-4eca-908e-4e57df125527\",\r\n \"to_wallet_id\": \"517aef2c-1a35-4166-b77f-33fc7d2d97a7\",\r\n \"narration\": \"Customer transfer\",\r\n \"reference\": \"0briwiiipkpiVcxMLd\",\r\n \"metadata\": {\r\n \"reason\": \"for completion of task\"\r\n }\r\n}\r\n\r\n//23f59762-8dea-4eca-908e-4e57df125527","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/wallets/transfer/bank","urlObject":{"path":["wallets","transfer","bank"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"0cf05b06-6814-4ba6-9f70-464286f029eb","name":"Wallet to wallet transfer","originalRequest":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"amount\": 1000,\r\n \"from_wallet_id\": \"23f59762-8dea-4eca-908e-4e57df125527\",\r\n \"to_wallet_id\": \"517aef2c-1a35-4166-b77f-33fc7d2d97a7\",\r\n \"narration\": \"Customer transfer\",\r\n \"reference\": \"0briwiiipkpiVcxMLd\",\r\n \"metadata\": {\r\n \"reason\": \"for completion of task\"\r\n }\r\n}\r\n\r\n//23f59762-8dea-4eca-908e-4e57df125527","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/wallets/transfer/bank"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"You have successfully make a transfer\",\n \"data\": {\n \"reference\": \"TXN-1743150834-d528cb706bcd4a68\",\n \"status\": \"PENDING\"\n }\n}"}],"_postman_id":"c50370e5-1ef7-4376-8c03-2593488fc17e"},{"name":"Upgrade To Tier Two Wallet","id":"9a70cbe8-f8b7-473f-a78d-d96bb3febf5c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"nin\": \"31034529415\",\r\n \"account_number\": \"4000033892\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/wallets/upgrade-tier-2","description":"

Create Wallet

Endpoint: POST /v1/wallets

Request Body:
The request body must contain the following fields:

bvn (string): The customer's Bank Verification Number (BVN) for identity verification.
\n
first_name (string): The first name of the customer, default is John/Doe for sandbox environment.
\n
last_name (string): The last name of the customer.
\n
date_of_birth (string): The customer's date of birth in DD-MM-YYYY(15-01-1990) format.
\n
phone_number (string): The customer's phone number.
\n
email (string): The customer's email address.
\n
address (string): The customer's residential address.
\n
On success, returns the details of the created wallet, including:
\n
- Wallet ID
  \n
- Customer details (name, email, etc.)
  \n
- Wallet balance (initially 0)
  \n
\n
Error Handling:
\n
- If required fields are missing or invalid, a 400 Bad Request response is returned.
  \n
- If there are issues with the provided BVN, a 422 Unprocessable Entity response is returned.
  \n
- Other errors will return a relevant error message with the corresponding status code.
  \n
\n

Notes:

Ensure that all required fields are included in the request body.
\n
Include the X-API-Key header for authentication:
\n
X-API-Key: {{API_KEY}}
\n

\n","urlObject":{"path":["wallets","upgrade-tier-2"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"87282918-72e7-48e9-b2d5-9f30f52d88e1","name":"Create customer wallet","originalRequest":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"bvn\": \"21616301079\",\r\n \"first_name\": \"Salu\",\r\n \"last_name\": \"Belben\",\r\n \"date_of_birth\": \"12-11-1997\",\r\n \"phone_number\": \"09063054331\",\r\n \"email\": \"salu@gmail.com\",\r\n \"address\": \"No 10, Adewale Ajasin University\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/wallets"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 04 Apr 2025 08:58:31 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Content-Length","value":"555"},{"key":"Connection","value":"keep-alive"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=MCBXGzK5pYn8RvLPa1i7lNfemrw0t6ZBkU5j%2BvmqRfyZpk7LbdLYrld5niictW5oOruFE2JrVPOKzh27RMDI8SP9AU47QZyPTKJwnMbci%2F8bzcQzpd%2FTnvpoOAPGyVeO73I%3D\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"92af9aa96e599535-LHR"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"},{"key":"server-timing","value":"cfL4;desc=\"?proto=TCP&rtt=135698&min_rtt=135698&rtt_var=67849&sent=3&recv=5&lost=0&retrans=0&sent_bytes=0&recv_bytes=591&delivery_rate=0&cwnd=249&unsent_bytes=0&cid=0000000000000000&ts=0&x=0\""}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Customer wallet created successfully\",\n \"data\": {\n \"id\": \"964aaac3-2db7-4f88-809e-23d8c3667dd2\",\n \"merchant_id\": \"c0f0faec-5f1a-450f-84c7-20c7a18d1249\",\n \"environment\": \"SANDBOX\",\n \"currency\": \"NGN\",\n \"bank_name\": \"Xpresswallet\",\n \"bank_code\": \"100040\",\n \"account_name\": \"Salu Belben\",\n \"account_number\": \"4401630673\",\n \"updated_at\": \"2025-04-04T08:58:29.638524Z\",\n \"created_at\": \"2025-04-04T08:58:29.638524Z\",\n \"booked_balance\": 0,\n \"available_balance\": 0,\n \"status\": \"ACTIVE\",\n \"updated\": false,\n \"wallet_type\": \"Customer\",\n \"user_id\": \"ed382df0-b6f6-4210-bc8b-5dd7d6721caa\"\n }\n}"}],"_postman_id":"9a70cbe8-f8b7-473f-a78d-d96bb3febf5c"},{"name":"Create Tier Two Wallet","id":"0aed3640-0d72-4fdf-87ce-64587e0f0cd5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"bvn\": \"31034529411\",\r\n \"nin\": \"53230490802\",\r\n \"first_name\": \"Leo\",\r\n \"last_name\": \"Doe\",\r\n \"date_of_birth\": \"15-01-1990\",\r\n \"phone_number\": \"09013452943\",\r\n \"email\": \"igbayomarvelous02@gmail.com\",\r\n \"address\": \"No 12, Rahama Road, Kaduna\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/wallets/tier-2","description":"

Create Wallet

Endpoint: POST /v1/wallets

Request Body:
The request body must contain the following fields:

bvn (string): The customer's Bank Verification Number (BVN) for identity verification.
\n
first_name (string): The first name of the customer, default is John/Doe for sandbox environment.
\n
last_name (string): The last name of the customer.
\n
date_of_birth (string): The customer's date of birth in DD-MM-YYYY(15-01-1990) format.
\n
phone_number (string): The customer's phone number.
\n
email (string): The customer's email address.
\n
address (string): The customer's residential address.
\n
On success, returns the details of the created wallet, including:
\n
- Wallet ID
  \n
- Customer details (name, email, etc.)
  \n
- Wallet balance (initially 0)
  \n
\n
Error Handling:
\n
- If required fields are missing or invalid, a 400 Bad Request response is returned.
  \n
- If there are issues with the provided BVN, a 422 Unprocessable Entity response is returned.
  \n
- Other errors will return a relevant error message with the corresponding status code.
  \n
\n

Notes:

Ensure that all required fields are included in the request body.
\n
Include the X-API-Key header for authentication:
\n
X-API-Key: {{API_KEY}}
\n

\n","urlObject":{"path":["wallets","tier-2"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"c62c4ebe-5f35-4b49-bdbf-6faab633d379","name":"Create customer wallet","originalRequest":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"bvn\": \"21616301079\",\r\n \"first_name\": \"Salu\",\r\n \"last_name\": \"Belben\",\r\n \"date_of_birth\": \"12-11-1997\",\r\n \"phone_number\": \"09063054331\",\r\n \"email\": \"salu@gmail.com\",\r\n \"address\": \"No 10, Adewale Ajasin University\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/wallets"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 04 Apr 2025 08:58:31 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Content-Length","value":"555"},{"key":"Connection","value":"keep-alive"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=MCBXGzK5pYn8RvLPa1i7lNfemrw0t6ZBkU5j%2BvmqRfyZpk7LbdLYrld5niictW5oOruFE2JrVPOKzh27RMDI8SP9AU47QZyPTKJwnMbci%2F8bzcQzpd%2FTnvpoOAPGyVeO73I%3D\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"92af9aa96e599535-LHR"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"},{"key":"server-timing","value":"cfL4;desc=\"?proto=TCP&rtt=135698&min_rtt=135698&rtt_var=67849&sent=3&recv=5&lost=0&retrans=0&sent_bytes=0&recv_bytes=591&delivery_rate=0&cwnd=249&unsent_bytes=0&cid=0000000000000000&ts=0&x=0\""}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Customer wallet created successfully\",\n \"data\": {\n \"id\": \"964aaac3-2db7-4f88-809e-23d8c3667dd2\",\n \"merchant_id\": \"c0f0faec-5f1a-450f-84c7-20c7a18d1249\",\n \"environment\": \"SANDBOX\",\n \"currency\": \"NGN\",\n \"bank_name\": \"Xpresswallet\",\n \"bank_code\": \"100040\",\n \"account_name\": \"Salu Belben\",\n \"account_number\": \"4401630673\",\n \"updated_at\": \"2025-04-04T08:58:29.638524Z\",\n \"created_at\": \"2025-04-04T08:58:29.638524Z\",\n \"booked_balance\": 0,\n \"available_balance\": 0,\n \"status\": \"ACTIVE\",\n \"updated\": false,\n \"wallet_type\": \"Customer\",\n \"user_id\": \"ed382df0-b6f6-4210-bc8b-5dd7d6721caa\"\n }\n}"}],"_postman_id":"0aed3640-0d72-4fdf-87ce-64587e0f0cd5"},{"name":"Create Tier Three Wallet","id":"1635401a-4c04-4cac-b8e2-f3a938c7ea43","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"utility_bill_image","type":"file","uuid":"eca63794-a1c6-4a29-9d05-a09ddaa2da78","src":"/C:/Users/USER/Downloads/ChatGPT Image Oct 3, 2025, 03_57_11 PM.png"},{"key":"address","value":"49 MODUPE STREET FOLA AGORO, LAGOS","type":"text","uuid":"315dac84-3c18-4f35-ba0f-78cca3c915d6"},{"key":"bvn","value":"00000000000","type":"text"},{"key":"postal_ccode","value":"20832","type":"text"},{"key":"country","value":"Nigeria","type":"text"},{"key":"state","value":"LAGOS","type":"text"},{"key":"nin","value":"00000000000","type":"text"},{"key":"lga","value":"Ikeja","type":"text"},{"key":"first_name","value":"John","type":"text"},{"key":"last_name","value":"Doe","type":"text"},{"key":"city","value":"Lagos","type":"text"},{"key":"phone","value":"1234567895","type":"text"},{"key":"email","value":"gla6@gmail.com","type":"text","uuid":"9fb8c6cc-da35-465a-9c77-4518687716cb"},{"key":"dob","value":"1990-01-15","type":"text","uuid":"aa227579-6636-4b3a-aaa6-fe99854ab21e"}]},"url":"{{BASE_URL}}/wallets/tier-3","urlObject":{"path":["wallets","tier-3"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"3b83b11b-9c13-42ac-b6db-9751d5a5ce0d","name":"Create Tier Three Wallet","originalRequest":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"utility_bill_image","type":"file","uuid":"eca63794-a1c6-4a29-9d05-a09ddaa2da78","src":"/C:/Users/USER/Downloads/Screenshot 2025-08-15 at 11.11.06 AM.png"},{"key":"address","value":"49 MODUPE STREET FOLA AGORO, LAGOS","type":"text","uuid":"315dac84-3c18-4f35-ba0f-78cca3c915d6"},{"key":"bvn","value":"00000000000","type":"text"},{"key":"postal_code","value":"20832","type":"text"},{"key":"country","value":"Nigeria","type":"text"},{"key":"state","value":"LAGOS","type":"text"},{"key":"nin","value":"00000000000","type":"text"},{"key":"lga","value":"Ikeja","type":"text"},{"key":"first_name","value":"John","type":"text"},{"key":"last_name","value":"Doe","type":"text"},{"key":"city","value":"Lagos","type":"text"},{"key":"phone","value":"1234567895","type":"text"},{"key":"email","value":"vee@gmail.com","type":"text","uuid":"9fb8c6cc-da35-465a-9c77-4518687716cb"},{"key":"dob","value":"1990-01-15","type":"text","uuid":"aa227579-6636-4b3a-aaa6-fe99854ab21e"}],"options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/wallets/tier-3"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self' 'unsafe-inline' https://cdn.example.com;style-src 'self' 'unsafe-inline' https://fonts.googleapis.com;img-src 'self' data: https://*.example.com;font-src 'self' https://fonts.gstatic.com;connect-src 'self' https://api.example.com;frame-ancestors 'none';"},{"key":"Permissions-Policy","value":"geolocation=(), microphone=(), camera=()"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Fri, 05 Sep 2025 11:13:13 GMT"},{"key":"Content-Length","value":"602"},{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Wallet created successfully\",\n \"data\": {\n \"id\": \"b07ac185-5b9d-44a6-bdca-88c40941e86a\",\n \"merchant_id\": \"d0c70a28-1023-484e-849f-3fb41cee743b\",\n \"environment\": \"SANDBOX\",\n \"currency\": \"NGN\",\n \"bank_name\": \"FCMB MFB\",\n \"bank_code\": \"090409\",\n \"account_name\": \"John Doe\",\n \"account_number\": null,\n \"updated_at\": \"2025-09-05T11:13:14.884459Z\",\n \"created_at\": \"2025-09-05T11:13:14.884459Z\",\n \"booked_balance\": 0,\n \"available_balance\": 0,\n \"status\": \"IN_ACTIVE\",\n \"updated\": false,\n \"user_id\": \"03e08fe0-c341-45fb-bfda-60777df710c1\",\n \"account_type\": \"WALLET\",\n \"expiry_time\": null,\n \"account_category\": \"CUSTOMER\",\n \"tier\": \"TIER_THREE\"\n }\n}"}],"_postman_id":"1635401a-4c04-4cac-b8e2-f3a938c7ea43"},{"name":"Freeze Wallet","id":"157eeeb1-e2e4-4e74-9c34-3cdcca956cc6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{BEARER_TOKEN}}"}]},"isInherited":false},"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"account_number\": \"4000033892\",\r\n \"reason\": \"i dont want to bank with you\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/wallets/freeze","urlObject":{"path":["wallets","freeze"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"157eeeb1-e2e4-4e74-9c34-3cdcca956cc6"},{"name":"UnFreeze Wallet","id":"345d48ae-b9c8-4cac-a7f9-83929c0e4e04","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{BEARER_TOKEN}}"}]},"isInherited":false},"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"account_number\": \"4000033892\",\r\n \"reason\": \"i dont want to bank with you\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/wallets/freeze","urlObject":{"path":["wallets","freeze"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"345d48ae-b9c8-4cac-a7f9-83929c0e4e04"},{"name":"Get Tier Three Wallet Status","id":"55e6b34b-070f-49b7-861e-82cea3b69530","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"https://baas.dev.getrova.co.uk/wallet/tier-3-status?reference=b07ac185-5b9d-44a6-bdca-88c40941e86a","urlObject":{"protocol":"https","path":["wallet","tier-3-status"],"host":["baas","dev","getrova","co","uk"],"query":[{"key":"reference","value":"b07ac185-5b9d-44a6-bdca-88c40941e86a"}],"variable":[]}},"response":[],"_postman_id":"55e6b34b-070f-49b7-861e-82cea3b69530"},{"name":"Fetch Merchant Collection Account","id":"2f71e3ef-a6d7-4a69-acd1-58cd9f154801","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"urlObject":{"query":[],"variable":[]},"url":""},"response":[{"id":"8e085ca9-db8c-4f43-93f0-b4a295761fd9","name":"Fetch Merchant Wallet Details","originalRequest":{"method":"GET","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"url":"{{BASE_URL}}/wallets/merchants"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Permissions-Policy","value":"geolocation=(), microphone=(), camera=()"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Fri, 09 Jan 2026 13:17:13 GMT"},{"key":"Content-Length","value":"568"},{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"wallet detail retrieved successfully\",\n \"data\": {\n \"id\": \"2bc8d899-c2a2-44d6-7960-55117e4a9462\",\n \"merchant_id\": \"d0c70a82-1023-484e-849f-3fb41cee743b\",\n \"environment\": \"SANDBOX\",\n \"currency\": \"NGN\",\n \"bank_name\": \"Bank name\",\n \"bank_code\": \"Bank code\",\n \"account_name\": \"Account name\",\n \"account_number\": \"9900981701\",\n \"updated_at\": \"2025-05-01T19:11:11.020038Z\",\n \"created_at\": \"2025-05-01T19:11:11.020038Z\",\n \"booked_balance\": 0,\n \"available_balance\": 55349,\n \"status\": \"ACTIVE\",\n \"updated\": false,\n \"user_id\": null,\n \"account_type\": \"WALLET\",\n \"expiry_time\": null,\n \"account_category\": \"MERCHANT\"\n }\n}"}],"_postman_id":"2f71e3ef-a6d7-4a69-acd1-58cd9f154801"}],"id":"8cf6783c-6f4e-472f-af38-9fce067de1cd","description":"

Wallet Endpoints

This folder contains all endpoints related to wallet operations in the Finecore BAAS platform.

Available Actions:

Create a new wallet for a user or organization
\n
Retrieve wallet details by ID or user reference
\n
Check current wallet balance
\n
View wallet transaction history
\n

Notes:

Wallets are linked to users or organizations by unique identifiers
\n
All balances are returned in the default system currency
\n
Transactions include metadata such as type (credit/debit), source, and timestamp
\n

Ensure your requests include the required headers, especially:

X-API-Key: {{API_KEY}}

\n","_postman_id":"8cf6783c-6f4e-472f-af38-9fce067de1cd"},{"name":"Bank Transfer","item":[{"name":"Merchant Transfer to bank account","id":"158e4df1-bd11-4787-b15d-5c3739c4dc14","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"amount\": 6000,\r\n \"reference\": \"t68bay1ootinzPZiaZpVxMHd\",\r\n \"sort_code\": \"090405\",\r\n \"narration\": \"Testing41330324\",\r\n \"account_number\": \"8034074748\",\r\n \"account_name\": \"Obagunwa Emmanuel\",\r\n \"metadata\": {\r\n \"reason\": \"testing\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/transfers/bank","description":"

Merchant Bank Transfer

Endpoint: POST /v1/transfers/bank

Description:
This endpoint allows merchants to initiate a bank transfer by providing the required transfer details. An optional reference can be provided by the merchant. If not provided, a new reference will be generated automatically.

Request Body:

amount (float): The amount to be transferred.
\n
reference (string, optional): A unique reference for the transaction. If not provided, a new reference will be generated.
\n
sortCode (string): The sort code of the recipient's bank.
\n
narration (string): A short description or message about the transfer.
\n
accountNumber (string): The account number of the recipient.
\n
accountName (string): The name of the account holder.
\n
metadata (object, optional): Additional information about the transfer (e.g., reason).
\n
- reason (string, optional): The reason for the transfer.
\n

Response:

On success, returns the details of the initiated bank transfer, including the transaction status and the reference used.
\n
If the reference is provided and a transaction already exists with that reference, an error will be returned.
\n

Error Handling:

If the provided reference already exists, a 409 Conflict error will be returned.
\n
If any required parameter is missing or invalid, a 400 Bad Request error will be returned.
\n

Notes:

Ensure that the X-API-Key header is included for authentication:
\n
X-API-Key: {{API_KEY}}
\n

\n","urlObject":{"path":["transfers","bank"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"1cc308bf-922c-4fc9-945b-c8cee640a4cc","name":"Merchant Transfer to bank account","originalRequest":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"},{"key":"","value":"","type":"text","disabled":true}],"body":{"mode":"raw","raw":"{\r\n \"amount\": 100,\r\n \"sortCode\": \"000013\",\r\n \"narration\": \"Testing\",\r\n \"accountNumber\": \"1700263070\",\r\n \"accountName\": \"Obagunwa Emmanuel\",\r\n \"metadata\": {\r\n \"reason\": \"testing\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/transfers/bank"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 04 Apr 2025 11:40:25 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Content-Length","value":"949"},{"key":"Connection","value":"keep-alive"},{"key":"Cf-Ray","value":"92b087d1eca7a49a-LHR"},{"key":"Server","value":"cloudflare"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Cf-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=tuOOWmA9ty4BK9eK6%2FrLCY9PrNXwFi2Jha8xJOaW9KnePxhy2qZnEtbEKgZ58x5uycwalqeySk2tF03wOlav0aPOmTuohTJFqdstOrHC8BHj56G7FEmTj1idE1ZYEL%2BjiY8%3D\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"Nel","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"},{"key":"server-timing","value":"cfL4;desc=\"?proto=TCP&rtt=169673&min_rtt=142809&rtt_var=64283&sent=5&recv=6&lost=0&retrans=0&sent_bytes=2811&recv_bytes=913&delivery_rate=29407&cwnd=252&unsent_bytes=0&cid=01cf9e0f6c0a1fa3&ts=3270&x=0\""}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"You have successfully make a transfer\",\n \"data\": {\n \"id\": \"c4726646-5719-411f-a621-68e8d019c42f\",\n \"reference\": \"TXN-1743766824-92b964421e1f5ba1\",\n \"currency\": \"NGN\",\n \"environment\": \"SANDBOX\",\n \"balance_after\": 1000050,\n \"balance_before\": 1000150,\n \"merchant_id\": \"c0f0faec-5f1a-450f-84c7-20c7a18d1249\",\n \"metadata\": \"eyJ2YXQiOiAwLjc1LCAiYW1vdW50IjogMTAwLCAiY2hhcmdlcyI6IDEwLCAiYmFua05hbWUiOiAiR1RCQU5LIFBMQyIsICJzb3J0Q29kZSI6ICIwMDAwMTMiLCAibmFycmF0aW9uIjogIlRlc3RpbmciLCAiYWNjb3VudE5hbWUiOiAiT2JhZ3Vud2EgRW1tYW51ZWwiLCAidG90YWxBbW91bnQiOiAxMTAuNzUsICJhY2NvdW50TnVtYmVyIjogIjE3MDAyNjMwNzAiLCAid2FsbGV0QWNjb3VudE5hbWUiOiAiRmluZWNvcmUgVGVjaG5vbG9neSBMaW1pdGVkIiwgImFkZGl0aW9uYWxNZXRhZGF0YSI6IHsicmVhc29uIjogInRlc3RpbmcifX0=\",\n \"amount\": 100,\n \"status\": \"success\",\n \"destination\": \"1700263070/000013\",\n \"description\": \"Transfer of NGN100.00 to Obagunwa Emmanuel (1700263070/GTBANK PLC)/100040250404114025015956728192\",\n \"type\": \"DEBIT\",\n \"category\": \"BANK_TRANSFER\"\n }\n}"}],"_postman_id":"158e4df1-bd11-4787-b15d-5c3739c4dc14"},{"name":"Bank List","id":"df80688e-b0ae-4fa0-a3f1-e907b069a222","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"url":"{{BASE_URL}}/transfers/banks","description":"

List of Banks

Endpoint: GET /v1/transfers/banks

Description:
This endpoint retrieves a list of banks available for transfers. The list contains details about each bank, including the bank name, code, and other relevant information. This can be used to view all supported banks for transfer operations.

Response:

On success, returns a list of banks, including their details such as bank name, code, and any other relevant information.
\n
If no banks are available, an empty list is returned.
\n

Error Handling:

If there is an issue fetching the list of banks, a 500 Internal Server Error will be returned.

Notes:

Ensure that the X-API-Key header is included for authentication:
\n
X-API-Key: {{API_KEY}}
\n

\n","urlObject":{"path":["transfers","banks"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"c2c577c5-edbc-4424-86ac-0203ae7ab0b9","name":"Success Response","originalRequest":{"method":"GET","header":[],"url":"{{BASE_URL}}/transfers/banks"},"status":"OK","code":200,"_postman_previewlanguage":"plain","header":[{"key":"Vary","value":"Origin"},{"key":"Date","value":"Thu, 13 Mar 2025 12:39:15 GMT"},{"key":"Content-Type","value":"text/plain; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\"success\":true,\"message\":\"Successfully fetch list of banks\",\"data\":[{\"code\":\"110005\",\"name\":\"3LINE CARD MANAGEMENT LIMITED\"},{\"code\":\"110072\",\"name\":\"78 FINANCE COMPANY LIMITED\"},{\"code\":\"090629\",\"name\":\"9JAPAY MICROFINANCE BANK\"},{\"code\":\"120001\",\"name\":\"9 PAYMENT SERVICE BANK\"},{\"code\":\"050005\",\"name\":\"AAA FINANCE AND INVESTMENT COMPANY LIMITED\"},{\"code\":\"070010\",\"name\":\"ABBEY MORTGAGE BANK\"},{\"code\":\"090270\",\"name\":\"AB MICROFINANCE BANK\"},{\"code\":\"090260\",\"name\":\"ABOVE ONLY MICROFINANCE BANK\"},{\"code\":\"288037\",\"name\":\"ABSA BANK GHANA LIMITED\"},{\"code\":\"090640\",\"name\":\"ABSU MICROFINANCE BANK\"},{\"code\":\"090424\",\"name\":\"ABUCOOP MFB\"},{\"code\":\"090545\",\"name\":\"ABULESORO MICROFINANCE BANK\"},{\"code\":\"090197\",\"name\":\"ABU MICROFINANCE BANK\"},{\"code\":\"090202\",\"name\":\"ACCELEREX NETWORK LIMITED\"},{\"code\":\"000014\",\"name\":\"ACCESS BANK\"},{\"code\":\"000005\",\"name\":\"ACCESS(DIAMOND) BANK\"},{\"code\":\"100013\",\"name\":\"ACCESS MONEY\"},{\"code\":\"100052\",\"name\":\"ACCESS YELLO \\u0026 BETA\"},{\"code\":\"090134\",\"name\":\"ACCION MICROFINANCE BANK\"},{\"code\":\"090483\",\"name\":\"ADA MFB\"},{\"code\":\"090160\",\"name\":\"ADDOSSER MICROFINANCE BANK\"},{\"code\":\"090268\",\"name\":\"ADEYEMI COLLEGE STAFF MICROFINANCE BANK\"},{\"code\":\"090155\",\"name\":\"ADVANS LA FAYETTE MICROFINANCE BANK\"},{\"code\":\"090614\",\"name\":\"AELLA MICROFINANCE BANK\"},{\"code\":\"090292\",\"name\":\"AFEKHAFE MICROFINANCE BANK\"},{\"code\":\"090518\",\"name\":\"AFEMAI MFB\"},{\"code\":\"100028\",\"name\":\"AG MORTGAGE BANK\"},{\"code\":\"090371\",\"name\":\"AGOSASA MICROFINANCE BANK\"},{\"code\":\"090698\",\"name\":\"AKALABO MFB\"},{\"code\":\"090608\",\"name\":\"AKPO MICROFINANCE BANK\"},{\"code\":\"090561\",\"name\":\"AKUCHUKWU MICROFINANCE BANK\"},{\"code\":\"090531\",\"name\":\"AKU MICROFINANCE BANK\"},{\"code\":\"090133\",\"name\":\"AL-BARAKAH MICROFINANCE BANK\"},{\"code\":\"090259\",\"name\":\"ALEKUN MICROFINANCE BANK\"},{\"code\":\"090297\",\"name\":\"ALERT MICROFINANCE BANK\"},{\"code\":\"090277\",\"name\":\"AL-HAYAT MICROFINANCE BANK\"},{\"code\":\"090131\",\"name\":\"ALLWORKERS MICROFINANCE BANK\"},{\"code\":\"090548\",\"name\":\"ALLY MICROFINANCE BANK\"},{\"code\":\"090169\",\"name\":\"ALPHA KAPITAL MICROFINANCE BANK\"},{\"code\":\"000037\",\"name\":\"ALTERNATIVE BANK LIMITED\"},{\"code\":\"090394\",\"name\":\"AMAC MICROFINANCE BANK\"},{\"code\":\"090180\",\"name\":\"AMJU UNIQUE MICROFINANCE BANK\"},{\"code\":\"090116\",\"name\":\"AMML MICROFINANCE BANK\"},{\"code\":\"090610\",\"name\":\"AMOYE MICROFINANCE BANK\"},{\"code\":\"090645\",\"name\":\"AMUCHA MICROFINANCE BANK\"},{\"code\":\"090143\",\"name\":\"APEKS MICROFINANCE BANK\"},{\"code\":\"090737\",\"name\":\"APEX TRUST MFB\"},{\"code\":\"090376\",\"name\":\"APPLE MICROFINANCE BANK\"},{\"code\":\"090282\",\"name\":\"ARISE MICROFINANCE BANK\"},{\"code\":\"090001\",\"name\":\"ASO SAVINGS\"},{\"code\":\"090544\",\"name\":\"ASPIRE MICROFINANCE BANK\"},{\"code\":\"090287\",\"name\":\"ASSET MATRIX MICROFINANCE BANK\"},{\"code\":\"090473\",\"name\":\"ASSETS MICROFINANCE BANK\"},{\"code\":\"090172\",\"name\":\"ASTRAPOLARIS MICROFINANCE BANK\"},{\"code\":\"090264\",\"name\":\"AUCHI MICROFINANCE BANK\"},{\"code\":\"090633\",\"name\":\"AWACASH MICROFINANCE BANK\"},{\"code\":\"090729\",\"name\":\"BABCOCK MFB\"},{\"code\":\"090625\",\"name\":\"BABURA MICROFINANCE BANK\"},{\"code\":\"090188\",\"name\":\"BAINES CREDIT MICROFINANCE BANK\"},{\"code\":\"090563\",\"name\":\"BALERA MICROFINANCE BANK\"},{\"code\":\"090326\",\"name\":\"BALOGUN GAMBARI MICROFINANCE BANK\"},{\"code\":\"090651\",\"name\":\"BAM MICROFINANCE BANK\"},{\"code\":\"090581\",\"name\":\"BANC CORP MICROFINANCE BANK\"},{\"code\":\"090275\",\"name\":\"BANKIT MICROFINANCE BANK\"},{\"code\":\"090529\",\"name\":\"BANKLY(AMPERSAND) MICROFINANCE BANK\"},{\"code\":\"288028\",\"name\":\"BANK OF AFRICA GHANA LTD\"},{\"code\":\"288001\",\"name\":\"BANK OF GHANA\"},{\"code\":\"694001\",\"name\":\"BANK OF SIERRA LEONE\"},{\"code\":\"324001\",\"name\":\"BANQUE CENTRALE DE LA RÉPUBLIQUE DE GUINÉE\"},{\"code\":\"090136\",\"name\":\"BAOBAB MICROFINANCE BANK\"},{\"code\":\"090316\",\"name\":\"BAYERO UNIVERSITY MICROFINANCE BANK\"},{\"code\":\"090127\",\"name\":\"BC KASH MICROFINANCE BANK\"},{\"code\":\"090672\",\"name\":\"BELLBANK MFB\"},{\"code\":\"090618\",\"name\":\"BERACHAH MICROFINANCE BANK\"},{\"code\":\"090615\",\"name\":\"BESTSTAR MICROFINANCE BANK\"},{\"code\":\"090683\",\"name\":\"BETHEL MICROFINANCE BANK\"},{\"code\":\"090336\",\"name\":\"BIPC MICROFINANCE BANK\"},{\"code\":\"090555\",\"name\":\"BISHOPGATE MICROFINANCE BANK\"},{\"code\":\"270014\",\"name\":\"BLOOM BANK AFRICA GAMBIA LIMITED\"},{\"code\":\"090431\",\"name\":\"BLUEWHALES MICROFINANCE BANK\"},{\"code\":\"090117\",\"name\":\"BOCTRUST MICROFINANCE BANK LIMITED\"},{\"code\":\"090703\",\"name\":\"BOKKOS MICROFINANCE BANK\"},{\"code\":\"090395\",\"name\":\"BORGU MICROFINANCE BANK\"},{\"code\":\"090176\",\"name\":\"BOSAK MICROFINANCE BANK\"},{\"code\":\"090148\",\"name\":\"BOWEN MICROFINANCE BANK\"},{\"code\":\"050006\",\"name\":\"BRANCH INTERNATIONAL FINANCIAL SERVICES\"},{\"code\":\"070015\",\"name\":\"BRENT MORTGAGE BANK\"},{\"code\":\"090293\",\"name\":\"BRETHREN MICROFINANCE BANK\"},{\"code\":\"090393\",\"name\":\"BRIDGEWAY MICROFINANACE BANK\"},{\"code\":\"090308\",\"name\":\"BRIGHTWAY MICROFINANCE BANK\"},{\"code\":\"090636\",\"name\":\"BRIYTH-COVENANT MICROFINANCE BANK\"},{\"code\":\"090568\",\"name\":\"BROADVIEW MICROFINANCE BANK\"},{\"code\":\"090613\",\"name\":\"BUILD MICROFINANCE BANK\"},{\"code\":\"090661\",\"name\":\"BUNDI MICROFINANCE BANK\"},{\"code\":\"090655\",\"name\":\"BUNKURE MICROFINANCE BANK\"},{\"code\":\"090406\",\"name\":\"BUSINESS SUPPORT MICROFINANCE BANK\"},{\"code\":\"090682\",\"name\":\"BUYPOWER MICROFINANACE BANK\"},{\"code\":\"288036\",\"name\":\"CALBANK PLC\"},{\"code\":\"090647\",\"name\":\"CANAAN MICROFINANCE BANK\"},{\"code\":\"090445\",\"name\":\"CAPSTONE MICROFINANCE BANK\"},{\"code\":\"100026\",\"name\":\"CARBON\"},{\"code\":\"050017\",\"name\":\"CARDINALSTONE FINANCE\"},{\"code\":\"090634\",\"name\":\"CASHBRIDGE MICROFINANCE BANK\"},{\"code\":\"090360\",\"name\":\"CASHCONNECT MICROFINANCE BANK\"},{\"code\":\"090649\",\"name\":\"CASHRITE MICROFINANCE BANK\"},{\"code\":\"090498\",\"name\":\"CATLAND MICROFINANCE BANK\"},{\"code\":\"000028\",\"name\":\"CBN\"},{\"code\":\"090562\",\"name\":\"CEDAR MICROFINANCE BANK\"},{\"code\":\"100005\",\"name\":\"CELLULANT\"},{\"code\":\"090154\",\"name\":\"CEMCS MICROFINANCE BANK\"},{\"code\":\"270013\",\"name\":\"CENTRAL BANK OF GAMBIA\"},{\"code\":\"430049\",\"name\":\"CENTRAL BANK OF LIBERIA\"},{\"code\":\"090397\",\"name\":\"CHANELLE MICROFINANCE BANK\"},{\"code\":\"090141\",\"name\":\"CHIKUM MICROFINANCE BANK\"},{\"code\":\"000009\",\"name\":\"CITI BANK\"},{\"code\":\"090144\",\"name\":\"CIT MICROFINANCE BANK\"},{\"code\":\"070027\",\"name\":\"CITYCODE MORTGAGE BANK\"},{\"code\":\"090482\",\"name\":\"CLEARPAY MICROFINANCE BANK\"},{\"code\":\"090374\",\"name\":\"COASTLINE MICROFINANCE BANK\"},{\"code\":\"090530\",\"name\":\"CONFIDENCE MICROFINANCE BANK\"},{\"code\":\"090553\",\"name\":\"CONSISTENT TRUST MICROFINANCE BANK\"},{\"code\":\"288027\",\"name\":\"CONSOLIDATED BANK GHANA LIMITED\"},{\"code\":\"090130\",\"name\":\"CONSUMER MICROFINANCE BANK\"},{\"code\":\"090717\",\"name\":\"COOPFUND MFB\"},{\"code\":\"070021\",\"name\":\"COOP MORTGAGE BANK\"},{\"code\":\"090365\",\"name\":\"CORESTEP MICROFINANCE BANK\"},{\"code\":\"060001\",\"name\":\"CORONATION MERCHANT BANK\"},{\"code\":\"050001\",\"name\":\"COUNTY FINANCE LIMITED\"},{\"code\":\"070006\",\"name\":\"COVENANT MICROFINANCE BANK\"},{\"code\":\"090159\",\"name\":\"CREDIT AFRIQUE MICROFINANCE BANK\"},{\"code\":\"110049\",\"name\":\"CREDIT DIRECT LIMITED\"},{\"code\":\"090611\",\"name\":\"CREDITVILLE MICROFINANCE BANK\"},{\"code\":\"090526\",\"name\":\"CRESCENT MICROFINANCE BANK\"},{\"code\":\"090560\",\"name\":\"CRUST MICROFINANCE BANK\"},{\"code\":\"050029\",\"name\":\"CRYSTAL FINANCE COMPANY LIMITED\"},{\"code\":\"090686\",\"name\":\"CSD MICROFINANCE BANK\"},{\"code\":\"110014\",\"name\":\"CYBERSPACE LIMITED\"},{\"code\":\"090705\",\"name\":\"DAILY TRUST MFB\"},{\"code\":\"090596\",\"name\":\"DAL MICROFINANCE BANK\"},{\"code\":\"090673\",\"name\":\"DAVENPORT MICROFINANCE BANK\"},{\"code\":\"090391\",\"name\":\"DAVODANI MICROFINANCE BANK\"},{\"code\":\"090167\",\"name\":\"DAYLIGHT MICROFINANCE BANK\"},{\"code\":\"090723\",\"name\":\"DESTINY MFB\"},{\"code\":\"090745\",\"name\":\"DIGITVANT MFB\"},{\"code\":\"050013\",\"name\":\"DIGNITY FINANCE AND INVESTMENT LIMITED\"},{\"code\":\"090643\",\"name\":\"DIOBU MICROFINANCE BANK\"},{\"code\":\"090470\",\"name\":\"DOT MICROFINANCE BANK\"},{\"code\":\"090721\",\"name\":\"DW MFB\"},{\"code\":\"090294\",\"name\":\"EAGLE FLIGHT MICROFINANCE BANK\"},{\"code\":\"090674\",\"name\":\"EARNWELL MICROFINANCE BANK\"},{\"code\":\"100021\",\"name\":\"EARTHOLEUM\"},{\"code\":\"090156\",\"name\":\"E-BARCS MICROFINANCE BANK\"},{\"code\":\"000010\",\"name\":\"ECOBANK\"},{\"code\":\"430004\",\"name\":\"ECOBANK LIBERIA LIMITED\"},{\"code\":\"100008\",\"name\":\"ECOBANK XPRESS ACCOUNT\"},{\"code\":\"100030\",\"name\":\"ECOMOBILE\"},{\"code\":\"090310\",\"name\":\"EDFIN MICROFINANCE BANK\"},{\"code\":\"050016\",\"name\":\"E-FINANCE\"},{\"code\":\"090694\",\"name\":\"EJINDU MICROFINANCE BANK\"},{\"code\":\"090097\",\"name\":\"EKONDO MICROFINANCE BANK\"},{\"code\":\"090389\",\"name\":\"EK-RELIABLE MICROFINANCE BANK\"},{\"code\":\"090712\",\"name\":\"EMAAR MFB\"},{\"code\":\"090273\",\"name\":\"EMERALD MICROFINANCE BANK\"},{\"code\":\"090114\",\"name\":\"EMPIRE TRUST MICROFINANCE BANK\"},{\"code\":\"050012\",\"name\":\"ENCO FINANCE COMPANY LTD\"},{\"code\":\"000019\",\"name\":\"ENTERPRISE BANK\"},{\"code\":\"090656\",\"name\":\"ENTITY MICROFINANCE BANK\"},{\"code\":\"090189\",\"name\":\"ESAN MICROFINANCE BANK\"},{\"code\":\"090166\",\"name\":\"ESO-E MICROFINANCE BANK\"},{\"code\":\"100006\",\"name\":\"ETRANZACT\"},{\"code\":\"090304\",\"name\":\"EVANGEL MICROFINANCE BANK\"},{\"code\":\"090332\",\"name\":\"EVERGREEN MICROFINANCE BANK\"},{\"code\":\"090572\",\"name\":\"EWT MICROFINANCE BANK\"},{\"code\":\"090541\",\"name\":\"EXCELLENT MICROFINANCE BANK\"},{\"code\":\"090678\",\"name\":\"EXCEL MICROFINANCE BANK\"},{\"code\":\"090328\",\"name\":\"EYOWO\"},{\"code\":\"090551\",\"name\":\"FAIRMONEY\"},{\"code\":\"050009\",\"name\":\"FAST CREDIT LIMITED\"},{\"code\":\"090179\",\"name\":\"FAST MICROFINANCE BANK\"},{\"code\":\"288032\",\"name\":\"FBNBANK GHANA LIMITED\"},{\"code\":\"060002\",\"name\":\"FBNQUEST MERCHANT BANK\"},{\"code\":\"090409\",\"name\":\"FCMB MFB\"},{\"code\":\"100031\",\"name\":\"FCMB MOBILE\"},{\"code\":\"090290\",\"name\":\"FCT MICROFINANCE BANK\"},{\"code\":\"090398\",\"name\":\"FEDERAL POLYTECHNIC NEKEDE MICROFINANCE BANK\"},{\"code\":\"090318\",\"name\":\"FEDERAL UNIVERSITY DUTSE MICROFINANCE BANK\"},{\"code\":\"090298\",\"name\":\"FEDPOLY NASARAWA MICROFINANCE BANK\"},{\"code\":\"100001\",\"name\":\"FETS\"},{\"code\":\"050002\",\"name\":\"FEWCHORE FINANCE COMPANY LIMITED\"},{\"code\":\"090153\",\"name\":\"FFS MICROFINANCE BANK\"},{\"code\":\"000007\",\"name\":\"FIDELITY BANK\"},{\"code\":\"100019\",\"name\":\"FIDELITY MOBILE\"},{\"code\":\"090126\",\"name\":\"FIDFUND MICROFINANCE BANK\"},{\"code\":\"090111\",\"name\":\"FINATRUST MICROFINANCE BANK\"},{\"code\":\"090400\",\"name\":\"FINCA MICROFINANCE BANK\"},{\"code\":\"090366\",\"name\":\"FIRMUS MICROFINANCE BANK\"},{\"code\":\"110004\",\"name\":\"FIRST APPLE LIMITED\"},{\"code\":\"288035\",\"name\":\"FIRST ATLANTIC BANK GHANA LIMITED\"},{\"code\":\"000016\",\"name\":\"FIRST BANK OF NIGERIA\"},{\"code\":\"000003\",\"name\":\"FIRST CITY MONUMENT BANK\"},{\"code\":\"070014\",\"name\":\"FIRST GENERATION MORTGAGE BANK\"},{\"code\":\"100014\",\"name\":\"FIRSTMONIE WALLET\"},{\"code\":\"090285\",\"name\":\"FIRST OPTION MICROFINANCE BANK\"},{\"code\":\"090164\",\"name\":\"FIRST ROYAL MICROFINANCE BANK\"},{\"code\":\"090107\",\"name\":\"FIRST TRUST MORTGAGE BANK PLC\"},{\"code\":\"110002\",\"name\":\"FLUTTERWAVE TECHNOLOGY SOLUTIONS LIMITED\"},{\"code\":\"090709\",\"name\":\"FOCUS MFB\"},{\"code\":\"090521\",\"name\":\"FORESIGHT MICROFINANCE BANK\"},{\"code\":\"070002\",\"name\":\"FORTIS MICROFINANCE BANK\"},{\"code\":\"100016\",\"name\":\"FORTIS MOBILE\"},{\"code\":\"090486\",\"name\":\"FORTRESS MICROFINANCE BANK\"},{\"code\":\"400001\",\"name\":\"FSDH\"},{\"code\":\"090145\",\"name\":\"FULLRANGE MICROFINANCE BANK\"},{\"code\":\"090158\",\"name\":\"FUTO MICROFINANCE BANK\"},{\"code\":\"090582\",\"name\":\"GABASAWA MICROFINANCE BANK\"},{\"code\":\"090591\",\"name\":\"GABSYN MICROFINANCE BANK\"},{\"code\":\"090691\",\"name\":\"GARUN MALLAM MFB\"},{\"code\":\"090168\",\"name\":\"GASHUA MICROFINANCE BANK\"},{\"code\":\"070009\",\"name\":\"GATEWAY MORTGAGE BANK\"},{\"code\":\"288025\",\"name\":\"GCB BANK PLC\"},{\"code\":\"050026\",\"name\":\"GDL FINANCE\"},{\"code\":\"090621\",\"name\":\"GIDAUNIYAR ALHERI MICROFINANCE BANK\"},{\"code\":\"090186\",\"name\":\"GIREI MICROFINANACE BANK\"},{\"code\":\"090639\",\"name\":\"GLOBAL INITIATIVE MICROFINANCE BANK\"},{\"code\":\"000027\",\"name\":\"GLOBUS BANK\"},{\"code\":\"090278\",\"name\":\"GLORY MICROFINANCE BANK\"},{\"code\":\"090408\",\"name\":\"GMB MICROFINANCE BANK\"},{\"code\":\"090586\",\"name\":\"GOMBE MICROFINANCE BANK LIMITED\"},{\"code\":\"090664\",\"name\":\"GOOD SHEPHERD MICROFINANCE BANK\"},{\"code\":\"090687\",\"name\":\"GOSIFECHUKWU MICROFINANCE BANK\"},{\"code\":\"090122\",\"name\":\"GOWANS MICROFINANCE BANK\"},{\"code\":\"090335\",\"name\":\"GRANTS MICROFINANCE BANK\"},{\"code\":\"090599\",\"name\":\"GREENACRES MICROFINANCE BANK LTD\"},{\"code\":\"090178\",\"name\":\"GREENBANK MICROFINANCE BANK\"},{\"code\":\"090550\",\"name\":\"GREEN ENERGY MICROFINANCE BANK\"},{\"code\":\"090269\",\"name\":\"GREENVILLE MICROFINANCE BANK\"},{\"code\":\"060004\",\"name\":\"GREENWICH MERCHANT BANK\"},{\"code\":\"090195\",\"name\":\"GROOMING MICROFINANCE BANK\"},{\"code\":\"000013\",\"name\":\"GTBANK PLC\"},{\"code\":\"090385\",\"name\":\"GTI MICROFINANCE BANK\"},{\"code\":\"100009\",\"name\":\"GT MOBILE\"},{\"code\":\"288031\",\"name\":\"GUARANTY TRUST BANK (GHANA) LTD\"},{\"code\":\"090500\",\"name\":\"GWONG MICROFINANCE BANK\"},{\"code\":\"090147\",\"name\":\"HACKMAN MICROFINANCE BANK\"},{\"code\":\"070017\",\"name\":\"HAGGAI MORTGAGE BANK LIMITED\"},{\"code\":\"090291\",\"name\":\"HALALCREDIT MICROFINANCE BANK\"},{\"code\":\"090539\",\"name\":\"HALO MICROFINANCE BANK\"},{\"code\":\"090121\",\"name\":\"HASAL MICROFINANCE BANK\"},{\"code\":\"090363\",\"name\":\"HEADWAY MICROFINANCE BANK\"},{\"code\":\"100017\",\"name\":\"HEDONMARK\"},{\"code\":\"000020\",\"name\":\"HERITAGE BANK\"},{\"code\":\"0070024\",\"name\":\"HOMEBASE MORTGAGE BANK\"},{\"code\":\"120002\",\"name\":\"HOPEPSB\"},{\"code\":\"090115\",\"name\":\"IBANK MICROFINANCE BANK\"},{\"code\":\"090697\",\"name\":\"IBBU MFB\"},{\"code\":\"090118\",\"name\":\"IBILE MICROFINANCE BANK\"},{\"code\":\"090532\",\"name\":\"IBOLO MICROFINANCE BANK\"},{\"code\":\"090519\",\"name\":\"IBOM FADAMA MICROFINANCE BANK\"},{\"code\":\"090520\",\"name\":\"IC GLOBAL MICROFINANCE BANK\"},{\"code\":\"090725\",\"name\":\"IHIALA MFB\"},{\"code\":\"090730\",\"name\":\"IJARE MFB\"},{\"code\":\"090546\",\"name\":\"IJEBU-IFE MICROFINANCE BANK\"},{\"code\":\"090324\",\"name\":\"IKENNE MICROFINANCE BANK\"},{\"code\":\"090279\",\"name\":\"IKIRE MICROFINANCE BANK\"},{\"code\":\"090681\",\"name\":\"IKOYI ILE MICROFINANCEBANK\"},{\"code\":\"090571\",\"name\":\"ILARO POLY MICROFINANCE BANK\"},{\"code\":\"090710\",\"name\":\"ILE-OLUJI MFB\"},{\"code\":\"090370\",\"name\":\"ILISAN MICROFINANCE BANK\"},{\"code\":\"090430\",\"name\":\"ILORA MICROFINANCE BANK\"},{\"code\":\"090258\",\"name\":\"IMO STATE MICROFINANCE BANK\"},{\"code\":\"100024\",\"name\":\"IMPERIAL HOMES MORTGAGE BANK\"},{\"code\":\"090670\",\"name\":\"IMSU MICROFINANCE BANK\"},{\"code\":\"090157\",\"name\":\"INFINITY MICROFINANCE BANK\"},{\"code\":\"070016\",\"name\":\"INFINITY TRUST MORTGAGE BANK\"},{\"code\":\"100029\",\"name\":\"INNOVECTIVES KESH\"},{\"code\":\"100027\",\"name\":\"INTELLIFIN\"},{\"code\":\"090386\",\"name\":\"INTERLAND MICROFINANCE BANK\"},{\"code\":\"423003\",\"name\":\"INTERNATIONAL BANK (LIBERIA) LIMITED\"},{\"code\":\"110003\",\"name\":\"INTERSWITCH LIMITED\"},{\"code\":\"090149\",\"name\":\"IRL MICROFINANCE BANK\"},{\"code\":\"090377\",\"name\":\"ISALEOYO MICROFINANCE BANK\"},{\"code\":\"090584\",\"name\":\"ISLAND MICROFINANCE BANK\"},{\"code\":\"090701\",\"name\":\"ISUA MICROFINANCE BANK\"},{\"code\":\"090543\",\"name\":\"IWOAMA MICROFINANCE BANK\"},{\"code\":\"090337\",\"name\":\"IYE OKIN MICROFINANCE BANK LTD\"},{\"code\":\"000006\",\"name\":\"JAIZ BANK\"},{\"code\":\"070029\",\"name\":\"JIGAWA SAVINGS AND LOANS\"},{\"code\":\"090003\",\"name\":\"JUBILEE LIFE\"},{\"code\":\"090320\",\"name\":\"KADPOLY MICROFINANCE BANK\"},{\"code\":\"090669\",\"name\":\"KADUPE MICROFINANCE BANK\"},{\"code\":\"090684\",\"name\":\"KATAGUM MFB\"},{\"code\":\"090667\",\"name\":\"KAYI MICROFINANCE BANK\"},{\"code\":\"090554\",\"name\":\"KAYVEE MICROFINANCE BANK\"},{\"code\":\"090191\",\"name\":\"KCMB MICROFINANCE BANK\"},{\"code\":\"090549\",\"name\":\"KC MICROFINANCE BANK\"},{\"code\":\"100036\",\"name\":\"KEGOW(CHAMSMOBILE)\"},{\"code\":\"000002\",\"name\":\"KEYSTONE BANK\"},{\"code\":\"090606\",\"name\":\"KKU MICROFINANCE BANK\"},{\"code\":\"090480\",\"name\":\"KOLOMONI MICROFINANCE BANK\"},{\"code\":\"100025\",\"name\":\"KONGAPAY\"},{\"code\":\"090299\",\"name\":\"KONTAGORA MICROFINANCE BANK\"},{\"code\":\"090617\",\"name\":\"KOPO KOPE MICROFINANCE BANK\"},{\"code\":\"090380\",\"name\":\"KREDI MONEY MICROFINANCE BANK\"},{\"code\":\"090267\",\"name\":\"KUDA MICROFINANCE BANK\"},{\"code\":\"070012\",\"name\":\"LAGOS BUILDING AND INVESTMENT COMPANY\"},{\"code\":\"090177\",\"name\":\"LAPO MICROFINANCE BANK\"},{\"code\":\"090271\",\"name\":\"LAVENDER MICROFINANCE BANK\"},{\"code\":\"090724\",\"name\":\"LAWYERS MFB\"},{\"code\":\"090650\",\"name\":\"LEADCITY MICROFINANCE BANK\"},{\"code\":\"110044\",\"name\":\"LEADREMIT LIMITED\"},{\"code\":\"090372\",\"name\":\"LEGEND MICROFINANCE BANK\"},{\"code\":\"090420\",\"name\":\"LETSHEGO MICROFI\"},{\"code\":\"090731\",\"name\":\"LEVITE MFB\"},{\"code\":\"090557\",\"name\":\"LIFEGATE MICROFINANCE BANK\"},{\"code\":\"090435\",\"name\":\"LINKS MICROFINANCE BANK\"},{\"code\":\"070007\",\"name\":\"LIVINGTRUST MORTGAGE BANK PLC\"},{\"code\":\"090620\",\"name\":\"LOMA MFB\"},{\"code\":\"000029\",\"name\":\"LOTUS BANK\"},{\"code\":\"090265\",\"name\":\"LOVONUS MICROFINANCE BANK\"},{\"code\":\"050015\",\"name\":\"LUKEFIELD FINANCE COMPANY LIMITED\"},{\"code\":\"100035\",\"name\":\"M36\"},{\"code\":\"090623\",\"name\":\"MAB ALLIANZ MICROFINANCE BANK\"},{\"code\":\"090630\",\"name\":\"MABINAS MICROFINANCE BANK\"},{\"code\":\"090603\",\"name\":\"MACROD MICROFINANCE BANK LIMITED\"},{\"code\":\"090605\",\"name\":\"MADOBI MICROFINANCE BANK\"},{\"code\":\"090746\",\"name\":\"MAESTRO MFB\"},{\"code\":\"090323\",\"name\":\"MAINLAND MICROFINANCE BANK\"},{\"code\":\"090171\",\"name\":\"MAINSTREET MICROFINANCE BANK\"},{\"code\":\"090174\",\"name\":\"MALACHY MICROFINANCE BANK\"},{\"code\":\"090383\",\"name\":\"MANNY MICROFINANCE BANK\"},{\"code\":\"090410\",\"name\":\"MARITIME MICROFINANCE BANK\"},{\"code\":\"090321\",\"name\":\"MAYFAIR MICROFINANCE BANK\"},{\"code\":\"070019\",\"name\":\"MAYFRESH MORTGAGE BANK\"},{\"code\":\"090612\",\"name\":\"MEDEF MICROFINANCE BANK\"},{\"code\":\"090280\",\"name\":\"MEGAPRAISE MICROFINANCE BANK\"},{\"code\":\"090589\",\"name\":\"MERCURY MICROFINANCE BANK\"},{\"code\":\"090659\",\"name\":\"MICHAEL OKPARA UNIAGRIC UNIVERSITY MFB\"},{\"code\":\"090587\",\"name\":\"MICROBIZ MICROFINANCE BANK\"},{\"code\":\"090113\",\"name\":\"MICROVIS MICROFINANCE BANK\"},{\"code\":\"090192\",\"name\":\"MIDLAND MICROFINANCE BANK\"},{\"code\":\"090607\",\"name\":\"MINJIBIR MICROFINANCE BANK\"},{\"code\":\"090281\",\"name\":\"MINT-FINEX MFB\"},{\"code\":\"090455\",\"name\":\"MKOBO MFB\"},{\"code\":\"100011\",\"name\":\"MKUDI\"},{\"code\":\"090685\",\"name\":\"M\\u0026M MICROFINANCE BANK\"},{\"code\":\"090362\",\"name\":\"MOLUSI MICROFINANCE BANK\"},{\"code\":\"120003\",\"name\":\"MOMO PAYMENT SERVICE BANK\"},{\"code\":\"100020\",\"name\":\"MONEY BOX\"},{\"code\":\"120005\",\"name\":\"MONEY MASTER PSB\"},{\"code\":\"090129\",\"name\":\"MONEY TRUST MICROFINANCE BANK\"},{\"code\":\"090405\",\"name\":\"MONIEPOINT MICROFINANCE BANK\"},{\"code\":\"090392\",\"name\":\"MOZFIN MICROFINANCE BANK\"},{\"code\":\"070028\",\"name\":\"MUTUAL ALLIANCE MORTGAGE BANK\"},{\"code\":\"090190\",\"name\":\"MUTUAL BENEFITS MICROFINANCE BANK\"},{\"code\":\"090151\",\"name\":\"MUTUAL TRUST MICROFINANCE BANK\"},{\"code\":\"090740\",\"name\":\"NAF MFB\"},{\"code\":\"090152\",\"name\":\"NAGARTA MICROFINANCE BANK\"},{\"code\":\"090679\",\"name\":\"NDDC MICROFINANCE BANK\"},{\"code\":\"090128\",\"name\":\"NDIORAH MICROFINANCE BANK\"},{\"code\":\"090329\",\"name\":\"NEPTUNE MICROFINANCE BANK\"},{\"code\":\"090675\",\"name\":\"NET MICROFINANCE BANK\"},{\"code\":\"090205\",\"name\":\"NEW DAWN MICROFINANCE BANK\"},{\"code\":\"090378\",\"name\":\"NEW GOLDEN PASTURES MICROFINANCE BANK\"},{\"code\":\"090108\",\"name\":\"NEW PRUDENTIAL BANK\"},{\"code\":\"030001\",\"name\":\"NEXIM BANK\"},{\"code\":\"090263\",\"name\":\"NIGERIAN NAVY MICROFINANCE BANK\"},{\"code\":\"090505\",\"name\":\"NIGERIA PRISONS MICROFINANCE BANK\"},{\"code\":\"999999\",\"name\":\"NIP VIRTUAL BANK\"},{\"code\":\"090194\",\"name\":\"NIRSAL NATIONAL MICROFINANCE BANK\"},{\"code\":\"090283\",\"name\":\"NNEW WOMEN MICROFINANCE BANK\"},{\"code\":\"090736\",\"name\":\"NOMASE MFB\"},{\"code\":\"060003\",\"name\":\"NOVA BANK\"},{\"code\":\"090734\",\"name\":\"NOVUS MFB\"},{\"code\":\"100032\",\"name\":\"NOWNOW DIGITAL SYSTEMS LIMITED\"},{\"code\":\"070001\",\"name\":\"NPF MICROFINANCE BANK\"},{\"code\":\"090628\",\"name\":\"NSEHE MICROFINANCE BANK\"},{\"code\":\"090676\",\"name\":\"NUGGETS MICROFINANCE BANK\"},{\"code\":\"090364\",\"name\":\"NUTURE MICROFINANCE BANK\"},{\"code\":\"090399\",\"name\":\"NWANNEGADI MICROFINANCE BANK\"},{\"code\":\"090333\",\"name\":\"OCHE MICROFINANCE BANK\"},{\"code\":\"090654\",\"name\":\"ODOAKPU MICROFINANCE BANK\"},{\"code\":\"090738\",\"name\":\"OGBERURU MFB\"},{\"code\":\"090739\",\"name\":\"OGIGE MFB\"},{\"code\":\"090119\",\"name\":\"OHAFIA MICROFINANCE BANK\"},{\"code\":\"090626\",\"name\":\"OHHA MICROFINANCE BANK\"},{\"code\":\"090527\",\"name\":\"OJOKORO MICROFINANCE BANK\"},{\"code\":\"090565\",\"name\":\"OKE-ARO OREDEGBE MFB\"},{\"code\":\"090646\",\"name\":\"OKENGWE MICROFINANCE BANK\"},{\"code\":\"090161\",\"name\":\"OKPOGA MICROFINANCE BANK\"},{\"code\":\"090566\",\"name\":\"OKUKU MICROFINANCE BANK\"},{\"code\":\"090272\",\"name\":\"OLABISI ONABANJO UNIVERSITY MICROFINANCE\"},{\"code\":\"090696\",\"name\":\"OLIVE MFB\"},{\"code\":\"090404\",\"name\":\"OLOWOLAGBA MICROFINANCE BANK\"},{\"code\":\"090404\",\"name\":\"OLOWOLAGBA MICROFINANCE BANK LIMITED\"},{\"code\":\"090700\",\"name\":\"OMAK MICROFINANCE BANK\"},{\"code\":\"090295\",\"name\":\"OMIYE MICROFINANCE BANK\"},{\"code\":\"288033\",\"name\":\"OMNIBSIC BANK GHANA LTD\"},{\"code\":\"100004\",\"name\":\"OPAY\"},{\"code\":\"000036\",\"name\":\"OPTIMUS BANK\"},{\"code\":\"090567\",\"name\":\"OROKAM MICROFINANCE BANK\"},{\"code\":\"090396\",\"name\":\"OSCOTECH MICROFINANCE BANK\"},{\"code\":\"090715\",\"name\":\"OSOMHE MFB\"},{\"code\":\"090580\",\"name\":\"OTECH MICROFINANCE BANK\"},{\"code\":\"090542\",\"name\":\"OTUO MICROFINANCE BANK\"},{\"code\":\"090635\",\"name\":\"OYAN MICROFINANCE BANK\"},{\"code\":\"100002\",\"name\":\"PAGA\"},{\"code\":\"070008\",\"name\":\"PAGE MFBANK\"},{\"code\":\"100033\",\"name\":\"PALMPAY\"},{\"code\":\"000030\",\"name\":\"PARALLEX BANK\"},{\"code\":\"100003\",\"name\":\"PARKWAY-READYCASH\"},{\"code\":\"090680\",\"name\":\"PATHFINDER MICROFINANACE BANK LIMITED\"},{\"code\":\"090317\",\"name\":\"PATRICKGOLD MICROFINANCE BANK\"},{\"code\":\"110001\",\"name\":\"PAYATTITUDE ONLINE\"},{\"code\":\"110006\",\"name\":\"PAYSTACK PAYMENT LIMITED\"},{\"code\":\"090402\",\"name\":\"PEACE MICROFINANCE BANK\"},{\"code\":\"090137\",\"name\":\"PECANTRUST MICROFINANCE BANK\"},{\"code\":\"090196\",\"name\":\"PENNYWISE MICROFINANCE BANK\"},{\"code\":\"090135\",\"name\":\"PERSONAL TRUST MICROFINANCE BANK\"},{\"code\":\"090165\",\"name\":\"PETRA MICROFINANCE BANK\"},{\"code\":\"050021\",\"name\":\"PFI FINANCE COMPANY LIMITED\"},{\"code\":\"090289\",\"name\":\"PILLAR MICROFINANCE BANK\"},{\"code\":\"070013\",\"name\":\"PLATINUM MORTGAGE BANK\"},{\"code\":\"000008\",\"name\":\"POLARIS BANK\"},{\"code\":\"090296\",\"name\":\"POLYUNWANA MICROFINANCE BANK\"},{\"code\":\"000031\",\"name\":\"PREMIUM TRUST BANK\"},{\"code\":\"090274\",\"name\":\"PRESTIGE MICROFINANCE BANK\"},{\"code\":\"090495\",\"name\":\"PROSPA CAPITAL MICROFINANCE BANK\"},{\"code\":\"090689\",\"name\":\"PROSPECTS MICROFINANCE BANK\"},{\"code\":\"050023\",\"name\":\"PROSPERIS FINANCE LIMITED\"},{\"code\":\"090642\",\"name\":\"PROSPERITY MICROFINANCE BANK\"},{\"code\":\"000023\",\"name\":\"PROVIDUS BANK\"},{\"code\":\"288026\",\"name\":\"PRUDENTIAL BANK LIMITED\"},{\"code\":\"090690\",\"name\":\"PRUDENT MICROFINANCE BANK\"},{\"code\":\"090303\",\"name\":\"PURPLEMONEY MICROFINANCE BANK\"},{\"code\":\"090657\",\"name\":\"PYRAMID MICROFINANCE BANK\"},{\"code\":\"090261\",\"name\":\"QUICKFUND MICROFINANCE BANK\"},{\"code\":\"000024\",\"name\":\"RAND MERCHANT BANK\"},{\"code\":\"090616\",\"name\":\"RAYYAN MICROFINANCE BANK\"},{\"code\":\"070011\",\"name\":\"REFUGE MORTGAGE BANK\"},{\"code\":\"090125\",\"name\":\"REGENT MICROFINANCE BANK\"},{\"code\":\"090463\",\"name\":\"REHOBOTH MICROFINANCE BANK\"},{\"code\":\"090173\",\"name\":\"RELIANCE MICROFINANCE BANK\"},{\"code\":\"090198\",\"name\":\"RENMONEY MICROFINANCE BANK\"},{\"code\":\"090322\",\"name\":\"REPHIDIM MICROFINANCE BANK\"},{\"code\":\"090666\",\"name\":\"REVELATION MICROFINANCE BANK\"},{\"code\":\"090449\",\"name\":\"REX MICROFINANCE BANK\"},{\"code\":\"090132\",\"name\":\"RICHWAY MICROFINANCE BANK\"},{\"code\":\"090720\",\"name\":\"RIC MFB\"},{\"code\":\"090433\",\"name\":\"RIGO MICROFINANCE BANK\"},{\"code\":\"090515\",\"name\":\"RIMA GROWTH PATHWAY MICROFINANCE BANK\"},{\"code\":\"090547\",\"name\":\"ROCKSHIELD MICROFINANCE BANK\"},{\"code\":\"090622\",\"name\":\"ROYAL BLUE MICROFINANCE BANK\"},{\"code\":\"090138\",\"name\":\"ROYAL EXCHANGE MICROFINANCE BANK\"},{\"code\":\"090175\",\"name\":\"RUBIES MICROFINANCE BANK\"},{\"code\":\"090727\",\"name\":\"SABI MFB\"},{\"code\":\"090485\",\"name\":\"SAFEGATE MICROFINANCE BANK\"},{\"code\":\"090286\",\"name\":\"SAFE HAVEN MICROFINANCE BANK\"},{\"code\":\"090006\",\"name\":\"SAFETRUST\"},{\"code\":\"090140\",\"name\":\"SAGAMU MICROFINANCE BANK\"},{\"code\":\"050003\",\"name\":\"SAGE GREY FINANCE LIMITED\"},{\"code\":\"430050\",\"name\":\"SAPELLE INTERNATIONAL BANK LIBERIA LIMITED\"},{\"code\":\"090513\",\"name\":\"SEAP MICROFINANCE BANK\"},{\"code\":\"090112\",\"name\":\"SEED CAPITAL MICROFINANCE BANK\"},{\"code\":\"090369\",\"name\":\"SEEDVEST MICROFINANCE BANK\"},{\"code\":\"090502\",\"name\":\"SHALOM MICROFINANCE BANK\"},{\"code\":\"090401\",\"name\":\"SHERPERD TRUST MICROFINANCE BANK\"},{\"code\":\"090559\",\"name\":\"SHIELD MICROFINANCE BANK\"},{\"code\":\"090558\",\"name\":\"SHONGOM MICROFINANCE BANK\"},{\"code\":\"000034\",\"name\":\"SIGNATURE BANK\"},{\"code\":\"050008\",\"name\":\"SIMPLE FINANCE LIMITED\"},{\"code\":\"090339\",\"name\":\"SINCERE MFB\"},{\"code\":\"120004\",\"name\":\"SMARTCASH PAYMENT SERVICE BANK\"},{\"code\":\"090506\",\"name\":\"SOLID ALLIANZE MICROFINANCE BANK\"},{\"code\":\"090524\",\"name\":\"SOLIDROCK MICROFINANCE BANK\"},{\"code\":\"090641\",\"name\":\"SOURCE MICROFINANCE BANK\"},{\"code\":\"090325\",\"name\":\"SPARKLE\"},{\"code\":\"090436\",\"name\":\"SPECTRUM MICROFINANCE BANK\"},{\"code\":\"288030\",\"name\":\"STANBIC BANK GHANA LTD\"},{\"code\":\"000012\",\"name\":\"STANBIC IBTC BANK\"},{\"code\":\"100007\",\"name\":\"STANBIC IBTC @EASE WALLET\"},{\"code\":\"000021\",\"name\":\"STANDARD CHARTERED BANK\"},{\"code\":\"090162\",\"name\":\"STANFORD MICROFINANCE BANK\"},{\"code\":\"090583\",\"name\":\"STATESIDE MFB\"},{\"code\":\"070022\",\"name\":\"STB MORTGAGE BANK\"},{\"code\":\"090262\",\"name\":\"STELLAS MICROFINANCE BANK\"},{\"code\":\"000001\",\"name\":\"STERLING BANK\"},{\"code\":\"100022\",\"name\":\"STERLING MOBILE\"},{\"code\":\"090305\",\"name\":\"SULSPAP MICROFINANCE BANK\"},{\"code\":\"090644\",\"name\":\"SUNTOP MICROFINANCE\"},{\"code\":\"000022\",\"name\":\"SUNTRUST BANK\"},{\"code\":\"090446\",\"name\":\"SUPPORT MICROFINANCE BANK\"},{\"code\":\"090564\",\"name\":\"SUPREME MICROFINANCE BANK\"},{\"code\":\"090728\",\"name\":\"SURE ANCHOR MFB\"},{\"code\":\"100023\",\"name\":\"TAGPAY\"},{\"code\":\"000026\",\"name\":\"TAJ BANK\"},{\"code\":\"090638\",\"name\":\"TANGALE MICROFINANCE BANK\"},{\"code\":\"090426\",\"name\":\"TANGERINE MONEY\"},{\"code\":\"110007\",\"name\":\"TEAMAPT LIMITED\"},{\"code\":\"100010\",\"name\":\"TEASY MOBILE\"},{\"code\":\"050007\",\"name\":\"TEKLA FACTORING AND FINANCE LIMITED\"},{\"code\":\"090716\",\"name\":\"TENN MFB\"},{\"code\":\"090711\",\"name\":\"THE MILLENNIUM MFB\"},{\"code\":\"090373\",\"name\":\"THINK FINANCE MICROFINANCE BANK\"},{\"code\":\"100039\",\"name\":\"TITAN-PAYSTACK\"},{\"code\":\"000025\",\"name\":\"TITAN TRUST BANK\"},{\"code\":\"090714\",\"name\":\"TOFA MFB\"},{\"code\":\"090613\",\"name\":\"TOTAL TRUST MICROFINANCE BANK\"},{\"code\":\"090708\",\"name\":\"TRANSPAY MFB\"},{\"code\":\"090663\",\"name\":\"TREASURES MICROFINANCE BANK\"},{\"code\":\"090146\",\"name\":\"TRIDENT MICROFINANCE BANK\"},{\"code\":\"050014\",\"name\":\"TRINITY FINANCE\"},{\"code\":\"090525\",\"name\":\"TRIPLEA MICROFINANCE BANK\"},{\"code\":\"050023\",\"name\":\"TRIVES FINANCE COMPANY LTD\"},{\"code\":\"090123\",\"name\":\"TRUSTBANC J6 MICROFINANCE BANK LIMITED\"},{\"code\":\"090005\",\"name\":\"TRUSTBOND MORTGAGE BANK\"},{\"code\":\"090276\",\"name\":\"TRUSTFUND MICROFINANCE BANK\"},{\"code\":\"090327\",\"name\":\"TRUST MICROFINANCE BANK\"},{\"code\":\"000040\",\"name\":\"UBA MONI\"},{\"code\":\"090706\",\"name\":\"UCEE MICROFINANCE BANK\"},{\"code\":\"090315\",\"name\":\"U \\u0026 C MICROFINANCE BANK\"},{\"code\":\"090403\",\"name\":\"UDA MICROFINANCE BANK\"},{\"code\":\"090517\",\"name\":\"UHURU MICROFINANCE BANK\"},{\"code\":\"090609\",\"name\":\"UMMAH MICROFINANCE BANK\"},{\"code\":\"090514\",\"name\":\"UMUCHINEMERE PROCREDIT MICROFINANCE BANK\"},{\"code\":\"090652\",\"name\":\"UMUCHUKWU MICROFINANCE BANK\"},{\"code\":\"090331\",\"name\":\"UNAAB MICROFINANCE BANK\"},{\"code\":\"090266\",\"name\":\"UNIBEN MICROFINANCE BANK\"},{\"code\":\"090193\",\"name\":\"UNICAL MICROFINANCE BANK\"},{\"code\":\"090637\",\"name\":\"UNIFUND MICROFINANCE BANK LIMITED\"},{\"code\":\"090341\",\"name\":\"UNILORIN MICROFINANCE BANK\"},{\"code\":\"000018\",\"name\":\"UNION BANK\"},{\"code\":\"000004\",\"name\":\"UNITED BANK FOR AFRICA\"},{\"code\":\"288002\",\"name\":\"UNITED BANK FOR AFRICA (GHANA) LIMITED\"},{\"code\":\"324002\",\"name\":\"UNITED BANK FOR AFRICA GUINEA SA\"},{\"code\":\"430002\",\"name\":\"UNITED BANK FOR AFRICA LIBERIA LTD\"},{\"code\":\"694002\",\"name\":\"UNITED BANK FOR AFRICA (SL) LIMITED\"},{\"code\":\"000011\",\"name\":\"UNITY BANK\"},{\"code\":\"090338\",\"name\":\"UNIUYO MFB\"},{\"code\":\"288029\",\"name\":\"UNIVERSAL MERCHANT BANK\"},{\"code\":\"090251\",\"name\":\"UNIVERSITY OF NIGERIA, NSUKKA MICROFINANCE BANK\"},{\"code\":\"090719\",\"name\":\"UNUBI MFB\"},{\"code\":\"090619\",\"name\":\"URE MICROFINANCE BANK\"},{\"code\":\"090453\",\"name\":\"UZONDU MICROFINANCE BANK\"},{\"code\":\"050020\",\"name\":\"VALE FINANCE LIMITED\"},{\"code\":\"110009\",\"name\":\"VENTURE GARDEN NIGERIA LIMITED\"},{\"code\":\"090474\",\"name\":\"VERDANT MICROFINANCE BANK\"},{\"code\":\"090110\",\"name\":\"VFD MFB\"},{\"code\":\"090150\",\"name\":\"VIRTUE MICROFINANCE BANK\"},{\"code\":\"090139\",\"name\":\"VISA MICROFINANCE BANK\"},{\"code\":\"100012\",\"name\":\"VT NETWORKS\"},{\"code\":\"090590\",\"name\":\"WAYA MICROFINANCE BANK\"},{\"code\":\"000017\",\"name\":\"WEMA BANK\"},{\"code\":\"090699\",\"name\":\"WESLEY MICROFINANCE BANK\"},{\"code\":\"090741\",\"name\":\"WESTON-CHARIS MFB\"},{\"code\":\"090120\",\"name\":\"WETLAND MICROFINANCE BANK\"},{\"code\":\"090631\",\"name\":\"WRA MFB\"},{\"code\":\"100040\",\"name\":\"XPRESS WALLET\"},{\"code\":\"090124\",\"name\":\"XSLNCE MICROFINANCE BANK\"},{\"code\":\"090466\",\"name\":\"YCT MICROFINANCE BANK\"},{\"code\":\"090142\",\"name\":\"YES MICROFINANCE BANK\"},{\"code\":\"090252\",\"name\":\"YOBE MICROFINANCE BANK\"},{\"code\":\"050019\",\"name\":\"ZEDVANCE FINANCE LIMITED\"},{\"code\":\"090747\",\"name\":\"ZEFA MFB\"},{\"code\":\"000015\",\"name\":\"ZENITH BANK\"},{\"code\":\"288034\",\"name\":\"ZENITH BANK GHANA LIMITED\"},{\"code\":\"100034\",\"name\":\"ZENITH EASY WALLET\"},{\"code\":\"100018\",\"name\":\"ZENITH MOBILE\"},{\"code\":\"090504\",\"name\":\"ZIKORA MICROFINANCE BANK\"},{\"code\":\"090718\",\"name\":\"ZITRA MFB\"}]}\n"}],"_postman_id":"df80688e-b0ae-4fa0-a3f1-e907b069a222"},{"name":"Customer Transfer to Bank Account","id":"ce776329-e1a4-4940-87b9-b2e370aa809d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n\t\"amount\": 50,\r\n // \"reference\": \"38bDlOwxUmrDv3yzP46mZyiEaZWpYVcxMHLd\",\r\n\t\"sort_code\": \"000013\",\r\n \"narration\": \"Customer transfer\",\r\n\t\"account_number\": \"0167421242\",\r\n \"account_name\": \"Emmanuel Obagunwa\",\r\n \"customer_id\": \"7dfa317d-f2ba-4e27-b928-2825bf82087e\",\r\n \"metadata\": {\"key\": \"value\"}\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/transfers/bank/customer","description":"

Customer Bank Transfer

Endpoint: POST /v1/transfers/bank/customer

Description:
This endpoint allows a customer to initiate a transfer to a bank account. The customer can provide an optional reference. If the reference is not provided, a unique reference will be generated.

Request Body:

amount (float): The amount to be transferred.
\n
reference (string, optional): A unique reference for the transaction. If not provided, a new reference will be generated.
\n
sortCode (string): The sort code of the recipient's bank.
\n
narration (string): A brief description or message about the transfer.
\n
accountNumber (string): The bank account number of the recipient.
\n
accountName (string): The name of the account holder.
\n
customerId (string): The ID of the customer initiating the transfer.
\n
metadata (object, optional): Additional information regarding the transfer (e.g., custom key-value pairs).
\n
- key (string): A key for storing additional information.
  \n
- value (string): The value associated with the key.
  \n
\n

Response:

On success, returns a confirmation of the transfer with the transaction details and the reference.
\n
If the reference is provided and a transaction already exists with that reference, an error will be returned.
\n

Error Handling:

If the provided reference already exists, a 409 Conflict error will be returned.
\n
If any required parameter is missing or invalid, a 400 Bad Request error will be returned.
\n

Notes:

Ensure that the X-API-Key header is included for authentication:
\n
X-API-Key: {{API_KEY}}
\n

\n","urlObject":{"path":["transfers","bank","customer"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"45429de3-bc71-48ef-8f4f-a46970d5fe16","name":"Success Response","originalRequest":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n\t\"amount\": 50,\r\n // \"reference\": \"38bDlOwxUmrDv3yzP46mZyiEaZWpYVcxMHLd\",\r\n\t\"sortCode\": \"000013\",\r\n \"narration\": \"Customer transfer\",\r\n\t\"accountNumber\": \"0167421242\",\r\n \"accountName\": \"Emmanuel Obagunwa\",\r\n \"customerId\": \"0e72df4b-c0c1-4874-8f3d-d35ae5a6a60c\",\r\n \"metadata\": {\"key\": \"value\"}\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/transfers/bank/customer"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Date","value":"Fri, 28 Mar 2025 08:33:56 GMT"},{"key":"Content-Length","value":"923"},{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"You have successfully make a transfer\",\n \"data\": {\n \"id\": \"40cd2b51-e26d-42a7-b347-f9d181df58e2\",\n \"reference\": \"TXN-1743150834-d528cb706bcd4a68\",\n \"currency\": \"NGN\",\n \"environment\": \"SANDBOX\",\n \"balance_after\": 550,\n \"balance_before\": 600,\n \"merchant_id\": \"6f5c63ce-f525-4442-be11-a401658396d7\",\n \"metadata\": \"eyJ2YXQiOiAwLjc1LCAiYW1vdW50IjogNTAsICJjaGFyZ2VzIjogMTAsICJiYW5rTmFtZSI6ICJHVEJBTksgUExDIiwgInNvcnRDb2RlIjogIjAwMDAxMyIsICJuYXJyYXRpb24iOiAiQ3VzdG9tZXIgdHJhbnNmZXIiLCAiYWNjb3VudE5hbWUiOiAiRW1tYW51ZWwgT2JhZ3Vud2EiLCAidG90YWxBbW91bnQiOiA2MC43NSwgImFjY291bnROdW1iZXIiOiAiMDE2NzQyMTI0MiIsICJ3YWxsZXRBY2NvdW50TmFtZSI6ICJTYW1zb24gRWRpZSIsICJhZGRpdGlvbmFsTWV0YWRhdGEiOiB7ImtleSI6ICJ2YWx1ZSJ9fQ==\",\n \"amount\": 50,\n \"status\": \"success\",\n \"destination\": \"0167421242/000013\",\n \"description\": \"Transfer of NGN50.00 to Emmanuel Obagunwa (0167421242/GTBANK PLC)/100040250328083356422632670862\",\n \"type\": \"DEBIT\",\n \"category\": \"BANK_TRANSFER\"\n }\n}"}],"_postman_id":"ce776329-e1a4-4940-87b9-b2e370aa809d"},{"name":"Get Bank Account Details","id":"129fe090-1bbe-47dc-9292-19a6d7b79e9c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"account_number\": \"0218827273\",\r\n \"bank_code\": \"000013\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/transfers/account","urlObject":{"path":["transfers","account"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"bbe1914c-8ded-4b96-a27e-01ebf977c43e","name":"Success Response","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"account_number\": \"1234567890\",\r\n \"sort_code\": \"000013\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://api.finecore.co/v1/transfers/account"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin","uuid":"10017e41-5966-4179-b4e3-855098913aee"},{"key":"Date","value":"Thu, 13 Mar 2025 12:51:36 GMT","uuid":"95c1f0c9-b74a-40b1-b1af-bd995f2e977f"},{"key":"Content-Length","value":"160","uuid":"9c808a47-d6e0-43d7-8169-5272c581e8bf"},{"key":"Content-Type","value":"application/json","description":"","type":"text","uuid":"a711c5d8-60e0-4f7b-bc89-4c7c0085de03"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Successfully fetch account detail\",\n \"data\": {\n \"bankCode\": \"000013\",\n \"accountName\": \"USMAN JIBRIL MOHAMMED\",\n \"accountNumber\": \"1234567890\"\n }\n}"},{"id":"d989126b-bbbb-457a-a15b-3aa8a0e724e1","name":"Error Response","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"account_number\": \"1234567890\",\r\n \"sort_code\": \"000013\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/transfers/account"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin","uuid":"22ecd0b2-1525-47a3-bca8-b71c5bfe25bf"},{"key":"Date","value":"Thu, 13 Mar 2025 12:53:04 GMT","uuid":"3a750407-b09d-479b-936b-2a8c6b257dca"},{"key":"Content-Length","value":"69","uuid":"0db4f855-fd05-4441-9735-06c55892fe1f"},{"key":"Content-Type","value":"application/json","description":"","type":"text","uuid":"f85d19ba-89ea-4acb-917d-a90b4b7d9a0f"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"Unable to resolve account information.\"\n}"}],"_postman_id":"129fe090-1bbe-47dc-9292-19a6d7b79e9c"}],"id":"08608662-317a-4659-a05d-3b3a0a53d598","description":"

Bank Transfer API

Description:
This folder contains endpoints for handling bank transfers. It provides functionality for merchant and customer bank transfers, as well as retrieving a list of available banks and checking bank account details.

Endpoints:

Merchant Bank Transfer
\n
- URL: {{BASE_URL}}/transfers/bank
  \n
- Description: This endpoint is used by merchants to initiate a bank transfer.
  \n
- Method: POST
  \n
- Request Body:
  \n
  - Includes the necessary details to initiate a bank transfer (e.g., amount, account details, reference).
  \n
- Response:
  \n
  - On success, returns the transaction details and status of the bank transfer.
  \n
\n
List of Banks
\n
- URL: {{BASE_URL}}/transfers/banks
  \n
- Description: This endpoint returns a list of available banks for transfer purposes.
  \n
- Method: GET
  \n
- Response:
  \n
  - A list of banks that can be used for transfers, including their names and details.
  \n
\n
Get Bank Detail
\n
- URL: {{BASE_URL}}/transfers/account
  \n
- Description: This endpoint allows you to retrieve details of a bank account, given the account number and other necessary details.
  \n
- Method: GET
  \n
- Request Parameters:
  \n
  - account_number (string): The account number for which details are to be fetched.
  \n
- Response:
  \n
  - Returns the details of the bank account, including the bank name, account type, and more.
  \n
\n
Customer Bank Transfer
\n
- URL: {{BASE_URL}}/transfers/bank/customer
  \n
- Description: This endpoint is used by customers to initiate a bank transfer.
  \n
- Method: POST
  \n
- Request Body:
  \n
  - Includes the necessary details to initiate the bank transfer (e.g., amount, account details, reference).
  \n
- Response:
  \n
  - On success, returns the transaction details and status of the customer bank transfer.
  \n
\n

Common Request Headers:

X-API-Key: Authentication key to access the API.

\n","_postman_id":"08608662-317a-4659-a05d-3b3a0a53d598"},{"name":"Account","item":[{"name":"Create dynamic virtual account","id":"03c2df2d-fad7-4642-b496-ba6557409ddb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"amount\": 100.00,\r\n \"reference\": \"yofddearndcdss\",\r\n \"duration_in_minutes\": 30\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/accounts/dynamic","description":"

Create Dynamic Account

Endpoint: POST /v1/accounts/dynamic
\n
Description:
This endpoint generates a dynamic virtual account tied to a specific transaction. The account is temporary and will expire after the specified duration. It is primarily used for one-time payments.
\n
Request Headers:
\n
- X-API-Key: Your API key for authentication.
\n
Request Body:
{
\"amount\": 100.00,
\"reference\": \"yofddearndcdss\",
\"duration_in_minutes\": 30
}
\n
Body Parameters:
\n
- amount (number, required): The expected amount to be paid into the dynamic account.
  \n
- reference (string, optional): A unique identifier for the transaction. If not provided, one will be auto-generated.
  \n
- duration_in_minutes (integer, required): How long the account should stay active before expiration.
  \n
\n
Response:
\n
- Returns the dynamic account details including:
  \n
  - account_number
    \n
  - account_name
    \n
  - bank_name
    \n
  - expiration_time
    \n
  - reference
    \n
  \n
\n
Possible Status Codes:
\n
- 201 Created: Dynamic account successfully generated.
  \n
- 400 Bad Request: Invalid or missing input fields.
  \n
- 409 Conflict: Reference already exists.
  \n
- 500 Internal Server Error: An error occurred during account generation.
  \n
\n
Note:
\n
- This account is valid for a limited time only.
  \n
- It is recommended to monitor the expiration timestamp to ensure payment is received within the valid window.
  \n
\n

\n","urlObject":{"path":["accounts","dynamic"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"4758499d-d9a8-4f97-bc6d-a117ced1979c","name":"Create dynamic virtual account","originalRequest":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"amount\": 100.00,\r\n \"reference\": \"yofddeuyiarndcdss\",\r\n \"duration_in_minutes\": 30\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/accounts/dynamic"},"status":"Created","code":201,"_postman_previewlanguage":null,"header":[{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self' 'unsafe-inline' https://cdn.example.com;style-src 'self' 'unsafe-inline' https://fonts.googleapis.com;img-src 'self' data: https://*.example.com;font-src 'self' https://fonts.gstatic.com;connect-src 'self' https://api.example.com;frame-ancestors 'none';"},{"key":"Permissions-Policy","value":"geolocation=(), microphone=(), camera=()"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Fri, 26 Sep 2025 10:24:13 GMT"},{"key":"Content-Length","value":"281"},{"key":"Content-Type","value":"text/plain; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\"success\":true,\"message\":\"Virtual account created successfully\",\"data\":{\"amount\":100,\"reference\":\"yofddeuyiarndcdss\",\"expiration_time\":\"2025-09-26T10:54:11.7017025Z\",\"account_name\":\"Dynamic Test Account\",\"account_number\":\"4097553750\",\"bank_name\":\"FCMB MFB\",\"bank_code\":\"090409\"}}\n"}],"_postman_id":"03c2df2d-fad7-4642-b496-ba6557409ddb"},{"name":"Create static account","id":"3fa70879-389f-4bbd-8bfd-5fafc97f85fa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email_address\": \"gwanja@gmail.com\",\r\n \"first_name\": \"Liman\",\r\n \"last_name\": \"Dauda\",\r\n \"phone_number\": \"08092717412\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/accounts/static","description":"

Create Static Account

Endpoint: POST /v1/accounts/static
\n
Description:
This endpoint is used to create a static virtual account for a user. A static account is permanently associated with the user and can be used for receiving payments multiple times.
\n
Request Headers:
\n
- X-API-Key: Your API key for authentication.
\n
Body Parameters:
\n
email_address (string, required): The email of the user to whom the static account will be linked.
\n
first_name (string, required): The first name of the user.
\n
last_name (string, required): The last name of the user.
\n
phone_number (string, required): The user’s phone number.
\n
Response:
\n
Returns the details of the created static account including the account number, account name, and bank name.
\n
Possible Status Codes:
\n
201 Created: Static account successfully created.
\n
400 Bad Request: Missing or invalid fields in the request.
\n
409 Conflict: Account already exists with the provided email or phone number.
\n
500 Internal Server Error: A problem occurred while processing the request.
\n
Note:
The static account created can be used by the customer to receive funds repeatedly. It is uniquely tied to the user profile.
\n

\n","urlObject":{"path":["accounts","static"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"92744979-2743-4f63-96fe-23260ac64b56","name":"Create static account","originalRequest":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email_address\": \"fablecore.exe+1@gmail.com\",\r\n \"first_name\": \"Jibril\",\r\n \"last_name\": \"Mohammed\",\r\n \"phone_number\": \"08034074748\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/accounts/static"},"status":"Created","code":201,"_postman_previewlanguage":null,"header":[{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self' 'unsafe-inline' https://cdn.example.com;style-src 'self' 'unsafe-inline' https://fonts.googleapis.com;img-src 'self' data: https://*.example.com;font-src 'self' https://fonts.gstatic.com;connect-src 'self' https://api.example.com;frame-ancestors 'none';"},{"key":"Permissions-Policy","value":"geolocation=(), microphone=(), camera=()"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Fri, 26 Sep 2025 10:25:40 GMT"},{"key":"Content-Length","value":"199"},{"key":"Content-Type","value":"text/plain; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\"success\":true,\"message\":\"Virtual account created successfully\",\"data\":{\"account_name\":\"Jibril Mohammed\",\"account_number\":\"7582757982\",\"bank_name\":\"FCMB MFB\",\"bank_code\":\"090409\",\"currency\":\"NGN\"}}\n"}],"_postman_id":"3fa70879-389f-4bbd-8bfd-5fafc97f85fa"},{"name":"Get static virtual account details","id":"8ac7e266-340c-43a4-abe7-c5ddeabbce48","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"url":"{{BASE_URL}}/accounts/static/:account_number","description":"

Get Static Virtual Account Detail

Endpoint: GET /v1/accounts/static/:account_number
\n
Description:
Retrieves the details of a static virtual account using the account number. Useful for verifying the owner or status of a static account.
\n
Request Headers:
\n
- X-API-Key: Your API key for authentication.
\n
Path Parameter:
\n
- account_number (string, required): The static virtual account number to look up.
\n
Response:
\n
- Returns the static account details including:
  \n
  - account_number
    \n
  - account_name
    \n
  - bank_name
    \n
  - associated user information (e.g., email, phone number)
    \n
  \n
\n
Possible Status Codes:
\n
- 200 OK: Account details retrieved successfully.
  \n
- 404 Not Found: No static account found with the provided account number.
  \n
- 500 Internal Server Error: An error occurred while fetching the account details.
  \n
\n
Note:
\n
- This endpoint is read-only and can be used to verify existing virtual accounts by third-party systems or for customer service operations.
\n

\n","urlObject":{"path":["accounts","static",":account_number"],"host":["{{BASE_URL}}"],"query":[{"disabled":true,"key":"","value":null}],"variable":[{"type":"any","value":"","key":"account_number"}]}},"response":[{"id":"7ad77aba-3efa-4bd1-841d-596fe8b58fa8","name":"Get static virtual account details","originalRequest":{"method":"GET","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"url":{"raw":"{{BASE_URL}}/accounts/static/:account_number","host":["{{BASE_URL}}"],"path":["accounts","static",":account_number"],"query":[{"key":"","value":null,"type":"text","disabled":true}],"variable":[{"key":"account_number","value":"7582757982"}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self' 'unsafe-inline' https://cdn.example.com;style-src 'self' 'unsafe-inline' https://fonts.googleapis.com;img-src 'self' data: https://*.example.com;font-src 'self' https://fonts.gstatic.com;connect-src 'self' https://api.example.com;frame-ancestors 'none';"},{"key":"Permissions-Policy","value":"geolocation=(), microphone=(), camera=()"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Fri, 26 Sep 2025 10:27:36 GMT"},{"key":"Content-Length","value":"621"},{"key":"Content-Type","value":"text/plain; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\"success\":true,\"message\":\"Virtual account details retrieved successfully\",\"data\":{\"id\":\"7bf97187-104c-45f6-8245-5dd30fd9529b\",\"merchant_id\":\"1ed909ea-f561-4166-a8d8-50589e40ecc0\",\"environment\":\"SANDBOX\",\"currency\":\"NGN\",\"bank_name\":\"FCMB MFB\",\"bank_code\":\"090409\",\"account_name\":\"Jibril Mohammed\",\"account_number\":\"7582757982\",\"updated_at\":\"2025-09-26T10:25:38.53272Z\",\"created_at\":\"2025-09-26T10:25:38.53272Z\",\"booked_balance\":0,\"available_balance\":0,\"status\":\"ACTIVE\",\"updated\":false,\"user_id\":\"e4a36dcc-38d9-4973-9457-5db8cc126e0e\",\"account_type\":\"STATIC\",\"expiry_time\":null,\"account_category\":\"CUSTOMER\",\"tier\":\"\"}}\n"},{"id":"be5652e3-8ba6-428f-905b-bab7ae1c1579","name":"Get static virtual account details","originalRequest":{"method":"GET","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"url":{"raw":"{{BASE_URL}}/accounts/static/:account_number","host":["{{BASE_URL}}"],"path":["accounts","static",":account_number"],"query":[{"key":"","value":null,"type":"text","disabled":true}],"variable":[{"key":"account_number","value":"7582757982"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":null,"header":[{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self' 'unsafe-inline' https://cdn.example.com;style-src 'self' 'unsafe-inline' https://fonts.googleapis.com;img-src 'self' data: https://*.example.com;font-src 'self' https://fonts.gstatic.com;connect-src 'self' https://api.example.com;frame-ancestors 'none';"},{"key":"Permissions-Policy","value":"geolocation=(), microphone=(), camera=()"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Fri, 26 Sep 2025 10:33:29 GMT"},{"key":"Content-Length","value":"101"},{"key":"Content-Type","value":"text/plain; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\"success\":false,\"message\":\"account is closed - no operations can be performed on a closed account\"}\n"}],"_postman_id":"8ac7e266-340c-43a4-abe7-c5ddeabbce48"},{"name":"Get dynamic virtual account details","id":"29563fc2-a53f-4af3-8f2b-b7f0803c6891","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"url":"{{BASE_URL}}/accounts/dynamic/:account_number","description":"

Get Dynamic Virtual Account Detail

Endpoint: GET /v1/accounts/dynamic/:account_number
\n
Description:
Retrieves the details of a dynamic virtual account using the account number. This is useful for validating a temporary account created for one-time payments.
\n
Request Headers:
\n
- X-API-Key: Your API key for authentication.
\n
Path Parameter:
\n
- account_number (string, required): The dynamic virtual account number to retrieve.
\n
Response:
\n
- Returns details of the dynamic account including:
  \n
  - account_number
    \n
  - account_name
    \n
  - bank_name
    \n
  - expiration_time
    \n
  - reference
    \n
  - amount
    \n
  - status
    \n
  \n
\n
Possible Status Codes:
\n
- 200 OK: Account details successfully retrieved.
  \n
- 404 Not Found: No dynamic account exists with the provided account number.
  \n
- 410 Gone: Account has expired and is no longer active.
  \n
- 500 Internal Server Error: An unexpected error occurred while retrieving the account details.
  \n
\n
Note:
\n
- Dynamic accounts are time-bound. If the account has expired, the system may respond with a 410 Gone status.
\n

\n","urlObject":{"path":["accounts","dynamic",":account_number"],"host":["{{BASE_URL}}"],"query":[{"disabled":true,"key":"","value":null}],"variable":[{"id":"3e7dbcb4-0a49-4c25-97b9-473bd7d54f0b","type":"any","value":"","key":"account_number"}]}},"response":[{"id":"2912d581-4fea-45a4-9d17-3eec0d053450","name":"Get dynamic virtual account details","originalRequest":{"method":"GET","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"url":{"raw":"{{BASE_URL}}/accounts/dynamic/:account_number","host":["{{BASE_URL}}"],"path":["accounts","dynamic",":account_number"],"query":[{"key":"","value":null,"type":"text","disabled":true}],"variable":[{"key":"account_number","value":"4097553750"}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self' 'unsafe-inline' https://cdn.example.com;style-src 'self' 'unsafe-inline' https://fonts.googleapis.com;img-src 'self' data: https://*.example.com;font-src 'self' https://fonts.gstatic.com;connect-src 'self' https://api.example.com;frame-ancestors 'none';"},{"key":"Permissions-Policy","value":"geolocation=(), microphone=(), camera=()"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Fri, 26 Sep 2025 10:28:25 GMT"},{"key":"Content-Length","value":"620"},{"key":"Content-Type","value":"text/plain; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\"success\":true,\"message\":\"Virtual account details retrieved successfully\",\"data\":{\"id\":\"fbe211ec-90e1-4b8b-ab7f-81e56fe6d2e9\",\"merchant_id\":\"1ed909ea-f561-4166-a8d8-50589e40ecc0\",\"environment\":\"SANDBOX\",\"currency\":\"NGN\",\"bank_name\":\"FCMB MFB\",\"bank_code\":\"090409\",\"account_name\":\"Dynamic Test Account\",\"account_number\":\"4097553750\",\"updated_at\":\"2025-09-26T10:24:12.562202Z\",\"created_at\":\"2025-09-26T10:24:12.562202Z\",\"booked_balance\":0,\"available_balance\":0,\"status\":\"ACTIVE\",\"updated\":false,\"user_id\":null,\"account_type\":\"DYNAMIC\",\"expiry_time\":\"2025-09-26T10:54:11.701702Z\",\"account_category\":\"CUSTOMER\",\"tier\":\"\"}}\n"}],"_postman_id":"29563fc2-a53f-4af3-8f2b-b7f0803c6891"},{"name":"Close static virtual account","id":"5364f498-fb06-48ab-87be-63d1482cb4c6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"DELETE","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"account_number\": 7000026062,\r\n \"note\": \"for testing\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/accounts/static/close","description":"

Close Static Virtual Account

Endpoint: POST /v1/accounts/static/close
\n
Description:
Closes a static virtual account. This action disables the account, preventing any further transactions. Typically used when an account is no longer needed or needs to be deactivated for security reasons.
\n
Request Headers:
\n
- X-API-Key: Your API key for authentication.
\n
Request Body:
\n
- account_number (number, required): The static account number to be closed.
  \n
- note (string, optional): A remark or reason for closing the account.
  \n
\n
{ \"account_number\": 7000026062, \"note\": \"for testing\"}
\n

\n","urlObject":{"path":["accounts","static","close"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"8782c2c8-08bc-4186-8128-ffea3096ab39","name":"Close static virtual account","originalRequest":{"method":"DELETE","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"account_number\": 7582757982,\r\n \"note\": \"for testing\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/accounts/static/close"},"status":"Forbidden","code":403,"_postman_previewlanguage":null,"header":[{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self' 'unsafe-inline' https://cdn.example.com;style-src 'self' 'unsafe-inline' https://fonts.googleapis.com;img-src 'self' data: https://*.example.com;font-src 'self' https://fonts.gstatic.com;connect-src 'self' https://api.example.com;frame-ancestors 'none';"},{"key":"Permissions-Policy","value":"geolocation=(), microphone=(), camera=()"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Fri, 26 Sep 2025 10:33:54 GMT"},{"key":"Content-Length","value":"101"},{"key":"Content-Type","value":"text/plain; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\"success\":false,\"message\":\"account is closed - no operations can be performed on a closed account\"}\n"}],"_postman_id":"5364f498-fb06-48ab-87be-63d1482cb4c6"},{"name":"List accounts","id":"8ee5ebdb-5419-4641-b090-9730ca71888f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"url":"{{BASE_URL}}/accounts","description":"

List Virtual Accounts

Endpoint: GET /v1/accounts
\n
Description:
Retrieves a list of all virtual accounts (static and/or dynamic) associated with your API key. You can optionally filter the results by account type.
\n
Request Headers:
\n
- X-API-Key: Your API key for authentication.
\n
Query Parameters:
\n
- account_type (string, optional): Use STATIC to list only static accounts, or DYNAMIC to list only dynamic accounts.
\n
Examples:
\n
- List all accounts: GET /v1/accounts
  \n
- List only static accounts: GET /v1/accounts?account_type=STATIC
  \n
- List only dynamic accounts: GET /v1/accounts?account_type=DYNAMIC
  \n
\n
Response:
\n
- An array of account objects, each containing:
  \n
  - account_number
    \n
  - account_name
    \n
  - account_type (STATIC or DYNAMIC)
    \n
  - bank_name
    \n
  - status
    \n
  - reference (for dynamic accounts)
    \n
  - expiration_time (if applicable)
    \n
  \n
\n
Possible Status Codes:
\n
- 200 OK: Accounts retrieved successfully.
  \n
- 400 Bad Request: Invalid account_type parameter.
  \n
- 500 Internal Server Error: Failed to retrieve accounts.
  \n
\n
Note:
\n
- Pagination may be available depending on implementation. Consider checking for page and limit query parameters if supported.
\n

\n","urlObject":{"path":["accounts"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"75b1bab3-789a-4232-811d-c9f0b2793c0b","name":"Dynamic accounts success response","originalRequest":{"method":"GET","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"url":{"raw":"{{BASE_URL}}/accounts?account_type=DYNAMIC","host":["{{BASE_URL}}"],"path":["accounts"],"query":[{"key":"account_type","value":"DYNAMIC"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Date","value":"Sun, 27 Apr 2025 10:32:05 GMT"},{"key":"Content-Length","value":"563"},{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Accounts retrieved successfully\",\n \"data\": [\n {\n \"id\": \"6bcdc009-dbee-4000-b893-e4b2e7b9162a\",\n \"merchant_id\": \"d0c70a28-1023-484e-849f-3fb41cee743b\",\n \"environment\": \"SANDBOX\",\n \"currency\": \"NGN\",\n \"bank_name\": \"First City Monument Bank (FCMB)\",\n \"account_name\": \"Sandbox Account ONHKMF\",\n \"account_number\": \"9990012793\",\n \"account_type\": \"DYNAMIC\",\n \"account_category\": \"CUSTOMER\",\n \"status\": \"ACTIVE\",\n \"created_at\": \"2025-04-26T13:12:19.333674Z\",\n \"expiry_time\": \"2025-04-26T13:42:18.342752Z\",\n \"is_expired\": true\n }\n ],\n \"meta\": {\n \"page\": 1,\n \"limit\": 10,\n \"totalItems\": 1,\n \"totalPages\": 1\n }\n}"},{"id":"28ba64fd-f59b-4f41-bb10-475c74c63a94","name":"Static account success response","originalRequest":{"method":"GET","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"url":{"raw":"{{BASE_URL}}/accounts?account_type=STATIC","host":["{{BASE_URL}}"],"path":["accounts"],"query":[{"key":"account_type","value":"STATIC"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Date","value":"Sun, 27 Apr 2025 10:33:21 GMT"},{"key":"Content-Length","value":"925"},{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Accounts retrieved successfully\",\n \"data\": [\n {\n \"id\": \"76e9142c-12a1-4fdc-be18-80b4ff6a716a\",\n \"merchant_id\": \"d0c70a28-1023-484e-849f-3fb41cee743b\",\n \"environment\": \"SANDBOX\",\n \"currency\": \"NGN\",\n \"bank_name\": \"First City Monument Bank (FCMB)\",\n \"account_name\": \"Hassan Last\",\n \"account_number\": \"7000026062\",\n \"account_type\": \"STATIC\",\n \"account_category\": \"CUSTOMER\",\n \"status\": \"CLOSED\",\n \"created_at\": \"2025-04-26T14:36:45.015319Z\",\n \"expiry_time\": null,\n \"is_expired\": false\n },\n {\n \"id\": \"3be51c39-222d-433e-b35a-ade426f55b00\",\n \"merchant_id\": \"d0c70a28-1023-484e-849f-3fb41cee743b\",\n \"environment\": \"SANDBOX\",\n \"currency\": \"NGN\",\n \"bank_name\": \"First City Monument Bank (FCMB)\",\n \"account_name\": \"Hassan Last\",\n \"account_number\": \"7000025993\",\n \"account_type\": \"STATIC\",\n \"account_category\": \"CUSTOMER\",\n \"status\": \"ACTIVE\",\n \"created_at\": \"2025-04-26T13:45:26.211718Z\",\n \"expiry_time\": null,\n \"is_expired\": false\n }\n ],\n \"meta\": {\n \"page\": 1,\n \"limit\": 10,\n \"totalItems\": 2,\n \"totalPages\": 1\n }\n}"},{"id":"d26a5534-ba5f-4b39-950f-681008c2c666","name":"All account type success response","originalRequest":{"method":"GET","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"url":"{{BASE_URL}}/accounts"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Date","value":"Sun, 27 Apr 2025 10:35:12 GMT"},{"key":"Content-Length","value":"1359"},{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Accounts retrieved successfully\",\n \"data\": [\n {\n \"id\": \"76e9142c-12a1-4fdc-be18-80b4ff6a716a\",\n \"merchant_id\": \"d0c70a28-1023-484e-849f-3fb41cee743b\",\n \"environment\": \"SANDBOX\",\n \"currency\": \"NGN\",\n \"bank_name\": \"First City Monument Bank (FCMB)\",\n \"account_name\": \"Hassan Last\",\n \"account_number\": \"7000026062\",\n \"account_type\": \"STATIC\",\n \"account_category\": \"CUSTOMER\",\n \"status\": \"CLOSED\",\n \"created_at\": \"2025-04-26T14:36:45.015319Z\",\n \"expiry_time\": null,\n \"is_expired\": false\n },\n {\n \"id\": \"3be51c39-222d-433e-b35a-ade426f55b00\",\n \"merchant_id\": \"d0c70a28-1023-484e-849f-3fb41cee743b\",\n \"environment\": \"SANDBOX\",\n \"currency\": \"NGN\",\n \"bank_name\": \"First City Monument Bank (FCMB)\",\n \"account_name\": \"Hassan Last\",\n \"account_number\": \"7000025993\",\n \"account_type\": \"STATIC\",\n \"account_category\": \"CUSTOMER\",\n \"status\": \"ACTIVE\",\n \"created_at\": \"2025-04-26T13:45:26.211718Z\",\n \"expiry_time\": null,\n \"is_expired\": false\n },\n {\n \"id\": \"6bcdc009-dbee-4000-b893-e4b2e7b9162a\",\n \"merchant_id\": \"d0c70a28-1023-484e-849f-3fb41cee743b\",\n \"environment\": \"SANDBOX\",\n \"currency\": \"NGN\",\n \"bank_name\": \"First City Monument Bank (FCMB)\",\n \"account_name\": \"Sandbox Account ONHKMF\",\n \"account_number\": \"9990012793\",\n \"account_type\": \"DYNAMIC\",\n \"account_category\": \"CUSTOMER\",\n \"status\": \"ACTIVE\",\n \"created_at\": \"2025-04-26T13:12:19.333674Z\",\n \"expiry_time\": \"2025-04-26T13:42:18.342752Z\",\n \"is_expired\": true\n }\n ],\n \"meta\": {\n \"page\": 1,\n \"limit\": 10,\n \"totalItems\": 3,\n \"totalPages\": 1\n }\n}"}],"_postman_id":"8ee5ebdb-5419-4641-b090-9730ca71888f"}],"id":"4b73018b-0e13-47f3-9bc5-2bd518b290cd","description":"

Account Folder

This folder contains endpoints related to managing accounts. It includes functionality for creating accounts, fetching account details, updating account information, and performing other operations related to customer accounts. Below are the key endpoints available in this folder:

Create Account
\n
- Endpoint: POST /v1/accounts
  \n
- Description: This endpoint is used to create a new account for a customer.
  \n
- Request Body:
  \n
  - bvn (string): The customer's BVN (Bank Verification Number).
    \n
  - first_name (string): The first name of the customer.
    \n
  - last_name (string): The last name of the customer.
    \n
  - date_of_birth (string): The customer's date of birth (in the format DD-MM-YYYY).
    \n
  - phone_number (string): The customer's phone number.
    \n
  - email (string): The customer's email address.
    \n
  - address (string): The customer's physical address.
    \n
  \n
- Response:
  \n
  - Returns a success message with the account details.
  \n
\n
Fetch Static Account Details
\n
- Endpoint: GET /v1/accounts/static/:account_number
  \n
- Description: This endpoint fetches the account details for a specific customer.
  \n
- Path Parameters:
  \n
  - account_number (string): The account number of the customer whose account details are being fetched.
  \n
- Response:
  \n
  - Returns the account details of the specified customer.
  \n
\n
Fetch Dynamic Account Details
\n
- Endpoint: GET /v1/accounts/dynamic/:account_number
  \n
- Description: This endpoint fetches the account details for a specific customer.
  \n
- Path Parameters:
  \n
  - account_number (string): The account number of the customer whose account details are being fetched.
  \n
- Response:
  \n
  - Returns the account details of the specified customer.
  \n
\n
Close Account
\n
- Endpoint: DELETE /v1/accounts/:account_number
  \n
- Description: This endpoint is used to delete a customer account.
  \n
- Path Parameters:
  \n
  - account_number (string): The account number of the customer whose account is to be deleted.
  \n
- Response:
  \n
  - Returns a success message confirming that the account has been deleted.
  \n
\n

Error Handling:

For all endpoints, appropriate HTTP status codes will be returned for different scenarios, such as:
\n
- 400 Bad Request: Missing or invalid parameters.
  \n
- 404 Not Found: The specified account does not exist.
  \n
- 500 Internal Server Error: A problem occurred on the server.
  \n
\n

Notes:

Ensure that the X-API-Key header is included for authentication:
\n
X-API-Key: {{API_KEY}}
\n

\n","_postman_id":"4b73018b-0e13-47f3-9bc5-2bd518b290cd"},{"name":"Simulation","item":[{"name":"Simulate account and wallet","id":"64623549-12b2-4835-81bc-b4db6525d3ba","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"amount\": 10000.00,\r\n \"account_number\": \"4000034404\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/simulate","urlObject":{"path":["simulate"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"c0b15dfe-86e7-4da0-929b-4df9f1456026","name":"Simulate account and wallet","originalRequest":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"amount\": 10000.00,\r\n \"account_number\": \"4000034404\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/simulate"},"status":"OK","code":200,"_postman_previewlanguage":"plain","header":[{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self' 'unsafe-inline' https://cdn.example.com;style-src 'self' 'unsafe-inline' https://fonts.googleapis.com;img-src 'self' data: https://*.example.com;font-src 'self' https://fonts.gstatic.com;connect-src 'self' https://api.example.com;frame-ancestors 'none';"},{"key":"Permissions-Policy","value":"geolocation=(), microphone=(), camera=()"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Fri, 25 Jul 2025 22:40:31 GMT"},{"key":"Content-Length","value":"59"},{"key":"Content-Type","value":"text/plain; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\"success\":true,\"message\":\"Payment simulation successful\"}\n"}],"_postman_id":"64623549-12b2-4835-81bc-b4db6525d3ba"}],"id":"96ba224c-271f-4a46-9351-3bbc73335280","_postman_id":"96ba224c-271f-4a46-9351-3bbc73335280","description":""},{"name":"Payment Gateway","item":[{"name":"Card","item":[{"name":"Initiate Payment with card","id":"53d8f0e3-d8d1-4126-800b-0d299201bc8f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"amount\": 10000.00,\r\n \"currency\": \"NGN\",\r\n \"reference\": \"txn_20231201_001\",\r\n \"metadata\":{\r\n \"someData\": \"someData\"\r\n },\r\n \"card_details\": {\r\n \"pan\": \"5123450000000008\",\r\n \"expiry_date\": \"3901\",\r\n \"cvv\": \"100\",\r\n \"pin\": \"1111\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/payments/card","description":"

Starts a card payment. Depending on the card type, the transaction may require OTP or 3DS authentication.

\n","urlObject":{"path":["payments","card"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"c5bfd64c-02f1-401e-bc0d-d328ab2b6612","name":"Payment with card","originalRequest":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"amount\": 10000.00,\r\n \"currency\": \"NGN\",\r\n \"reference\": \"txn_20231201_0015\",\r\n \"metadata\":{\r\n \"someData\": \"someData\"\r\n },\r\n \"card_details\": {\r\n \"pan\": \"5123450000000008\",\r\n \"expiry_date\": \"3901\",\r\n \"cvv\": \"100\",\r\n \"pin\": \"1111\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/payments/card"},"status":"Created","code":201,"_postman_previewlanguage":null,"header":[{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self' 'unsafe-inline' https://cdn.example.com;style-src 'self' 'unsafe-inline' https://fonts.googleapis.com;img-src 'self' data: https://*.example.com;font-src 'self' https://fonts.gstatic.com;connect-src 'self' https://api.example.com;frame-ancestors 'none';"},{"key":"Permissions-Policy","value":"geolocation=(), microphone=(), camera=()"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Thu, 11 Sep 2025 14:54:15 GMT"},{"key":"Content-Length","value":"332"},{"key":"Content-Type","value":"text/plain; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\"success\":true,\"message\":\"A verification code has been sent to your registered mobile number:234805***1111\",\"data\":{\"transaction_reference\":\"txn_20231201_0015\",\"requires_authentication\":true,\"auth_type\":\"OTP\",\"message\":\"A verification code has been sent to your registered mobile number:234805***1111\",\"next_action\":\"submit_otp\"}}\n"},{"id":"6429c909-e2c7-4c96-9a67-fe29d3e9415f","name":"Payment with card (3D)","originalRequest":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"amount\": 10000.00,\r\n \"currency\": \"NGN\",\r\n \"reference\": \"txn_20231201_0029\",\r\n \"metadata\":{\r\n \"someData\": \"someData\"\r\n },\r\n \"device_information\": { \r\n \"httpBrowserLanguage\": \"en-US\",\r\n \"httpBrowserJavaEnabled\": true,\r\n \"httpBrowserJavaScriptEnabled\": true,\r\n \"httpBrowserColorDepth\": 24,\r\n \"httpBrowserScreenHeight\": 1203,\r\n \"httpBrowserScreenWidth\": 2138,\r\n \"httpBrowserTimeDifference\": \"\",\r\n \"userAgentBrowserValue\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/105.0.0.0 Safari/537.36\"\r\n },\r\n \"callback_url\": \"https://webhook.site/51db6bef-2c95-47ba-9612-fe9df449de46\",\r\n \"card_details\": {\r\n \"pan\": \"4000000000002503\",\r\n \"expiry_date\": \"5003\",\r\n \"cvv\": \"11\",\r\n \"pin\": \"1111\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/payments/card"},"status":"Created","code":201,"_postman_previewlanguage":null,"header":[{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self' 'unsafe-inline' https://cdn.example.com;style-src 'self' 'unsafe-inline' https://fonts.googleapis.com;img-src 'self' data: https://*.example.com;font-src 'self' https://fonts.gstatic.com;connect-src 'self' https://api.example.com;frame-ancestors 'none';"},{"key":"Permissions-Policy","value":"geolocation=(), microphone=(), camera=()"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Fri, 12 Sep 2025 13:43:08 GMT"},{"key":"Content-Length","value":"816"},{"key":"Content-Type","value":"text/plain; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\"success\":true,\"message\":\"Please complete the secure authentication process with your bank\",\"data\":{\"transaction_reference\":\"txn_20231201_0029\",\"requires_authentication\":true,\"auth_type\":\"3DS\",\"message\":\"Please complete the secure authentication process with your bank\",\"next_action\":\"redirect_3ds\",\"payment_id\":\"474982513\",\"bank_code\":\"058\",\"acs_url\":\"https://qa.interswitchng.com/collections/wibmosecure\",\"term_url\":\"http://localhost:6081/collections/api/v1/pay/wibmoCallBack\",\"md\":\"474982513\",\"jwt\":\"eyJ0aHJlZURTU2VydmVyVHJhbnNJRCI6IjRkMDVlYmY1LTJjYzMtNGIzNS05MDkyLWIyMmE0YzMxYTAxNyIsInRocmVlRFNNZXRob2ROb3RpZmljYXRpb25VUkwiOiJodHRwczovLzNkczItYXBpLTNkc3NlcnZlci1pbnRnLnBjLmVuc3RhZ2Utc2FzLmNvbS93cmFwcGVyYXBpL2Flcmlvbi8zZHNzL2VtdmNvL3BBcnEvMzg3MTQ1ZDQtMGM5MC00OTI0LWFiYTYtMmViMTMyNGZlOWE1In0=\",\"eci_flag\":\"07\"}}\n"}],"_postman_id":"53d8f0e3-d8d1-4126-800b-0d299201bc8f"},{"name":"Approve Card Payment","id":"25a60cd0-471a-4286-82cc-3505a697d165","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"otp\": \"123456\",\r\n \"transaction_reference\": \"txn_20231201_0020\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/payments/card/approve","description":"

Approves card payment using OTP received.

\n","urlObject":{"path":["payments","card","approve"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"c58fa88a-ce78-4af3-8242-22abf197a7e2","name":"Approve Card Payment With OTP","originalRequest":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"otp\": \"123456\",\r\n \"transaction_reference\": \"txn_20231201_0020\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/payments/card/approve"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Approved by Financial Institution\",\n \"data\": {\n \"transaction_reference\": \"txn_20231201_0020\",\n \"message\": \"Approved by Financial Institution\",\n \"status\": \"COMPLETED\",\n \"amount\": \"10000.00\"\n }\n}"},{"id":"fbb72ac3-fe83-44eb-94b1-28fbaedd7dd5","name":"Approve Card Payment With 3DS","originalRequest":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"transaction_reference\": \"txn_20231201_0032\",\r\n \"eci_flag\": \"07\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/payments/card/approve"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\r\n \"success\": true,\r\n \"message\": \"Approved by Financial Institution\",\r\n \"data\": {\r\n \"transaction_reference\": \"txn_20231201_0020\",\r\n \"message\": \"Approved by Financial Institution\",\r\n \"status\": \"COMPLETED\",\r\n \"amount\": \"10000.00\"\r\n }"}],"_postman_id":"25a60cd0-471a-4286-82cc-3505a697d165"},{"name":"Resend OTP For Payment With Card","id":"92f6f021-8c7f-4fa9-843e-7baaab4771b5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"transaction_reference\": \"txn_20231201_0024\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/payments/card/resend-otp","description":"

Resends OTP if the user did not receive it.

\n","urlObject":{"path":["payments","card","resend-otp"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"cc4ed135-9944-40fe-8d19-de3327e00a6d","name":"New Request","originalRequest":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"transaction_reference\": \"txn_20231201_0024\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/payments/card/resend-otp"},"status":"Created","code":201,"_postman_previewlanguage":null,"header":[{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self' 'unsafe-inline' https://cdn.example.com;style-src 'self' 'unsafe-inline' https://fonts.googleapis.com;img-src 'self' data: https://*.example.com;font-src 'self' https://fonts.gstatic.com;connect-src 'self' https://api.example.com;frame-ancestors 'none';"},{"key":"Permissions-Policy","value":"geolocation=(), microphone=(), camera=()"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Fri, 12 Sep 2025 08:18:53 GMT"},{"key":"Content-Length","value":"334"},{"key":"Content-Type","value":"text/plain; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\"success\":true,\"message\":\"A verification code has been sent to your registered mobile number: 234805***1111\",\"data\":{\"transaction_reference\":\"txn_20231201_0024\",\"requires_authentication\":true,\"auth_type\":\"OTP\",\"message\":\"A verification code has been sent to your registered mobile number: 234805***1111\",\"next_action\":\"submit_otp\"}}\n"}],"_postman_id":"92f6f021-8c7f-4fa9-843e-7baaab4771b5"}],"id":"903a9352-564f-4ed7-bab8-c83d1eba22dc","description":"

Handles payments using credit or debit cards. Supports normal OTP flow and 3D Secure (3DS) flow.

\n","_postman_id":"903a9352-564f-4ed7-bab8-c83d1eba22dc"},{"name":"USSD","item":[{"name":"Initiate Payment With USSD","id":"9c6b0411-cafd-4073-9755-8aa373b79fb0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"amount\": \"100\",\r\n \"bank_code\": \"GTB\",\r\n \"currency_code\": \"566\",\r\n \"transaction_reference\": \"TX1R69HAAEAEYVTD1UEY93O4\",\r\n \"sursurge\": 5,\r\n \"metadata\": {\r\n \"someData\": \"some kind of object\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/payments/ussd","description":"

Starts a USSD payment by generating a code for the user to dial.

\n","urlObject":{"path":["payments","ussd"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"32f6c6bc-d9c4-49fa-b9b8-464d6357278e","name":"Initiate Payment With USSD","originalRequest":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"amount\": \"10000\",\r\n \"bank_code\": \"GTB\",\r\n \"currency_code\": \"566\",\r\n \"transaction_reference\": \"bn12222z2aaz\",\r\n \"metadata\": {\r\n \"someData\": \"some kind of object\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/payments/ussd"},"status":"Created","code":201,"_postman_previewlanguage":null,"header":[{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self' 'unsafe-inline' https://cdn.example.com;style-src 'self' 'unsafe-inline' https://fonts.googleapis.com;img-src 'self' data: https://*.example.com;font-src 'self' https://fonts.gstatic.com;connect-src 'self' https://api.example.com;frame-ancestors 'none';"},{"key":"Permissions-Policy","value":"geolocation=(), microphone=(), camera=()"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Tue, 16 Sep 2025 16:10:19 GMT"},{"key":"Content-Length","value":"223"},{"key":"Content-Type","value":"text/plain; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\"success\":true,\"message\":\"USSD payment initiated\",\"data\":{\"bank_short_code\":\"*737*000*3865#\",\"default_short_code\":\"*322*419*051691201*3865#\",\"reference\":\"3865\",\"response_code\":\"00\",\"transaction_reference\":\"bn12222z2aaz\"}}\n"}],"_postman_id":"9c6b0411-cafd-4073-9755-8aa373b79fb0"},{"name":"Get USSD Banks","id":"f0f127d0-565a-4249-af6a-77e0b000bf09","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"amount\": 10000.00,\r\n \"currency\": \"NGN\",\r\n \"reference\": \"txn_20231201_001\",\r\n \"metadata\":{\r\n \"someData\": \"someData\"\r\n },\r\n \"card_details\": {\r\n \"pan\": \"5123450000000008\",\r\n \"expiry_date\": \"3901\",\r\n \"cvv\": \"100\",\r\n \"pin\": \"1111\"\r\n }\r\n}"},"url":"{{BASE_URL}}/payments/ussd/banks","urlObject":{"path":["payments","ussd","banks"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"9e2d7786-d016-4585-8b70-21b4da8b493b","name":"New Request","originalRequest":{"method":"GET","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"amount\": 10000.00,\r\n \"currency\": \"NGN\",\r\n \"reference\": \"txn_20231201_001\",\r\n \"metadata\":{\r\n \"someData\": \"someData\"\r\n },\r\n \"card_details\": {\r\n \"pan\": \"5123450000000008\",\r\n \"expiry_date\": \"3901\",\r\n \"cvv\": \"100\",\r\n \"pin\": \"1111\"\r\n }\r\n}"},"url":"{{BASE_URL}}/payments/ussd/banks"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self' 'unsafe-inline' https://cdn.example.com;style-src 'self' 'unsafe-inline' https://fonts.googleapis.com;img-src 'self' data: https://*.example.com;font-src 'self' https://fonts.gstatic.com;connect-src 'self' https://api.example.com;frame-ancestors 'none';"},{"key":"Permissions-Policy","value":"geolocation=(), microphone=(), camera=()"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Tue, 16 Sep 2025 17:35:30 GMT"},{"key":"Content-Length","value":"1105"},{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"USSD Banks successfully retrieved\",\n \"data\": [\n {\n \"cbn_code\": \"ABP\",\n \"code\": \"ABP\",\n \"name\": \"Access Bank\"\n },\n {\n \"cbn_code\": \"DBP\",\n \"code\": \"DBP\",\n \"name\": \"Diamond Bank\"\n },\n {\n \"cbn_code\": \"ECO\",\n \"code\": \"ECO\",\n \"name\": \"Ecobank\"\n },\n {\n \"cbn_code\": \"FBP\",\n \"code\": \"FBP\",\n \"name\": \"Fidelity Bank\"\n },\n {\n \"cbn_code\": \"SBP\",\n \"code\": \"SBP\",\n \"name\": \"First\"\n },\n {\n \"cbn_code\": \"FBN\",\n \"code\": \"FBN\",\n \"name\": \"First Bank\"\n },\n {\n \"cbn_code\": \"GTB\",\n \"code\": \"GTB\",\n \"name\": \"Guarantee Trust Bank\"\n },\n {\n \"cbn_code\": \"KSB\",\n \"code\": \"KSB\",\n \"name\": \"Keystone Bank\"\n },\n {\n \"cbn_code\": \"QUICKTELLER\",\n \"code\": \"QUICKTELLER\",\n \"name\": \"QUICKTELLER\"\n },\n {\n \"cbn_code\": \"SKYE\",\n \"code\": \"SKYE\",\n \"name\": \"Skye Bank\"\n },\n {\n \"cbn_code\": \"JAIZ\",\n \"code\": \"JAIZ\",\n \"name\": \"Test Bank\"\n },\n {\n \"cbn_code\": \"IBTC\",\n \"code\": \"IBTC\",\n \"name\": \"Test USSD\"\n },\n {\n \"cbn_code\": \"UBP\",\n \"code\": \"UBP\",\n \"name\": \"Test USSD\"\n },\n {\n \"cbn_code\": \"WEMA\",\n \"code\": \"WEMA\",\n \"name\": \"Test USSD\"\n },\n {\n \"cbn_code\": \"HBP\",\n \"code\": \"HBP\",\n \"name\": \"Test USSD\"\n },\n {\n \"cbn_code\": \"FCMB\",\n \"code\": \"FCMB\",\n \"name\": \"Test USSD\"\n },\n {\n \"cbn_code\": \"UBN\",\n \"code\": \"UBN\",\n \"name\": \"Union Bank\"\n },\n {\n \"cbn_code\": \"UBA\",\n \"code\": \"UBA\",\n \"name\": \"United Bank for Africa\"\n },\n {\n \"cbn_code\": \"ZIB\",\n \"code\": \"ZIB\",\n \"name\": \"Zenith Bank\"\n }\n ]\n}"}],"_postman_id":"f0f127d0-565a-4249-af6a-77e0b000bf09"},{"name":"Get USSD Bank By Code","id":"194236d5-6f4f-4212-8d18-75b4fe75fede","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-key","value":"{{X-API-Key}}","type":"text"}],"url":"{{BASE_URL}}/payments/ussd/banks/:code","urlObject":{"path":["payments","ussd","banks",":code"],"host":["{{BASE_URL}}"],"query":[],"variable":[{"type":"any","value":"HBP","key":"code"}]}},"response":[{"id":"cdfe8838-48d8-47a9-b1b3-760c3e03f763","name":"Get USSD Bank By Code","originalRequest":{"method":"GET","header":[{"key":"x-api-key","value":"{{X-API-Key}}","type":"text"}],"url":{"raw":"{{BASE_URL}}/payments/ussd/banks/:code","host":["{{BASE_URL}}"],"path":["payments","ussd","banks",":code"],"variable":[{"key":"code","value":"HBP"}]}},"status":"Created","code":201,"_postman_previewlanguage":null,"header":[{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self' 'unsafe-inline' https://cdn.example.com;style-src 'self' 'unsafe-inline' https://fonts.googleapis.com;img-src 'self' data: https://*.example.com;font-src 'self' https://fonts.gstatic.com;connect-src 'self' https://api.example.com;frame-ancestors 'none';"},{"key":"Permissions-Policy","value":"geolocation=(), microphone=(), camera=()"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Wed, 17 Sep 2025 08:49:15 GMT"},{"key":"Content-Length","value":"124"},{"key":"Content-Type","value":"text/plain; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\"success\":true,\"message\":\"USSD Bank successfully retrieved\",\"data\":{\"name\":\"Heritage Bank\",\"code\":\"HBP\",\"cbn_code\":\"HBP\"}}\n"}],"_postman_id":"194236d5-6f4f-4212-8d18-75b4fe75fede"}],"id":"5fe97991-757e-46dc-a26a-65435f9b78cd","description":"

Handles payments via USSD codes. This method allows users to pay without using cards, typically on mobile phones that support USSD.

\n","_postman_id":"5fe97991-757e-46dc-a26a-65435f9b78cd"},{"name":"Bank Transfer (dynamic virtual account)","item":[{"name":"Generate Virtual Account (Dynamic)","id":"33bc77a6-b4e1-4127-9dc9-1a8d497dc14c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"amount\": \"100\",\r\n \"currency_code\": \"566\",\r\n \"provider\": \"WEMA\", \r\n \"transaction_reference\": \"TX3XIW7WYY11QQQP97UJ22IJO270\",\r\n \"metadata\": {\r\n \"someData\": \"some kind of object\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/payments/virtual-account/generate","description":"

Generates a unique account number for a user to receive payments.

\n","urlObject":{"path":["payments","virtual-account","generate"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"0e1509af-9e89-41ac-887f-750b9da26336","name":"New Request","originalRequest":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"amount\": \"10000\",\r\n \"currency_code\": \"566\",\r\n \"provider\": \"WEMA\", // OPTIONAL\r\n \"transaction_reference\": \"bn1yy2222z2aAaz\",\r\n \"metadata\": {\r\n \"someData\": \"some kind of object\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/payments/vitual-acccount/generate"},"status":"Created","code":201,"_postman_previewlanguage":null,"header":[{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self' 'unsafe-inline' https://cdn.example.com;style-src 'self' 'unsafe-inline' https://fonts.googleapis.com;img-src 'self' data: https://*.example.com;font-src 'self' https://fonts.gstatic.com;connect-src 'self' https://api.example.com;frame-ancestors 'none';"},{"key":"Permissions-Policy","value":"geolocation=(), microphone=(), camera=()"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Thu, 18 Sep 2025 10:36:07 GMT"},{"key":"Content-Length","value":"284"},{"key":"Content-Type","value":"text/plain; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\"success\":true,\"message\":\"Virtual account created\",\"data\":{\"account_name\":\"Quickteller Business Payment\",\"account_number\":\"7610665773\",\"amount\":10000,\"bank_name\":\"Wema Bank\",\"provider\":\"WEMA\",\"response_code\":\"Z0\",\"transaction_reference\":\"bn1yy2222z2aAaz\",\"validity_period_mins\":30}}\n"}],"_postman_id":"33bc77a6-b4e1-4127-9dc9-1a8d497dc14c"}],"id":"58ceeeca-75e9-4115-b1f4-50cbe9281e7b","description":"

Handles bank transfer payments using dynamically generated account numbers. Each user gets a unique account to deposit funds.

\n","_postman_id":"58ceeeca-75e9-4115-b1f4-50cbe9281e7b"}],"id":"21eb1361-bd62-4f25-a243-886b3580e1c8","description":"

This API allows processing of payments via Card, USSD, and Bank Transfer (Dynamic Account). Each folder represents a payment method, with multiple endpoints for handling transactions, approvals, and verification.

Finecore Checkout Integration Guide

Overview

Finecore Checkout makes it easy for developers and businesses to accept payments through a simple, secure, and customizable modal — no complex setup required.

You can integrate it in minutes by embedding a single script and initializing the payment modal with your API key and transaction details.

Include Finecore Checkout Script

Copy and paste this script inside your HTML before the closing tag:

<script src=\"https://checkout.finecore.co/finecore_pay.js\"></script>\n\n

This script automatically attaches the FinecorePay object to your window.

\n\n

Add the following JavaScript code to your site or app:

<script>\n  function payWithFinecore() {\n    window.FinecorePay.open({\n      key: \"flk_xxxxxxxxxxxxxx\", // Replace with your Finecore public key\n      amount: 5000, // Amount in kobo (₦50.00)\n      reference: \"FC_\" + new Date().getTime(), // Unique transaction reference\n      metadata: {\n        name: \"John Doe\",\n        phone: \"+2348012345678\",\n        email: \"customer@example.com\",\n      },\n      onSuccess: function (response) {\n        console.log(\"Payment successful:\", response);\n        alert(\"Payment successful! Reference: \" + response.reference);\n      },\n      onClose: function () {\n        console.log(\"Payment modal closed.\");\n      },\n    });\n  }\n</script>\n\n

Add a Payment Button

<button onclick=\"payWithFinecore()\">Pay Now</button>\n\n

When the user clicks the Pay Now button, the Finecore Checkout modal opens, allowing them to complete payment using their preferred method.

How It Works

The FinecorePay script securely loads your payment modal.
\n
The modal connects to Finecore servers and processes payments via your provided key and reference.
\n
Once payment is completed, the onSuccess callback returns the transaction details.
\n
You can verify the payment on your backend using the reference ID.
\n

\n","_postman_id":"21eb1361-bd62-4f25-a243-886b3580e1c8"},{"name":"Identity","item":[{"name":"KYC","item":[{"name":"NIN Verification Match","id":"20d4d2b4-3c3a-43b7-8876-68e616202d96","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"},{"key":"","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"00000000000\",\r\n \"first_name\": \"John\",\r\n \"middle_name\": \"\",\r\n \"last_name\": \"Leo\",\r\n \"phone_number\": \"080624353539\",\r\n \"gender\": \"M\", // M OR F\r\n \"country\": \"NG\",\r\n \"date_of_birth\": \"\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/kyc/nin-verification/match","urlObject":{"path":["kyc","nin-verification","match"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"29458aea-43df-4dc6-9905-46d1af0e15a2","name":"NIN Verification Match","originalRequest":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"},{"key":"","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"00000000000\",\r\n \"first_name\": \"John\",\r\n \"middle_name\": \"\",\r\n \"last_name\": \"Leo\",\r\n \"phone_number\": \"080624353539\",\r\n \"gender\": \"M\", // M OR F\r\n \"country\": \"NG\",\r\n \"date_of_birth\": \"\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/kyc/nin-verification/match"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self' 'unsafe-inline' https://cdn.example.com;style-src 'self' 'unsafe-inline' https://fonts.googleapis.com;img-src 'self' data: https://*.example.com;font-src 'self' https://fonts.gstatic.com;connect-src 'self' https://api.example.com;frame-ancestors 'none';"},{"key":"Permissions-Policy","value":"geolocation=(), microphone=(), camera=()"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Wed, 20 Aug 2025 21:23:56 GMT"},{"key":"Content-Length","value":"368"},{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"nin verification details retrieved\",\n \"data\": {\n \"dob_verified\": \"exact_match\",\n \"gender_verified\": \"no_match\",\n \"id_number_verified\": \"exact_match\",\n \"id_type\": \"NIN\",\n \"id_verified\": \"partial_match\",\n \"names_verified\": \"partial_match\",\n \"phone_number_verified\": \"not_provided\",\n \"secondary_id_number_verified\": \"not_provided\",\n \"verification_status\": \"partial_match\"\n }\n}"}],"_postman_id":"20d4d2b4-3c3a-43b7-8876-68e616202d96"},{"name":"NIN Verification","id":"d9e4b81d-3987-4143-88d1-f226439a0820","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"00000000000\",\r\n \"first_name\": \"John\",\r\n \"middle_name\": \"\",\r\n \"last_name\": \"Leo\",\r\n \"phone_number\": \"080624353539\",\r\n \"gender\": \"M\", // M OR F\r\n \"country\": \"NG\",\r\n \"date_of_birth\": \"\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/kyc/nin-verification","urlObject":{"path":["kyc","nin-verification"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"d9e4b81d-3987-4143-88d1-f226439a0820"},{"name":"BVN Verification","id":"de115c48-9558-4ab2-abca-bf3b0bb87b53","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"country\": \"NG\",\r\n \"id_number\": \"00000000000\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/kyc/bvn-verification","urlObject":{"path":["kyc","bvn-verification"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"de115c48-9558-4ab2-abca-bf3b0bb87b53"},{"name":"BVN Verification Match","id":"49915cc0-6f55-4cc6-8803-6bb7b8be9e6e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"country\": \"NG\",\r\n \"id_number\": \"00000000000\"\r\n}"},"url":"{{BASE_URL}}/kyc/bvn-verification/match","urlObject":{"path":["kyc","bvn-verification","match"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"662d9a2b-21ea-44fd-8795-20ccd4632f49","name":"New Request","originalRequest":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"country\": \"NG\",\r\n \"id_number\": \"00000000000\"\r\n}"},"url":"{{BASE_URL}}/kyc/bvn-verification/match"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self' 'unsafe-inline' https://cdn.example.com;style-src 'self' 'unsafe-inline' https://fonts.googleapis.com;img-src 'self' data: https://*.example.com;font-src 'self' https://fonts.gstatic.com;connect-src 'self' https://api.example.com;frame-ancestors 'none';"},{"key":"Permissions-Policy","value":"geolocation=(), microphone=(), camera=()"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Wed, 20 Aug 2025 21:58:27 GMT"},{"key":"Content-Length","value":"369"},{"key":"Content-Type","value":"text/plain; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\"success\":true,\"message\":\"nin verification details retrieved\",\"data\":{\"dob_verified\":\"not_provided\",\"gender_verified\":\"not_provided\",\"id_number_verified\":\"exact_match\",\"id_type\":\"BVN\",\"id_verified\":\"no_match\",\"names_verified\":\"no_match\",\"phone_number_verified\":\"not_provided\",\"photo\":\"\",\"secondary_id_number_verified\":\"not_provided\",\"verification_status\":\"no_match\"}}\n"}],"_postman_id":"49915cc0-6f55-4cc6-8803-6bb7b8be9e6e"},{"name":"Voter ID Verification Match","id":"88b99109-7e87-4e7c-9154-4baf14879e94","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"},{"key":"","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"0000000000000000000\",\r\n \"first_name\": \"John\",\r\n \"middle_name\": \"\",\r\n \"last_name\": \"Leo\",\r\n \"phone_number\": \"080624353539\",\r\n \"gender\": \"M\", // M OR F\r\n \"country\": \"NG\",\r\n \"date_of_birth\": \"\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/kyc/voter-id-verification/match","urlObject":{"path":["kyc","voter-id-verification","match"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"ea5cbd7d-4049-41d7-b620-d3a2692f0935","name":"Voter ID Verification Match","originalRequest":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"},{"key":"","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"0000000000000000000\",\r\n \"first_name\": \"John\",\r\n \"middle_name\": \"\",\r\n \"last_name\": \"Leo\",\r\n \"phone_number\": \"080624353539\",\r\n \"gender\": \"M\", // M OR F\r\n \"country\": \"NG\",\r\n \"date_of_birth\": \"\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/kyc/voter-id-verification/match"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self' 'unsafe-inline' https://cdn.example.com;style-src 'self' 'unsafe-inline' https://fonts.googleapis.com;img-src 'self' data: https://*.example.com;font-src 'self' https://fonts.gstatic.com;connect-src 'self' https://api.example.com;frame-ancestors 'none';"},{"key":"Permissions-Policy","value":"geolocation=(), microphone=(), camera=()"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Wed, 20 Aug 2025 23:09:18 GMT"},{"key":"Content-Length","value":"385"},{"key":"Content-Type","value":"text/plain; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\"success\":true,\"message\":\"nin verification details retrieved\",\"data\":{\"dob_verified\":\"not_provided\",\"gender_verified\":\"exact_match\",\"id_number_verified\":\"exact_match\",\"id_type\":\"VOTERS_ID\",\"id_verified\":\"partial_match\",\"names_verified\":\"partial_match\",\"phone_number_verified\":\"no_match\",\"photo\":\"\",\"secondary_id_number_verified\":\"not_provided\",\"verification_status\":\"partial_match\"}}\n"}],"_postman_id":"88b99109-7e87-4e7c-9154-4baf14879e94"},{"name":"Voter ID Verification","id":"a446074a-3971-4342-b320-89d48e6decb2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"},{"key":"","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"0000000000000000000\",\r\n \"first_name\": \"John\",\r\n \"middle_name\": \"\",\r\n \"last_name\": \"Leo\",\r\n \"phone_number\": \"080624353539\",\r\n \"gender\": \"M\", // M OR F\r\n \"country\": \"NG\",\r\n \"date_of_birth\": \"\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/kyc/voter-id-verification","urlObject":{"path":["kyc","voter-id-verification"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"6489ce1c-baf9-40d6-b59a-dfb697396b9d","name":"Voter ID Verification Match Copy","originalRequest":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"},{"key":"","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"0000000000000000000\",\r\n \"first_name\": \"John\",\r\n \"middle_name\": \"\",\r\n \"last_name\": \"Leo\",\r\n \"phone_number\": \"080624353539\",\r\n \"gender\": \"M\", // M OR F\r\n \"country\": \"NG\",\r\n \"date_of_birth\": \"\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/kyc/voter-id-verification"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self' 'unsafe-inline' https://cdn.example.com;style-src 'self' 'unsafe-inline' https://fonts.googleapis.com;img-src 'self' data: https://*.example.com;font-src 'self' https://fonts.gstatic.com;connect-src 'self' https://api.example.com;frame-ancestors 'none';"},{"key":"Permissions-Policy","value":"geolocation=(), microphone=(), camera=()"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Wed, 20 Aug 2025 23:13:09 GMT"},{"key":"Content-Type","value":"text/plain; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\"success\":true,\"message\":\"kyc verification details retrieved\",\"data\":{\"dob_verified\":\"\",\"gender_verified\":\"\",\"id_number_verified\":\"\",\"id_type\":\"VOTER_ID\",\"id_verified\":\"\",\"names_verified\":\"\",\"phone_number_verified\":\"\",\"photo\":\"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\",\"secondary_id_number_verified\":\"\",\"verification_status\":\"exact_match\"}}\n"}],"_postman_id":"a446074a-3971-4342-b320-89d48e6decb2"},{"name":"Intl Passport Verification","id":"eff8126c-8434-4600-b031-140841d37888","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"},{"key":"","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_type\": \"INTERNATIONAL_PASSPORT\",\r\n \"id_number\": \"A10000001\",\r\n \"first_name\": \"John\",\r\n \"last_name\": \"Doe\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/kyc/intl-passport","urlObject":{"path":["kyc","intl-passport"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"eff8126c-8434-4600-b031-140841d37888"},{"name":"Phone Number Verification","id":"a221e51d-3087-490e-9218-0a7ccb59eaf7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"urlObject":{"query":[],"variable":[]},"url":""},"response":[],"_postman_id":"a221e51d-3087-490e-9218-0a7ccb59eaf7"}],"id":"b9875a70-f3c3-4e91-b209-332483185059","_postman_id":"b9875a70-f3c3-4e91-b209-332483185059","description":""},{"name":"KYB","item":[{"name":"Verify Business","id":"8a372416-3292-4cbc-86b6-b846bc0ee351","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"registration_number\": \"0000000\",\r\n \"registration_type\" : \"CORPORATE\" //Can only be one of CORPORATE,BUSINESS_NAME,TRUSTEES\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/kyb","urlObject":{"path":["kyb"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"65283134-131c-4305-a4c0-e3e16ac1a1e7","name":"New Request","originalRequest":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"registration_number\": \"0000000\",\r\n \"registration_type\" : \"CORPORATE\" //Can only be one of CORPORATE,BUSINESS_NAME,TRUSTEES\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/kyb"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self' 'unsafe-inline' https://cdn.example.com;style-src 'self' 'unsafe-inline' https://fonts.googleapis.com;img-src 'self' data: https://*.example.com;font-src 'self' https://fonts.gstatic.com;connect-src 'self' https://api.example.com;frame-ancestors 'none';"},{"key":"Permissions-Policy","value":"geolocation=(), microphone=(), camera=()"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Wed, 20 Aug 2025 22:23:02 GMT"},{"key":"Content-Length","value":"578"},{"key":"Content-Type","value":"text/plain; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\"success\":true,\"message\":\"business verification details retrieved\",\"data\":{\"address\":\"10, Workbox, Ojora Close, Victoria Island, Lagos\",\"authorized_shared_capital\":\"smile@smileidentity.com\",\"business_status\":\"ACTIVE\",\"company_type\":\"PRIVATE_COMPANY_LIMITED_BY_SHARES\",\"country\":\"Nigeria\",\"id_number\":\"0000000\",\"id_type\":\"BUSINESS_VERIFICATION\",\"industry\":\"Technology Solutions Company\",\"name\":\"SMILE IDENTITY NIGERIA LIMITED\",\"phone_no\":\"08000000000\",\"registration_date\":\"2016-01-28T16:06:22.003Z\",\"state\":\"LAGOS\",\"tax_id\":\"not_available\",\"verification_status\":\"exact_match\"}}\n"}],"_postman_id":"8a372416-3292-4cbc-86b6-b846bc0ee351"},{"name":"Verify Tax Information","id":"1d13f011-6b1a-4a8a-9a72-575ed5155ef1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"tax_number\": \"00000000-0000\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/kyb/tax","urlObject":{"path":["kyb","tax"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"c36eed95-df27-42ed-b39f-115013b8d53d","name":"New Request","originalRequest":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"tax_number\": \"00000000-0000\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/kyb/tax"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Content-Security-Policy","value":"default-src 'self';script-src 'self' 'unsafe-inline' https://cdn.example.com;style-src 'self' 'unsafe-inline' https://fonts.googleapis.com;img-src 'self' data: https://*.example.com;font-src 'self' https://fonts.gstatic.com;connect-src 'self' https://api.example.com;frame-ancestors 'none';"},{"key":"Permissions-Policy","value":"geolocation=(), microphone=(), camera=()"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Wed, 20 Aug 2025 22:45:29 GMT"},{"key":"Content-Length","value":"444"},{"key":"Content-Type","value":"text/plain; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\"success\":true,\"message\":\"tax verification details retrieved\",\"data\":{\"address\":\"N/A\",\"authorized_shared_capital\":\"smile@smileidentity.com\",\"business_status\":\"N/A\",\"company_type\":\"N/A\",\"country\":\"Nigeria\",\"id_number\":\"0000000\",\"id_type\":\"TAX_VERIFICATION\",\"industry\":\"N/A\",\"name\":\"SMILE IDENTITY LIMITED\",\"phone_no\":\"08000000000\",\"registration_date\":\"N/A\",\"state\":\"not_available\",\"tax_id\":\"00000000-0000\",\"verification_status\":\"exact_match\"}}\n"}],"_postman_id":"1d13f011-6b1a-4a8a-9a72-575ed5155ef1"}],"id":"3c7efdab-adf0-4656-b518-7c1b4efb3199","_postman_id":"3c7efdab-adf0-4656-b518-7c1b4efb3199","description":""}],"id":"f44f3708-f79a-4a7c-9923-0b0ee195882e","_postman_id":"f44f3708-f79a-4a7c-9923-0b0ee195882e","description":""},{"name":"Stablecoin","item":[{"name":"Transfers","item":[{"name":"Get Transfer Quote Requirement","id":"8c35a902-8a87-4f48-96ce-027973757a76","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/stablecoin/requirements/USDC-USD","description":"

Get Quote Requirement

The Get Quote Requirement defines the validation schema and rules for all quote requests before any pricing or exchange rate calculation is performed.

It ensures that every request entering the quote system is structurally valid, complete, and allowed under system rules.

Purpose

Define required and optional input fields for quote requests
\n
Validate request structure before processing
\n
Enforce business rules per transfer type
\n
Prevent invalid or unsupported quote requests
\n

Core Responsibilities

1. Input Schema Definition

Defines the required fields based on transfer context:

Source asset / currency
\n
Destination asset / currency
\n
Amount (source or destination-based)
\n
Transfer type (fiat ↔ stablecoin combinations)
\n
Destination method (bank, wallet, card)
\n
Country or region (for fiat rails)
\n
Customer and account identifiers (where required)
\n

2. Validation Rules

Asset/currency must be supported
\n
Required fields must be present per transfer type
\n
Amount must respect min/max limits
\n
Destination format must match method (bank, wallet, card, wallet address)
\n
Region-specific restrictions must be enforced
\n
Payment method must be valid for selected currency and rail
\n

3. Transfer-Type Rules

Fiat → Fiat: requires currencies + bank/card method + country
\n
Fiat → Stablecoin: requires fiat currency + stablecoin asset + wallet address
\n
Stablecoin → Fiat: requires stablecoin asset + fiat currency + bank account
\n
Stablecoin → Stablecoin: requires source + destination wallet addresses
\n

Summary

This layer acts as the strict validation contract for all quote requests before pricing begins.

\n","urlObject":{"path":["stablecoin","requirements","USDC-USD"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"8c35a902-8a87-4f48-96ce-027973757a76"},{"name":"Initiate Transfer","id":"7cfa5649-17f4-45d0-90f3-6dbcaae915ac","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"customer_id\": \"7dd66395-94e9-480f-b45e-16dd3a9a0714\",\r\n \"destination\": {\r\n \"beneficiary_info\": {\r\n \"beneficiary_address\": {\r\n \"city\": \"Abuja\",\r\n \"country\": \"NG\",\r\n \"postal_code\": \"900001\",\r\n \"state_province\": \"FCT\",\r\n \"street\": \"12 Ahmadu Bello Way\"\r\n },\r\n \"beneficiary_email\": \"jibrilmohammed39@gmail.com\",\r\n \"beneficiary_name\": \"Jibril Mohammed\"\r\n },\r\n \"is_self_transfer\": false,\r\n \"payout_instrument\": {\r\n \"phone_number\": \"0208953433\",\r\n \"network_provider\": \"VODAFONE\"\r\n \r\n },\r\n \"transfer_purpose\": \"SALARY\"\r\n },\r\n \"quote_id\": \"141a4682-7a16-4ea4-a220-7343f71fcead\",\r\n \"reference\": \"SALwQAqsqj1Y_qqNw0c1\",\r\n \"source\": {\r\n \"payment_instrument\": {\r\n \"account_number\": \"8034074748\",\r\n \"bank_code\": \"100004\"\r\n }\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/stablecoin/transfers/initiate","description":"

Initiate Transfer

The Initiate Transfer service is responsible for executing transfers after a quote has been validated and accepted.

It orchestrates the movement of funds across fiat rails, stablecoin networks, and internal ledger systems.

Responsibilities

Validate quote and transfer eligibility
\n
Initiate transfer processing
\n
Coordinate with blockchain and fiat providers
\n
Execute asset movement
\n
Track transfer lifecycle and status
\n
Handle retries and failure recovery
\n

Supported Transfer Types

Stablecoin → Stablecoin
\n
Stablecoin → Fiat
\n
Fiat → Stablecoin
\n
Fiat → Fiat
\n

Transfer Destinations

Supported destinations include:

Blockchain wallet addresses
\n
Local bank accounts
\n
Foreign currency bank accounts (USD only)
\n
Linked customer payment methods
\n

Supported Networks

Transfers may execute across supported blockchain networks such as:

Solana
\n
Ethereum
\n
Tron
\n

Availability depends on selected asset and provider support.

Foreign Currency Support

Foreign currency transfers currently support:

USD on-ramp only

\n","urlObject":{"path":["stablecoin","transfers","initiate"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"7cfa5649-17f4-45d0-90f3-6dbcaae915ac"},{"name":"Get Transfer Purposes","id":"deaa615a-8fa5-4e7a-a608-c1f1600bfec5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"description":"

Get Transfer Purposes

The Get Transfer Purposes service retrieves the list of supported transfer reasons or purposes available for a transaction.

These purposes are primarily used for compliance, regulatory reporting, and transaction classification.

Responsibilities

Retrieve supported transfer purposes
\n
Support compliance and AML workflows
\n
Validate transfer-purpose eligibility for specific routes
\n
Standardize transaction categorization
\n

Common Transfer Purposes

Examples may include:

Family support
\n
Salary payment
\n
Business payment
\n
Investment
\n
Savings
\n
Goods and services
\n
Education
\n
Medical expenses
\n

Available options may vary depending on:

Currency
\n
Country
\n
Transfer route
\n
Payment provider requirements
\n

Usage

Transfer purposes may be required for:

Fiat transfers
\n
Cross-border payments
\n
Foreign currency transactions
\n
Regulatory reporting flows
\n

Foreign Currency Support

Foreign currency-related transfer purposes currently apply to:

USD on-ramp flows only

\n","urlObject":{"query":[],"variable":[]},"url":""},"response":[{"id":"a873a75d-95ce-4de5-8ad5-a9ba378bc6a2","name":"Get Transfer Purposes","originalRequest":{"method":"GET","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":""},"url":"{{BASE_URL}}/stablecoin/transfers/transfer-purposes"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Permissions-Policy","value":"geolocation=(), microphone=(), camera=()"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Tue, 26 May 2026 23:47:39 GMT"},{"key":"Content-Length","value":"1572"},{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"transfer purposes retrieved successfully\",\n \"data\": [\n {\n \"value\": \"TRANSFER_TO_OWN_ACCOUNT\",\n \"label\": \"Transfer to own account\"\n },\n {\n \"value\": \"FAMILY_MAINTENANCE\",\n \"label\": \"Family maintenance\"\n },\n {\n \"value\": \"EDUCATION\",\n \"label\": \"Education\"\n },\n {\n \"value\": \"MEDICAL_TREATMENT\",\n \"label\": \"Medical treatment\"\n },\n {\n \"value\": \"HOTEL\",\n \"label\": \"Hotel\"\n },\n {\n \"value\": \"TRAVEL\",\n \"label\": \"Travel\"\n },\n {\n \"value\": \"REPAYMENT_OF_LOANS\",\n \"label\": \"Loan repayment\"\n },\n {\n \"value\": \"TAX_PAYMENT\",\n \"label\": \"Tax payment\"\n },\n {\n \"value\": \"PURCHASE_PROPERTY\",\n \"label\": \"Purchase property\"\n },\n {\n \"value\": \"PROPERTY_RENTAL\",\n \"label\": \"Property rental\"\n },\n {\n \"value\": \"INSURANCE_PREMIUM\",\n \"label\": \"Insurance premium\"\n },\n {\n \"value\": \"PRODUCT_INDEMNITY_INSURANCE\",\n \"label\": \"Product indemnity insurance\"\n },\n {\n \"value\": \"INSURANCE_CLAIMS\",\n \"label\": \"Insurance claims\"\n },\n {\n \"value\": \"MUTUAL_FUND_INVESTMENT\",\n \"label\": \"Mutual fund investment\"\n },\n {\n \"value\": \"INVESTMENT_SHARES\",\n \"label\": \"Investment shares\"\n },\n {\n \"value\": \"DONATIONS\",\n \"label\": \"Donations\"\n },\n {\n \"value\": \"SALARY\",\n \"label\": \"Salary\"\n },\n {\n \"value\": \"INFO_SERVICE\",\n \"label\": \"Information service\"\n },\n {\n \"value\": \"ADVERTISING\",\n \"label\": \"Advertising\"\n },\n {\n \"value\": \"ROYALTY_FEES\",\n \"label\": \"Royalty fees\"\n },\n {\n \"value\": \"BROKER_FEES\",\n \"label\": \"Broker fees\"\n },\n {\n \"value\": \"ADVISOR_FEES\",\n \"label\": \"Advisor fees\"\n },\n {\n \"value\": \"REPRESENTATIVE_EXPENSES\",\n \"label\": \"Representative expenses\"\n },\n {\n \"value\": \"CONSTRUCTION\",\n \"label\": \"Construction\"\n },\n {\n \"value\": \"TRANSPORTATION\",\n \"label\": \"Transportation\"\n },\n {\n \"value\": \"EXPORTED_GOODS\",\n \"label\": \"Exported goods\"\n },\n {\n \"value\": \"DELIVERY_FEES\",\n \"label\": \"Delivery fees\"\n },\n {\n \"value\": \"GENERAL_GOODS_OFFLINE\",\n \"label\": \"General goods (offline)\"\n }\n ]\n}"}],"_postman_id":"deaa615a-8fa5-4e7a-a608-c1f1600bfec5"},{"name":"Get Transfer Quote","event":[{"listen":"test","script":{"id":"9eb2ee9c-1035-4a09-aee0-72524d486e77","exec":["pm.environment.set(\"QUOTE_ID\", pm.response.json().data.quote_id);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"e7220052-cf4e-4e9f-ab76-9097a2eb5978","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"from_currency\": \"NGN\",\r\n \"to_currency\": \"USD\",\r\n \"from_amount\": 51000,\r\n \"network\": \"solana\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/stablecoin/quotes","description":"

Get Quote

The Get Quote service generates real-time pricing and conversion information for a validated transfer request.

It calculates exchange rates, estimated destination amounts, and applicable fees across fiat and stablecoin rails.

Responsibilities

Retrieve exchange rates
\n
Calculate destination amounts
\n
Apply FX spreads and fees
\n
Estimate network and processing costs
\n
Return time-bound pricing information
\n

Quote Information

A generated quote may include:

Source amount
\n
Destination amount
\n
Exchange rate
\n
Fee breakdown
\n
Transfer route
\n
Quote expiry time
\n

Supported Flows

Stablecoin → Stablecoin
\n
Stablecoin → Fiat
\n
Fiat → Stablecoin
\n
Fiat → Fiat
\n

Foreign Currency Support

Foreign currency pricing currently supports:

USD on-ramp only

\n","urlObject":{"path":["stablecoin","quotes"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"1cf9c460-e8c9-4f6c-9a5e-b95f6910d53b","name":"Get Transfer Quote","originalRequest":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"from_currency\": \"USDC\",\r\n \"to_currency\": \"NGN\",\r\n \"from_amount\": 10,\r\n \"network\": \"solana\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/stablecoin/quotes"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Permissions-Policy","value":"geolocation=(), microphone=(), camera=()","uuid":"4918d5fc-ed16-4f04-8626-0a7d821eb0e5"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin","uuid":"ec1d61b2-7a29-44a0-9eb0-e036375da6e9"},{"key":"Vary","value":"Origin","uuid":"03a46ac1-0df0-45da-b029-0b586d5e9ab0"},{"key":"X-Content-Type-Options","value":"nosniff","uuid":"7d5df3d6-9879-40d5-8dfd-ad4cea8358f1"},{"key":"X-Frame-Options","value":"DENY","uuid":"4deec60c-08b2-4829-96ef-914e95f90884"},{"key":"X-Xss-Protection","value":"1; mode=block","uuid":"749252b8-cae5-4232-8ce3-079eb4cba18b"},{"key":"Date","value":"Wed, 27 May 2026 00:30:37 GMT","uuid":"562e1b7e-9884-4804-8dc7-5a226ff64f04"},{"key":"Content-Length","value":"312","uuid":"05d6b544-596e-4f68-9623-580b320f3f83"},{"key":"Content-Type","value":"application/json","description":"","type":"text","uuid":"1cb304c9-1dc0-4487-81fd-8f3884c0ed6a"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Quote retrieved successfully\",\n \"data\": {\n \"quote_id\": \"9d7e8b3e-7bb5-455a-bf1c-68474af3212c\",\n \"from_currency\": \"USDC\",\n \"to_currency\": \"NGN\",\n \"from_amount\": \"10.00\",\n \"to_amount\": \"13651.6\",\n \"exchange_rate\": \"1365.16000000\",\n \"fee\": \"50.0\",\n \"corridor\": \"USDC-NGN\",\n \"chain\": \"solana\",\n \"expires_at\": 1779841867\n }\n}"},{"id":"d9be2b29-a797-465b-97c3-4c1898554abc","name":"Get Transfer Quote","originalRequest":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"from_currency\": \"USDC\",\r\n \"to_currency\": \"NGN\",\r\n \"from_amount\": 10,\r\n \"network\": \"solana\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/stablecoin/quotes"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Permissions-Policy","value":"geolocation=(), microphone=(), camera=()"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Wed, 27 May 2026 00:30:37 GMT"},{"key":"Content-Length","value":"312"},{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Quote retrieved successfully\",\n \"data\": {\n \"quote_id\": \"9d7e8b3e-7bb5-455a-bf1c-68474af3212c\",\n \"from_currency\": \"USDC\",\n \"to_currency\": \"NGN\",\n \"from_amount\": \"10.00\",\n \"to_amount\": \"13651.6\",\n \"exchange_rate\": \"1365.16000000\",\n \"fee\": \"50.0\",\n \"corridor\": \"USDC-NGN\",\n \"chain\": \"solana\",\n \"expires_at\": 1779841867\n }\n}"}],"_postman_id":"e7220052-cf4e-4e9f-ab76-9097a2eb5978"},{"name":"Verify Mobile Money OTP","id":"ad2a9e89-1113-4358-9fe4-1294d05cbd76","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"reference\": \"onra145yyp_q1ngn7112re3e_1gq01\",\r\n \"otp\": \"441d5109-c72b-4ff9-ba86-fe0d85803f03\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/stablecoin/transfers/ramp/verify-otp","description":"

Verify Mobile Money Transfer

The Verify Mobile Money Transfer endpoint is used to complete a GHS Mobile Money on-ramp transfer after it has been initiated.

It handles the final authorization step required by the mobile money provider, which may be either:

OTP verification, or
\n
PIN confirmation (prompted on the user’s mobile device, not submitted in the request body)
\n

Purpose

Complete a previously initiated Mobile Money transfer
\n
Handle provider-based authentication flow
\n
Finalize GHS on-ramp settlement
\n
Confirm user authorization securely
\n

Flow Overview

User initiates a Mobile Money transfer (GHS on-ramp)
\n
System returns:
\n
- reference
  \n
- next_step
  \n
\n
Provider determines verification method:
\n
- OTP → sent to user’s phone via SMS
  \n
- PIN → user is prompted on mobile device to enter PIN (not sent in API request)
  \n
\n
User completes verification using this endpoint
\n
Transfer is finalized or rejected based on provider response
\n

Request Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Description
`reference`	string	Yes	Unique transaction reference returned during initiation
`otp`	string	Conditional	OTP sent to the user’s phone (required only if `next_step = OTP`)

Important Behavior (PIN Flow)

If next_step = PIN:

The user is prompted directly on their mobile money app/device
\n
The PIN is NOT included in the API request
\n
The system only waits for provider confirmation after user enters PIN on device
\n

Next Step Values

The initiation response defines how verification is handled:

next_step = OTP
\n
- User must submit OTP in the request
\n
next_step = PIN
\n
- User confirms PIN on mobile device (no API field required)
\n

Example Request (OTP Flow)

```json
{
\"reference\": \"tx_ref_123456\",
\"otp\": \"839201\"
}

\n","urlObject":{"path":["stablecoin","transfers","ramp","verify-otp"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"ad2a9e89-1113-4358-9fe4-1294d05cbd76"},{"name":"Simulated Transfer","id":"7c66a258-b2c5-4c47-aff0-4e5876b42520","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"reference\": \"ac0q1QknKjF-20k26-0g0fe1\",\r\n \"action\": \"PENDING\" // PENDING, PAID, COMPLETED, \r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/stablecoin/transfers/simulate","description":"

Simulate Transfer

The Simulate Transfer endpoint is used to mock or test the lifecycle state changes of a transfer for internal testing, sandbox environments, or provider simulation flows.

It allows developers to manually trigger different transfer states using an existing transfer reference.

Purpose

Simulate transfer state transitions in non-production environments
\n
Test downstream systems (ledger, notifications, reconciliation)
\n
Validate integration flows without real money movement
\n
Support QA and development testing scenarios
\n

Request Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Description
`reference`	string	Yes	Unique transfer reference to simulate
`action`	string	Yes	Desired simulated transfer state

Supported Actions

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Action	Description
`PENDING`	Marks transfer as pending processing
`PAID`	Marks transfer as successfully paid by provider
`COMPLETED`	Marks transfer as fully completed and finalized

Example Request

```json
{
\"reference\": \"SALARY_JAN_a20E2yqcqsq2qsucq\",
\"action\": \"PAID\"
}

\n","urlObject":{"path":["stablecoin","transfers","simulate"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"7c66a258-b2c5-4c47-aff0-4e5876b42520"}],"id":"d842dc82-70d9-4675-ab0e-fc6928cbef6e","description":"

Transfers Folder

The Transfers folder contains the orchestration and execution layer for all fiat and stablecoin value movement within the platform.

It coordinates transfers across supported blockchain networks, fiat payment rails, liquidity providers, and internal ledger systems while ensuring compliance, validation, and reliable settlement.

The system supports:

Fiat → Stablecoin (On-ramp)
\n
Stablecoin → Fiat (Off-ramp)
\n
Stablecoin → Stablecoin (On-chain)
\n
Fiat → Fiat transfers
\n

Core Responsibilities

Quote validation and generation
\n
Transfer initiation and execution
\n
Stablecoin and fiat settlement coordination
\n
FX conversion and pricing
\n
Blockchain routing and confirmation tracking
\n
Bank and wallet destination validation
\n
Compliance and transfer-purpose enforcement
\n
Integration with payment providers and blockchain networks
\n

Supported Stablecoin Assets

Currently supported stablecoin assets include:

USDC
\n
USDT
\n
CNGN
\n

Availability depends on:

Selected blockchain network
\n
Transfer type
\n
Provider support
\n

Supported Fiat Currencies

Supported fiat currencies currently include:

NGN (Nigerian Naira)
\n
GHS (Ghanaian Cedi)
\n
USD
\n
EUR
\n
BRL
\n
MXN
\n
HKD
\n
CNY
\n
COP
\n
INR
\n
AED
\n
SGD
\n
JPY
\n
PHP
\n

Availability depends on:

Payment rail support
\n
Transfer route
\n
Region and provider restrictions
\n

Supported Local Payment Channels

Supported local fiat payment methods include:

Bank Transfer
\n
Mobile Money
\n
ACH
\n
Wire Transfer
\n
SEPA
\n
PIX
\n
SPEI
\n
CHATS
\n
InstaPay
\n
PesoNet
\n
RTP
\n
FedWire
\n

Availability varies by country and currency.

Supported Blockchain Networks

Supported blockchain networks currently include:

Ethereum
\n
Solana
\n
Polygon
\n
Avalanche
\n
Arbitrum
\n
Optimism
\n
Stellar
\n
Tron
\n
TON
\n
Base
\n
Celo
\n
BEP20
\n

Availability depends on the selected asset.

Foreign Currency Support

Foreign currency transfers currently support:

USD on-ramp flows
\n
USD wire payouts for selected regions
\n

Additional foreign currency support may depend on provider availability and payment rail compatibility.

Included Services

The Transfers folder includes:

Get Quote Requirement
\n
Get Quote
\n
Initiate Transfer
\n
Get Transfer Purposes
\n
Supported Assets & Currency Resolution
\n
Supported Chain Resolution
\n
Bank & Payment Method Management
\n

\n","_postman_id":"d842dc82-70d9-4675-ab0e-fc6928cbef6e"},{"name":"Customer","item":[{"name":"Create Customer","id":"bf1c1f7e-0676-432a-bc6b-6987845cebf5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"first_name\": \"JB\",\r\n \"last_name\": \"Wilcher\",\r\n \"email\": \"jb@gmail.com\",\r\n \"country_code\": \"US\",\r\n \"phone_number\": \"708-916-8440\",\r\n \"birth_date\": \"2002-06-30\",\r\n \"kyc_description\": \"US stablecoin customer\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/stablecoin/users","description":"

Create Customer

The Create Customer service is responsible for onboarding and registering a new customer within the platform.

It creates a unique customer identity that can be used across transfers, wallets, payment methods, stablecoin operations, and compliance workflows.

Responsibilities

Create a new customer profile
\n
Validate customer information before creation
\n
Enforce uniqueness constraints
\n
Initialize customer identity for downstream financial services
\n
Store KYC-related metadata for compliance workflows
\n

Request Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Description
`first_name`	string	Yes	Customer's first name
`last_name`	string	Yes	Customer's last name
`email`	string	Yes	Customer email address
`country_code`	string	Yes	ISO country code of the customer
`phone_number`	string	Yes	Customer phone number
`birth_date`	string (YYYY-MM-DD)	Yes	Customer date of birth
`kyc_description`	string	Yes	Description or purpose associated with customer KYC profile

Example Request

```json
{
\"first_name\": \"Krystal\",
\"last_name\": \"Wilcher\",
\"email\": \"big@gmail.com\",
\"country_code\": \"US\",
\"phone_number\": \"708-916-8499\",
\"birth_date\": \"2002-06-30\",
\"kyc_description\": \"US stablecoin customer\"
}

\n","urlObject":{"path":["stablecoin","users"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"66d46177-17d4-4177-a016-5b8008a38d59","name":"Create Customer","originalRequest":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"first_name\": \"John\",\r\n \"last_name\": \"Doe\",\r\n \"email\": \"john.doe@email.com\",\r\n \"country_code\": \"NG\",\r\n \"phone_number\": \"07011218383\",\r\n \"birth_date\": \"1990-01-01\",\r\n \"kyc_description\": \"Nigerian stablecoin customer\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/stablecoin/users"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Permissions-Policy","value":"geolocation=(), microphone=(), camera=()"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Mon, 04 May 2026 12:41:06 GMT"},{"key":"Content-Length","value":"368"},{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Customer created successfully\",\n \"data\": {\n \"id\": \"b5e19a50-6c47-4cad-803d-ac8db03c8c66\",\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"email\": \"some@email.co\",\n \"phone_number\": \"07011218383\",\n \"currency\": \"NGN\",\n \"currency_code\": \"US\",\n \"kyc_description\": \"\",\n \"environment\": \"SANDBOX\",\n \"created_at\": \"2026-05-04T13:41:04+01:00\",\n \"updated_at\": \"2026-05-04T13:41:04+01:00\"\n }\n}"},{"id":"548d60e0-cfe1-4a02-be83-6d45ae8016a1","name":"Create Customer","originalRequest":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"first_name\": \"Krystal\",\r\n \"last_name\": \"Wilcher\",\r\n \"email\": \"bigkr@gmail.com\",\r\n \"country_code\": \"US\",\r\n \"phone_number\": \"708-916-8499\",\r\n \"birth_date\": \"2002-06-30\",\r\n \"kyc_description\": \"US stablecoin customer\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/stablecoin/users"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Permissions-Policy","value":"geolocation=(), microphone=(), camera=()"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Sun, 24 May 2026 19:38:13 GMT"},{"key":"Content-Length","value":"727"},{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Customer created successfully\",\n \"data\": {\n \"id\": \"84640f62-0ba7-41ec-9832-fd9f2d3c34e8\",\n \"first_name\": \"Kstal\",\n \"last_name\": \"Wilcr\",\n \"email\": \"big@gmail.com\",\n \"phone_number\": \"+17089166699\",\n \"currency\": \"USD\",\n \"currency_code\": \"US\",\n \"kyc_description\": \"US stablecoin customer\",\n \"environment\": \"SANDBOX\",\n \"date_of_birth\": \"2002-06-30\",\n \"has_signed_agreement\": false,\n \"agreement_link\": \"https://harbor.owlpay.com/agreements?uuid=ag_Bi1vl2Gdf3u6X7wtuDlwRME1F73gjmSoHqsl1VHW\",\n \"verification_link\": \"https://harbor.owlpay.com/gokyc?expires=1779652091&hash=7868d3dac4abed1cfa2ed9b7561eb71ed2252421c5635b84ab47450dd68953f\",\n \"kyc_link\": \"\",\n \"created_at\": \"2026-05-24T20:38:05+01:00\",\n \"updated_at\": \"2026-05-24T20:38:05+01:00\"\n }\n}"}],"_postman_id":"bf1c1f7e-0676-432a-bc6b-6987845cebf5"},{"name":"Fetch Customer","id":"94313df1-b03f-42bb-9586-285181a7ac7d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"url":"{{BASE_URL}}/stablecoin/users/:customer_id","urlObject":{"path":["stablecoin","users",":customer_id"],"host":["{{BASE_URL}}"],"query":[],"variable":[{"type":"any","value":"b5e19a50-6c47-4cad-803d-ac8db03c8c66","key":"customer_id"}]}},"response":[{"id":"6dd35864-ff28-4394-8d75-9aa71cb60897","name":"Fetch Customer","originalRequest":{"method":"GET","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"url":{"raw":"{{BASE_URL}}/stablecoin/users/:customer_id","host":["{{BASE_URL}}"],"path":["stablecoin","users",":customer_id"],"variable":[{"key":"customer_id","value":"b5e19a50-6c47-4cad-803d-ac8db03c8c66"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Permissions-Policy","value":"geolocation=(), microphone=(), camera=()"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Thu, 28 May 2026 21:20:11 GMT"},{"key":"Content-Length","value":"339"},{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"customer retrieved successfully\",\n \"data\": {\n \"id\": \"b5e19a50-6c47-4cad-803d-ac8db03c8c66\",\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"email\": \"some@email.co\",\n \"phone_number\": \"07011218383\",\n \"environment\": \"SANDBOX\",\n \"date_of_birth\": null,\n \"country_code\": null,\n \"currency\": \"NGN\",\n \"kyc_description\": null,\n \"has_signed_agreement\": false\n }\n}"}],"_postman_id":"94313df1-b03f-42bb-9586-285181a7ac7d"}],"id":"3eca7229-c6d0-44ef-a2f2-33166c5256d9","description":"

Customer Folder

The Customer folder contains all services responsible for managing customer identity, onboarding, and profile data within the platform.

It acts as the core identity and compliance layer, ensuring every user interacting with financial services is properly registered, validated, and linked to required regulatory workflows.

Core Responsibilities

Customer onboarding and identity creation
\n
Customer profile storage and retrieval
\n
Extended customer details management
\n
Compliance and KYC enforcement
\n
Linking customers to financial services (transfers, wallets, cards, bank accounts)
\n
Managing customer lifecycle and status
\n

Important Compliance Rule (Foreign Currency Flow)

For foreign currency customers, the system enforces additional compliance requirements:

The customer must undergo KYC verification
\n
The customer must accept a mandatory agreement
\n
The agreement URL is returned after customer creation
\n
The customer must accept the agreement before being allowed to perform foreign currency operations (e.g. USD on-ramp/off-ramp flows)
\n

Included Services

The Customer folder includes:

Create Customer
\n
Fetch Customer
\n
Fetch Customer Details
\n
Customer validation utilities
\n

Behavior Notes

If a customer is involved in foreign currency operations, the system automatically triggers KYC requirements
\n
The agreement URL returned during creation is mandatory for onboarding completion
\n
Failure to accept the agreement blocks access to foreign currency transfer features
\n

Summary

The Customer folder is the identity and compliance gateway for the platform.

It ensures:

Every user is properly registered
\n
Foreign currency users complete KYC
\n
Required agreements are accepted before enabling regulated financial operations
\n

\n","_postman_id":"3eca7229-c6d0-44ef-a2f2-33166c5256d9"},{"name":"Bank Accounts / Cards","item":[{"name":"Link Customer Card","id":"fe6c7389-7d7c-47a3-8a4f-21df7793c899","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"customer_id\": \"75c9a798-c6f3-4aa5-85db-81c42dace51c\",\r\n \"redirect_url\": {\r\n \"success\": \"https://success.com/card/success\",\r\n \"failed\": \"https://failed.com/card/failed\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/stablecoin/cards/link","description":"

Link Card

The Link Card service allows customers to attach a debit or credit card to their profile for fiat funding and payment operations.

It enables card-based deposits and, where supported, withdrawals through integrated payment providers.

Responsibilities

Link customer card to account
\n
Validate card details with payment provider
\n
Tokenize and securely store card references
\n
Enable card-based fiat transactions
\n
Support recurring or one-time payments
\n

Required Inputs

Redirect URL
\n
Customer ID
\n

Validation Rules

Card must pass provider validation (auth/tokenization)
\n
Card must be supported in the customer’s region
\n
Expiry date must be valid
\n
Customer must be active and verified where required
\n

Supported Use Cases

Fiat deposits
\n
Fiat on-ramp (where enabled)
\n
Recurring payments
\n
Wallet funding
\n

Summary

This service securely links a customer’s card for use in fiat payment flows within the platform.

\n","urlObject":{"path":["stablecoin","cards","link"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"b09b4484-0356-4fd5-bb95-b7f6fbdf415f","name":"Link Customer Card","originalRequest":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"customer_id\": \"186f303f-ea47-468b-bb51-ed4f166160ee\",\r\n \"redirect_url\": {\r\n \"success\": \"https://yourapp.com/card/success\",\r\n \"failed\": \"https://yourapp.com/card/failed\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/stablecoin/cards/link"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Permissions-Policy","value":"geolocation=(), microphone=(), camera=()"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Sun, 24 May 2026 00:46:49 GMT"},{"key":"Content-Length","value":"849"},{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Card linked successfully\",\n \"data\": {\n \"card_id\": \"card_L6Gb43Wpjr7hwlUZL1y7lmqW2kTC5LqUvWlyVJW5\",\n \"status\": \"PENDING\",\n \"enabled\": false,\n \"restricted\": false,\n \"url\": \"https://link-sandbox.owlpay.com/crb/card/iframe?encoded=eyJpZnJhbWVfc3JjIjoiaHR0cHM6XC9cL3AycGNyZWRpdGNhcmRpZnJhbWVzYW5kYm94LmNyYmNvcy5jb21cLz9jcmVhdGVkQXQ9MjAyNi0wNS0yM1QyMDo0Njo0OS44Njc1NDY1WiZkb21haW49aHR0cHM6XC9cL2xpbmstc2FuZGJveC5vd2xwYXkuY29tJmV4cGlyZXNBdD0yMDI2LTA1LTIzVDIwOjUxOjQ5Ljg2NzU0NjVaJm90Y0lkPTliNzIxZGRmLTVmMGMtNGE2OC1hNWRiLTRlZDEwOWZiNWM1NiZ0ZW1wbGF0ZUlkPWMzMzYwYWJmLWY1N2EtNDk1Yy1kNGQzLTA4ZGU3YTg5ZDk0NSZmaXJzdEFuZExhc3ROYW1lUHJvdmlkZWQ9ZmFsc2UiLCJyZWRpcmVjdF9zdWNjZXNzIjoiaHR0cHM6XC9cL3lvdXJhcHAuY29tXC9jYXJkXC9zdWNjZXNzIiwicmVkaXJlY3RfZmFpbGVkIjoiaHR0cHM6XC9cL3lvdXJhcHAuY29tXC9jYXJkXC9mYWlsZWQifQ%3D%3D\",\n \"created_at\": \"2026-05-24T00:46:49+00:00\"\n }\n}"}],"_postman_id":"fe6c7389-7d7c-47a3-8a4f-21df7793c899"},{"name":"List Customer Card","id":"6196b5c9-dc65-43ae-ba5f-186e8ba9ef22","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"description":"

List Customer Cards

The List Customer Cards service retrieves all cards linked to a customer profile.

It provides visibility into active, inactive, or restricted card payment methods associated with the customer.

Responsibilities

Retrieve all cards linked to a customer
\n
Provide card metadata for display and selection
\n
Support payment method selection during transfers
\n
Indicate card status (active, inactive, failed, restricted)
\n

Returned Information

Card identifier (tokenized reference)
\n
Card type (debit/credit)
\n
Card brand (e.g. Visa, Mastercard)
\n
Expiry date (masked)
\n
Card status
\n
Linked customer ID
\n

Validation Rules

Customer must exist
\n
Customer must have linked cards
\n
Access must be authorized
\n

Summary

This service provides a list of all customer-linked cards for use in fiat payment flows.

\n","urlObject":{"query":[],"variable":[]},"url":""},"response":[],"_postman_id":"6196b5c9-dc65-43ae-ba5f-186e8ba9ef22"},{"name":"Get List of Banks","id":"5efc4b91-88ec-4b6f-95a7-0d4110672e81","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"url":"{{BASE_URL}}/stablecoin/transfers/banks/list/:country","description":"

Get List of Banks (Local Currency)

The Get List of Banks service retrieves all supported banks for local fiat currency transactions.

It is used to validate bank account details and enable payout routing within supported countries.

Responsibilities

Retrieve list of supported banks per country or currency
\n
Support bank selection during account linking
\n
Enable validation of bank codes and names
\n
Provide banking metadata for fiat transfer routing
\n

Supported Regions

Nigeria (NGN)
\n
Ghana (GHS)
\n

Additional regions may be supported depending on provider availability.

Returned Information

Bank name
\n
Bank code
\n
Country
\n
Supported currency
\n
Bank identifier for routing
\n

Usage

Used for:

Linking bank accounts
\n
Validating beneficiary details
\n
Fiat payout processing
\n
Transfer routing selection
\n

Summary

This service provides the authoritative list of supported banks for local currency fiat operations within the platform.

\n","urlObject":{"path":["stablecoin","transfers","banks","list",":country"],"host":["{{BASE_URL}}"],"query":[],"variable":[{"type":"any","value":"GH","key":"country"}]}},"response":[{"id":"07e75738-5f35-46fa-b231-13841bbcf112","name":"Get List of Banks (NG)","originalRequest":{"method":"GET","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"url":{"raw":"{{BASE_URL}}/stablecoin/transfers/banks/list/:country","host":["{{BASE_URL}}"],"path":["stablecoin","transfers","banks","list",":country"],"variable":[{"key":"country","value":"NG"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Permissions-Policy","value":"geolocation=(), microphone=(), camera=()"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Date","value":"Mon, 04 May 2026 13:50:51 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"banks retrieved successfully\",\n \"data\": [\n {\n \"code\": \"120001\",\n \"name\": \"9 Payment Service Bank\"\n },\n {\n \"code\": \"090270\",\n \"name\": \"AB Microfinance Bank\"\n },\n {\n \"code\": \"070010\",\n \"name\": \"Abbey Mortgage Bank\"\n }\n ]\n}"},{"id":"e9c60113-1eca-479e-b76b-33513580d89d","name":"Get List of Banks (GH)","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{BASE_URL}}/stablecoin/transfers/banks/list/:country","host":["{{BASE_URL}}"],"path":["stablecoin","transfers","banks","list",":country"],"variable":[{"key":"country","value":"GH"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"banks retrieved successfully\",\n \"data\": [\n {\n \"code\": \"0009\",\n \"name\": \"TIGO\"\n },\n {\n \"code\": \"0006\",\n \"name\": \"VODAFONE\"\n },\n {\n \"code\": \"0004\",\n \"name\": \"MTN\"\n },\n {\n \"code\": \"0005\",\n \"name\": \"AIRTEL\"\n }\n ]\n}"}],"_postman_id":"5efc4b91-88ec-4b6f-95a7-0d4110672e81"},{"name":"Link Bank Account","id":"bc07caf2-bf4a-43df-80f7-2ef362b801a2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{X-API-Key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"customer_id\": \"7dd66395-94e9-480f-b45e-16dd3a9a0714\",\r\n \"redirect_url\": {\r\n \"success\": \"https://yourapp.com/success\",\r\n \"failed\": \"https://yourapp.com/failed\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/stablecoin/transfers/banks/link","description":"

Link Bank Account

The Link Bank Account service allows customers to attach a bank account to their profile for fiat payouts and deposits.

It enables the system to route funds directly to supported banking networks across local and international rails.

Responsibilities

Link a bank account to a customer profile
\n
Validate bank details before saving
\n
Support local and foreign bank account linking
\n
Enable payout routing for fiat transfers
\n
Store bank metadata for future transactions
\n

Required Inputs

Redirect URL
\n
Customer ID
\n

Validation Rules

Bank must be supported in the selected region
\n
Account number must follow country-specific format rules
\n
Account must be valid and reachable via provider rails
\n
Customer must exist and be active
\n
Currency must be supported for bank linkage
\n

Supported Currency Rules

Local currencies (e.g. NGN, GHS) supported via local banks
\n
Foreign currency support is limited to USD onboarding only
\n

Summary

This service links a customer to a bank account, enabling fiat payouts and deposits through supported banking rails.

\n","urlObject":{"path":["stablecoin","transfers","banks","link"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"bc07caf2-bf4a-43df-80f7-2ef362b801a2"}],"id":"fe04643d-8f1a-4a02-abd6-4ccd222d5547","description":"

Bank Accounts & Cards Folder

The Bank Accounts & Cards folder manages all customer-linked payment instruments used for fiat transactions within the platform.

It provides the infrastructure for linking, retrieving, and managing bank accounts and cards, enabling seamless fiat deposits, payouts, and transfer operations.

This folder primarily supports fiat rails, including local currency payments and foreign currency (USD) onboarding flows.

Core Responsibilities

Linking customer bank accounts
\n
Linking customer debit/credit cards
\n
Managing and storing customer payment instruments
\n
Retrieving linked payment methods for transactions
\n
Fetching supported banks for local fiat rails
\n
Enabling payout and deposit routing through fiat providers
\n
Ensuring validation and compliance of payment methods
\n

Supported Use Cases

Fiat → Fiat transfers
\n
Fiat → Stablecoin on-ramp
\n
Stablecoin → Fiat off-ramp
\n
Local currency payouts (NGN, GHS, etc.)
\n
Foreign currency onboarding (USD only)
\n

Supported Rails

Local bank transfers (country-specific)
\n
Card payments (where enabled)
\n
USD bank onboarding (foreign currency support)
\n
Provider-based fiat rails (ACH, SEPA, etc. depending on region)
\n

Summary

The Bank Accounts & Cards folder is the fiat payment instrument layer, responsible for managing all customer-linked funding and payout methods across supported fiat currencies and regions.

\n","_postman_id":"fe04643d-8f1a-4a02-abd6-4ccd222d5547"},{"name":"Wallet","item":[{"name":"Create Wallet","id":"581a504b-b5c3-47fa-b9df-fa706c53b801","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"urlObject":{"query":[],"variable":[]},"url":""},"response":[],"_postman_id":"581a504b-b5c3-47fa-b9df-fa706c53b801"},{"name":"Get Wallet Balance","id":"a3007711-6984-4638-b8ce-13897ba621b3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"urlObject":{"query":[],"variable":[]},"url":""},"response":[],"_postman_id":"a3007711-6984-4638-b8ce-13897ba621b3"}],"id":"9d30b0ee-9532-484e-92dd-49c90f5cb178","_postman_id":"9d30b0ee-9532-484e-92dd-49c90f5cb178","description":""}],"id":"d58784fe-e7e9-4cea-a8fe-4f2e64c91710","description":"

Stablecoin APIs

This folder contains all endpoints related to stablecoin operations on the platform. It supports blockchain-based financial transactions, enabling users and merchants to send, receive, store, and manage stablecoin assets seamlessly.

What is included in this folder

Wallet creation and management
\n
Stablecoin deposits and withdrawals
\n
Internal and external transfers
\n
Balance and transaction history retrieval
\n
Blockchain transaction status tracking
\n
Address generation and validation (where applicable)
\n

Purpose

The Stablecoin module enables fast, secure, and programmable digital asset movement while maintaining a stable value equivalent to fiat currencies. It is designed for cross-border payments, treasury operations, and digital asset settlement flows.

Key Use Cases

Crypto-to-crypto transfers
\n
Fiat-backed stablecoin settlements
\n
Merchant payouts in stable assets
\n
Cross-border remittances
\n

\n","_postman_id":"d58784fe-e7e9-4cea-a8fe-4f2e64c91710"}]}

Finecore BAAS API Documentation

Web Hook Events

Webhook Event Types

🔔 Webhook Response

📝 Field Descriptions

Webhook Documentation

Error Handling:

Notes:

Finecore Checkout Integration Guide

Overview

Include Finecore Checkout Script

Initialize and Open the Payment Modal

Add a Payment Button

How It Works

Get Quote Requirement

Purpose

Core Responsibilities

1. Input Schema Definition

2. Validation Rules

3. Transfer-Type Rules

Summary

Initiate Transfer

Responsibilities

Supported Transfer Types

Transfer Destinations

Supported Networks

Foreign Currency Support

Get Transfer Purposes

Responsibilities

Common Transfer Purposes

Usage

Foreign Currency Support

Get Quote

Responsibilities

Quote Information

Supported Flows

Foreign Currency Support

Verify Mobile Money Transfer

Purpose

Flow Overview

Request Parameters

Important Behavior (PIN Flow)

Next Step Values

Example Request (OTP Flow)

Simulate Transfer

Purpose

Request Parameters

Supported Actions

Example Request

Transfers Folder

Core Responsibilities

Supported Stablecoin Assets

Supported Fiat Currencies

Supported Local Payment Channels

Supported Blockchain Networks

Foreign Currency Support

Included Services

Create Customer

Responsibilities

Request Parameters

Example Request

Customer Folder

Core Responsibilities

Important Compliance Rule (Foreign Currency Flow)

Included Services

Behavior Notes

Summary

Link Card

Responsibilities

Required Inputs

Validation Rules

Supported Use Cases

Summary

List Customer Cards

Responsibilities

Returned Information

Validation Rules

Summary

Get List of Banks (Local Currency)

Responsibilities