{ "info": { "name": "Rombex Extended API (Official)", "_postman_id": "a9e5b128-40b9-4c17-91de-07a829f02931", "description": "Official API specification for Rombex Extended API. Explore all endpoints for Customer Onboarding, KYC, Wallets, Deposits, Currency Exchange, Resources, Transactions, Payouts, Webhooks, and Card Issuing.", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "variable": [ { "key": "base_url", "value": "https://api.rombex.com/api/v1", "type": "string" }, { "key": "api_key", "value": "your_api_key_here", "type": "string" } ], "item": [ { "name": "Customer Onboarding", "description": "Customer identity, KYB business profiles, self-accounts, and KYC verification links", "item": [ { "name": "Create Individual Customer", "request": { "method": "POST", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/customers", "host": [ "{{base_url}}" ], "path": [ "customers" ], "variable": [], "query": [] }, "description": "Creates a new customer profile for an individual with residential address and identifying documents.", "body": { "mode": "raw", "raw": "{\n \"type\": \"individual\",\n \"first_name\": \"Jane\",\n \"last_name\": \"Doe\",\n \"email\": \"jane.doe@example.com\",\n \"phone\": \"+12223334444\",\n \"birth_date\": \"1990-01-15\",\n \"residential_address\": \"\",\n \"identifying_information\": []\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "201 Response", "status": "OK", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Customer created successfully\",\n \"data\": {\n \"id\": \"cus_a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n \"first_name\": \"Jane\",\n \"last_name\": \"Doe\",\n \"email\": \"jane.doe@example.com\",\n \"status\": \"incomplete\",\n \"type\": \"individual\",\n \"kyc_status\": \"not_started\",\n \"created_at\": \"2026-05-21T19:30:27.159181+00:00\"\n }\n}" } ] }, { "name": "List All Customers", "request": { "method": "GET", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/customers", "host": [ "{{base_url}}" ], "path": [ "customers" ], "variable": [], "query": [ { "key": "limit", "value": "20", "description": "" }, { "key": "offset", "value": "0", "description": "" }, { "key": "email", "value": "", "description": "" }, { "key": "status", "value": "", "description": "" } ] }, "description": "Returns a paginated list of all customers with optional email/status filter." }, "response": [ { "name": "200 Response", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": [\n {\n \"id\": \"cus_b2c3d4e5-f6a7-8901-bcde-f12345678901\",\n \"first_name\": \"Acme Corp Inc.\",\n \"last_name\": \"Acme\",\n \"email\": \"ops@acmecorp.com\",\n \"type\": \"business\",\n \"status\": \"active\",\n \"kyc_status\": \"AWAITING_UBO\",\n \"created_at\": \"2026-06-26T11:38:21.139903+00:00\"\n }\n ],\n \"pagination\": {\n \"total\": 1,\n \"limit\": 20,\n \"offset\": 0\n }\n}" } ] }, { "name": "Create Business Customer", "request": { "method": "POST", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/customers/business", "host": [ "{{base_url}}" ], "path": [ "customers", "business" ], "variable": [], "query": [] }, "description": "Creates a new business customer profile with business details, beneficial owners (UBOs), and registration documents.", "body": { "mode": "raw", "raw": "{\n \"business_legal_name\": \"Acme Corp Inc.\",\n \"business_trade_name\": \"Acme\",\n \"business_description\": \"Software development services\",\n \"email\": \"ops@acmecorp.com\",\n \"business_type\": \"llc\",\n \"primary_website\": \"https://acme.com\",\n \"registered_address\": \"\",\n \"ownership_threshold\": 25,\n \"expected_monthly_payments_usd\": 50000,\n \"associated_persons\": [],\n \"identifying_information\": []\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "201 Response", "status": "OK", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Business customer created successfully\",\n \"data\": {\n \"id\": \"cus_b2c3d4e5-f6a7-8901-bcde-f12345678901\",\n \"business_legal_name\": \"Acme Corp Inc.\",\n \"business_trade_name\": \"Acme\",\n \"email\": \"ops@acmecorp.com\",\n \"status\": \"awaiting_ubo\",\n \"type\": \"business\",\n \"kyc_status\": \"awaiting_ubo\",\n \"created_at\": \"2026-06-26T11:38:21.139903+00:00\"\n }\n}" } ] }, { "name": "Create or Resolve Self Customer", "request": { "method": "POST", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/customers/self", "host": [ "{{base_url}}" ], "path": [ "customers", "self" ], "variable": [], "query": [] }, "description": "Creates or resolves the authenticated business as a customer under itself. If one exists, returns the existing record." }, "response": [ { "name": "200 Response", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Self-business customer created successfully\",\n \"data\": {\n \"id\": \"cus_a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n \"business_legal_name\": \"Acme Corp Inc.\",\n \"email\": \"ops@acmecorp.com\",\n \"status\": \"active\",\n \"type\": \"business\",\n \"kyc_status\": \"APPROVED\"\n }\n}" } ] }, { "name": "Force Create Self Customer", "request": { "method": "POST", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/customers/self/force", "host": [ "{{base_url}}" ], "path": [ "customers", "self", "force" ], "variable": [], "query": [] }, "description": "Forces creation of a new self-customer profile without reusing existing cache or references." }, "response": [ { "name": "200 Response", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Self-business customer created successfully\",\n \"data\": {\n \"id\": \"cus_f9e8d7c6-b5a4-3210-fedc-ba9876543210\",\n \"business_legal_name\": \"Acme Corp Inc.\",\n \"email\": \"ops@acmecorp.com\",\n \"status\": \"active\",\n \"type\": \"business\",\n \"kyc_status\": \"APPROVED\"\n }\n}" } ] }, { "name": "Get Customer Details", "request": { "method": "GET", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/customers/:customer_id", "host": [ "{{base_url}}" ], "path": [ "customers", ":customer_id" ], "variable": [ { "key": "customer_id", "value": "cus_c3d4e5f6-a7b8-9012-cdef-123456789012", "description": "" } ], "query": [] }, "description": "Retrieves details of an individual or business customer by ID." }, "response": [ { "name": "200 Response", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"cus_c3d4e5f6-a7b8-9012-cdef-123456789012\",\n \"first_name\": \"Acme Corp Inc.\",\n \"last_name\": \"Acme\",\n \"email\": \"ops@acmecorp.com\",\n \"type\": \"business\",\n \"status\": \"active\",\n \"kyc_status\": \"APPROVED\",\n \"created_at\": \"2026-06-15T01:29:09.201373+00:00\",\n \"updated_at\": \"2026-06-15T01:29:09.201373+00:00\"\n }\n}" } ] }, { "name": "Generate KYC Link", "request": { "method": "POST", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/customers/kyc-link", "host": [ "{{base_url}}" ], "path": [ "customers", "kyc-link" ], "variable": [], "query": [] }, "description": "Generates an interactive verification URL for a customer with optional post-verification redirect link.", "body": { "mode": "raw", "raw": "{\n \"customer_id\": \"cus_c3d4e5f6-a7b8-9012-cdef-123456789012\",\n \"redirect_link\": \"https://your-app.com/kyc-success\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "200 Response", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"KYC link generated successfully\",\n \"data\": {\n \"id\": \"kyc_a1b2c3d4e5f6789012345678\",\n \"customer_id\": \"cus_abc123def456\",\n \"email\": \"ops@acmecorp.com\",\n \"kyc_status\": \"pending\",\n \"kyc_link\": \"https://kyc.rombex.com/verify/link123\"\n }\n}" } ] }, { "name": "Get Customer KYC Link", "request": { "method": "GET", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/customers/:customer_id/kyc-link", "host": [ "{{base_url}}" ], "path": [ "customers", ":customer_id", "kyc-link" ], "variable": [ { "key": "customer_id", "value": "cus_c3d4e5f6-a7b8-9012-cdef-123456789012", "description": "" } ], "query": [] }, "description": "Retrieves the active KYC link session and inquiry status for a specific customer." }, "response": [ { "name": "200 Response", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Customer KYC link retrieved successfully\",\n \"data\": {\n \"count\": 1,\n \"data\": [\n {\n \"id\": \"kyc_d4e5f6a7-b8c9-0123-defa-234567890123\",\n \"full_name\": \"Acme Corp Inc.\",\n \"email\": \"ops@acmecorp.com\",\n \"type\": \"business\",\n \"kyc_link\": \"https://kyc.rombex.com/verify?token=tok_example\",\n \"tos_link\": \"https://compliance.rombex.com/accept-terms-of-service\",\n \"kyc_status\": \"awaiting_ubo\",\n \"rejection_reasons\": [],\n \"tos_status\": \"pending\",\n \"created_at\": \"2026-06-26T11:38:16.913Z\",\n \"persona_inquiry_type\": \"business\"\n }\n ]\n }\n}" } ] }, { "name": "Get KYC Link Status", "request": { "method": "GET", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/customers/kyc-link/:kyc_link_id", "host": [ "{{base_url}}" ], "path": [ "customers", "kyc-link", ":kyc_link_id" ], "variable": [ { "key": "kyc_link_id", "value": "kyc_d4e5f6a7-b8c9-0123-defa-234567890123", "description": "" } ], "query": [] }, "description": "Retrieves status and details of a single KYC session by link ID." }, "response": [ { "name": "200 Response", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"kyc_d4e5f6a7-b8c9-0123-defa-234567890123\",\n \"full_name\": \"Acme Corp Inc.\",\n \"email\": \"ops@acmecorp.com\",\n \"type\": \"business\",\n \"kyc_status\": \"awaiting_ubo\",\n \"tos_status\": \"pending\"\n }\n}" } ] }, { "name": "Get Terms of Service Acceptance Link", "request": { "method": "GET", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/customers/:customer_id/tos-link", "host": [ "{{base_url}}" ], "path": [ "customers", ":customer_id", "tos-link" ], "variable": [ { "key": "customer_id", "value": "cus_c3d4e5f6-a7b8-9012-cdef-123456789012", "description": "" } ], "query": [] }, "description": "Retrieves a unique, time-sensitive URL for customer compliance acceptance." }, "response": [ { "name": "200 Response", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"TOS acceptance link retrieved successfully\",\n \"data\": {\n \"url\": \"https://compliance.rombex.com/accept-terms-of-service?customer_id=cus_xxx&t=tok_yyy\"\n }\n}" } ] } ] }, { "name": "Wallets", "description": "Create and manage FIAT and multi-chain CRYPTO wallets (Ethereum, TRON, Solana, Base, Polygon)", "item": [ { "name": "Get Customer Wallets", "request": { "method": "GET", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/customers/:customer_id/wallets", "host": [ "{{base_url}}" ], "path": [ "customers", ":customer_id", "wallets" ], "variable": [ { "key": "customer_id", "value": "cus_c3d4e5f6-a7b8-9012-cdef-123456789012", "description": "" } ], "query": [] }, "description": "Returns all wallets (FIAT and CRYPTO) belonging to a customer." }, "response": [ { "name": "200 Response", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": [\n {\n \"id\": \"wal_e5f6a7b8-c9d0-1234-efab-345678901234\",\n \"title\": \"My Test USD Wallet\",\n \"currency\": \"EUR\",\n \"balance\": 0,\n \"is_active\": true,\n \"type\": \"FIAT\",\n \"created_at\": \"2026-06-15T23:43:46.843+00:00\"\n }\n ]\n}" } ] }, { "name": "Create Wallet (Fiat or Crypto)", "request": { "method": "POST", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/wallets", "host": [ "{{base_url}}" ], "path": [ "wallets" ], "variable": [], "query": [] }, "description": "Creates a new FIAT or multi-chain CRYPTO wallet (supports Ethereum, TRON, Base, Polygon, Solana).", "body": { "mode": "raw", "raw": "{\n \"user_id\": \"cus_c3d4e5f6-a7b8-9012-cdef-123456789012\",\n \"title\": \"My TRON USDT Wallet\",\n \"currency\": \"USDT\",\n \"type\": \"CRYPTO\",\n \"chain\": \"tron\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "201 Response", "status": "OK", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Wallet created successfully\",\n \"data\": {\n \"id\": \"wal_a7b8c9d0-e1f2-3456-abcd-567890123456\",\n \"title\": \"My TRON USDT Wallet\",\n \"currency\": \"USDT\",\n \"balance\": 0,\n \"is_active\": true,\n \"type\": \"CRYPTO\",\n \"chain\": \"tron\",\n \"crypto_address\": \"TTest9x8y7z6a5b4c3d2e1f0g9h8i7j6\",\n \"created_at\": \"2026-07-28T12:00:00.000Z\"\n }\n}" } ] }, { "name": "Get Wallet Information", "request": { "method": "GET", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/wallets/:wallet_id", "host": [ "{{base_url}}" ], "path": [ "wallets", ":wallet_id" ], "variable": [ { "key": "wallet_id", "value": "wal_a7b8c9d0-e1f2-3456-abcd-567890123456", "description": "" } ], "query": [] }, "description": "Retrieves details, available balance, and ledger balance for a specific wallet." }, "response": [ { "name": "200 Response", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"wal_a7b8c9d0-e1f2-3456-abcd-567890123456\",\n \"title\": \"My NGN Wallet\",\n \"currency\": \"NGN\",\n \"is_active\": true,\n \"type\": \"FIAT\",\n \"ledger_balance\": 150,\n \"available_balance\": 145,\n \"created_at\": \"2026-01-15T10:30:00.000+00:00\"\n }\n}" } ] }, { "name": "Get Wallet Transactions", "request": { "method": "GET", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/wallets/:wallet_id/transactions", "host": [ "{{base_url}}" ], "path": [ "wallets", ":wallet_id", "transactions" ], "variable": [ { "key": "wallet_id", "value": "wal_a7b8c9d0-e1f2-3456-abcd-567890123456", "description": "" } ], "query": [ { "key": "limit", "value": "20", "description": "" }, { "key": "offset", "value": "0", "description": "" }, { "key": "type", "value": "", "description": "" }, { "key": "status", "value": "", "description": "" } ] }, "description": "Returns paginated transactions for a specific wallet with optional filters." }, "response": [ { "name": "200 Response", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": [\n {\n \"id\": \"txn_a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n \"type\": \"DEPOSIT\",\n \"status\": \"SUCCESS\",\n \"currency\": \"NGN\",\n \"amount\": 50000,\n \"reference_id\": \"DEP-20260115-001\",\n \"created_at\": \"2026-01-15T10:30:00.000+00:00\"\n }\n ],\n \"pagination\": {\n \"total\": 1,\n \"limit\": 20,\n \"offset\": 0\n }\n}" } ] } ] }, { "name": "Deposits", "description": "Request and fetch deposit instructions for NGN bank transfers, CAD INTERAC e-transfers, EUR/USD virtual accounts, and crypto addresses", "item": [ { "name": "Request Deposit Instructions", "request": { "method": "POST", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/deposits/request", "host": [ "{{base_url}}" ], "path": [ "deposits", "request" ], "variable": [], "query": [] }, "description": "Generates virtual bank account, INTERAC e-transfer parameters, or crypto deposit address based on currency.", "body": { "mode": "raw", "raw": "{\n \"wallet_id\": \"wal_a7b8c9d0-e1f2-3456-abcd-567890123456\",\n \"currency\": \"NGN\",\n \"bvn\": \"01020304050\",\n \"phone\": \"+2348130000000\",\n \"dob\": \"1992-10-19\",\n \"narration\": \"Deposit top-up\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "200 Response", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Deposit instructions generated successfully\",\n \"data\": {\n \"id\": \"dep_b1c2d3e4-f5a6-7890-bcde-f12345678901\",\n \"reference\": \"NGN1782499394182\",\n \"bank_name\": \"BEAMER MICROFINANCE BANK\",\n \"account_number\": \"1234567890\",\n \"account_name\": \"JANE DOE\",\n \"currency\": \"NGN\",\n \"status\": \"ACTIVE\",\n \"created_at\": \"2026-01-15T10:30:00.000+00:00\"\n }\n}" } ] }, { "name": "Get Wallet Deposit Instructions", "request": { "method": "GET", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/deposits/wallet/:wallet_id", "host": [ "{{base_url}}" ], "path": [ "deposits", "wallet", ":wallet_id" ], "variable": [ { "key": "wallet_id", "value": "wal_a7b8c9d0-e1f2-3456-abcd-567890123456", "description": "" } ], "query": [] }, "description": "Retrieves previously generated deposit instructions for a specific wallet." }, "response": [ { "name": "200 Response", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": [\n {\n \"id\": \"dep_b1c2d3e4-f5a6-7890-bcde-f12345678901\",\n \"reference\": \"NGN1782499394182\",\n \"bank_name\": \"BEAMER (GABSYN) MICROFINANCE BANK\",\n \"account_number\": \"0000000000\",\n \"account_name\": \"JOHN DOE\",\n \"currency\": \"NGN\",\n \"status\": \"ACTIVE\"\n }\n ]\n}" } ] } ] }, { "name": "Exchange", "description": "Live exchange rates, dynamic spread calculation, and instant crypto/fiat trade execution", "item": [ { "name": "Get Exchange Rates", "request": { "method": "POST", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/exchange-rate", "host": [ "{{base_url}}" ], "path": [ "exchange-rate" ], "variable": [], "query": [] }, "description": "Calculates current rates and destination amounts dynamically applying business spreads.", "body": { "mode": "raw", "raw": "{\n \"from\": \"USD\",\n \"to\": [\n \"KES\",\n \"GHS\",\n \"NGN\",\n \"ZAR\",\n \"CAD\",\n \"EUR\",\n \"GBP\"\n ],\n \"amount\": 1000\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "200 Response", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": 2000,\n \"state\": true,\n \"message\": \"Successful.\",\n \"data\": {\n \"from\": {\n \"currency\": {\n \"code\": \"USD\",\n \"symbol\": \"$\"\n },\n \"amount\": 1000\n },\n \"to\": [\n {\n \"currency\": {\n \"code\": \"CAD\",\n \"symbol\": \"$\"\n },\n \"amount\": 1350,\n \"rate\": 1.35\n },\n {\n \"currency\": {\n \"code\": \"NGN\",\n \"symbol\": \"₦\"\n },\n \"amount\": 1550000,\n \"rate\": 1550\n }\n ],\n \"date_compared\": \"2026-06-26 21:49:03\"\n }\n}" } ] }, { "name": "Execute Trade / Currency Conversion", "request": { "method": "POST", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/exchange-rate/trade", "host": [ "{{base_url}}" ], "path": [ "exchange-rate", "trade" ], "variable": [], "query": [] }, "description": "Converts funds between two wallets with instant settlement.", "body": { "mode": "raw", "raw": "{\n \"amount\": 1000,\n \"source_wallet_id\": \"wal_a7b8c9d0-e1f2-3456-abcd-567890123456\",\n \"destination_wallet_id\": \"wal_f5a67890-bcde-1234-5678-901234567890\",\n \"reference\": \"CUSTOM_TRADE_REF_123\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "200 Response", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Exchange executed successfully\",\n \"data\": {\n \"transaction_reference\": \"TXN-1782506110685\",\n \"status\": \"SUCCESSFUL\",\n \"source_currency\": \"NGN\",\n \"target_currency\": \"CAD\",\n \"source_amount\": 1000,\n \"target_amount\": 830,\n \"exchange_rate\": 0.83,\n \"executed_at\": \"2026-06-26T20:35:11.007Z\"\n }\n}" } ] } ] }, { "name": "Resources", "description": "Financial institutions, payout rails, and bank code lookups", "item": [ { "name": "Get Financial Institutions", "request": { "method": "GET", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/resources/institutions", "host": [ "{{base_url}}" ], "path": [ "resources", "institutions" ], "variable": [], "query": [ { "key": "country_code", "value": "NGA", "description": "" } ] }, "description": "Fetches list of supported payout banks and mobile money institutions by country code." }, "response": [ { "name": "200 Response", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": 2000,\n \"state\": true,\n \"data\": [\n {\n \"method\": \"BANK_TRANSFER\",\n \"country_name\": \"NIGERIA\",\n \"currency_code\": \"NGN\",\n \"institutions\": [\n {\n \"name\": \"ACCESS BANK\",\n \"identifier\": \"fwqqCmCbDGTACLdIhgncanPDYKbTJT\"\n },\n {\n \"name\": \"ZENITH BANK\",\n \"identifier\": \"GpGOUVNdeJp6MjqryOWjN52klfiX92\"\n }\n ]\n }\n ]\n}" } ] } ] }, { "name": "Transactions", "description": "Transaction logs, paginated history, and single reference querying", "item": [ { "name": "Get Transactions History", "request": { "method": "GET", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/transactions", "host": [ "{{base_url}}" ], "path": [ "transactions" ], "variable": [], "query": [ { "key": "customer_id", "value": "", "description": "" }, { "key": "limit", "value": "20", "description": "" }, { "key": "offset", "value": "0", "description": "" } ] }, "description": "Paginated list of transactions across customers or wallets." }, "response": [ { "name": "200 Response", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": [\n {\n \"id\": \"txn_8b7c6d5e-4f3a-2b1c-0d9e-8f7a6b5c4d3e\",\n \"type\": \"SWAP\",\n \"status\": \"SUCCESSFUL\",\n \"source_currency\": \"NGN\",\n \"target_currency\": \"CAD\",\n \"amount\": 500000,\n \"reference_id\": \"EX-1782506110685\"\n }\n ],\n \"pagination\": {\n \"total\": 45,\n \"limit\": 20,\n \"offset\": 0\n }\n}" } ] }, { "name": "Get Transaction by Reference", "request": { "method": "GET", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/transactions/reference/:transaction_ref", "host": [ "{{base_url}}" ], "path": [ "transactions", "reference", ":transaction_ref" ], "variable": [ { "key": "transaction_ref", "value": "EX-1782506110685", "description": "" } ], "query": [] }, "description": "Retrieves complete transaction details using its unique reference string." }, "response": [ { "name": "200 Response", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"txn_8b7c6d5e-4f3a-2b1c-0d9e-8f7a6b5c4d3e\",\n \"type\": \"SWAP\",\n \"status\": \"SUCCESSFUL\",\n \"source_currency\": \"NGN\",\n \"target_currency\": \"CAD\",\n \"amount\": 500000,\n \"reference_id\": \"EX-1782506110685\"\n }\n}" } ] } ] }, { "name": "Payouts", "description": "Account verification, local bank transfers, Interac e-transfers, and international cross-border rails (ACH, SEPA, SWIFT, Polygon, Ethereum)", "item": [ { "name": "Verify Payout Account", "request": { "method": "POST", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/payouts/verify", "host": [ "{{base_url}}" ], "path": [ "payouts", "verify" ], "variable": [], "query": [] }, "description": "Validates beneficiary account number and retrieves verified bank account holder name.", "body": { "mode": "raw", "raw": "{\n \"country_code\": \"NGA\",\n \"currency_code\": \"NGN\",\n \"method\": \"BANK_TRANSFER\",\n \"recipient\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "200 Response", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": 2000,\n \"state\": true,\n \"message\": \"Successful.\",\n \"data\": {\n \"institution\": {\n \"name\": \"PALMPAY\",\n \"identifier\": \"bQLCImk3p0FoTflucVNW5katLF9gPh\"\n },\n \"account\": {\n \"name\": \"JOHN DOE\",\n \"number\": \"1234567890\"\n }\n }\n}" } ] }, { "name": "Send Payout (Bank / Interac)", "request": { "method": "POST", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/payouts/send", "host": [ "{{base_url}}" ], "path": [ "payouts", "send" ], "variable": [], "query": [] }, "description": "Initiates instant local payouts to bank account (e.g. NGN) or Interac e-Transfer (CAD).", "body": { "mode": "raw", "raw": "{\n \"wallet_id\": \"wal_a7b8c9d0-e1f2-3456-abcd-567890123456\",\n \"country_code\": \"NGA\",\n \"amount\": 1000,\n \"recipient\": \"\",\n \"reference\": \"sRuXQ1fgg23WQ1gXXGFFD46Wte\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "200 Response", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Payout initiated successfully\",\n \"data\": {\n \"id\": \"pay_123abc\",\n \"wallet_id\": \"wal_a7b8c9d0-e1f2-3456-abcd-567890123456\",\n \"amount_cents\": 100000,\n \"currency\": \"NGN\",\n \"status\": \"PENDING\",\n \"reference_id\": \"sRuXQ1fgg23WQ1gXXGFFD46Wte\"\n }\n}" } ] }, { "name": "Send International Transfer (ACH, SEPA, SWIFT, Crypto Rails)", "request": { "method": "POST", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/payouts/transfer", "host": [ "{{base_url}}" ], "path": [ "payouts", "transfer" ], "variable": [], "query": [] }, "description": "Dispatches cross-border transfers in USD, EUR, GBP, or USDC/USDT on Polygon/Ethereum.", "body": { "mode": "raw", "raw": "{\n \"wallet_id\": \"wal_a7b8c9d0-e1f2-3456-abcd-567890123456\",\n \"amount\": 500,\n \"spread\": 1.5,\n \"fees\": 5,\n \"target\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "200 Response", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Payout initiated successfully\",\n \"data\": {\n \"id\": \"pay_trans_456\",\n \"status\": \"PENDING\"\n }\n}" } ] } ] }, { "name": "Cards & Issuing", "description": "Virtual & corporate Visa/Mastercard card issuing, funding, withdrawal, and lifecycle management", "item": [ { "name": "Issue Customer Virtual Card", "request": { "method": "POST", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/issuing", "host": [ "{{base_url}}" ], "path": [ "issuing" ], "variable": [], "query": [] }, "description": "Provisions a virtual Visa/Mastercard card for an individual customer.", "body": { "mode": "raw", "raw": "{\n \"customer_id\": \"c1f7a028-1bfa-4c7b-8e3b-9e4a3c1f0101\",\n \"currency\": \"USD\",\n \"type\": \"VIRTUAL\",\n \"brand\": \"VISA\",\n \"amount\": 5000,\n \"auto_approve\": true\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "200 Response", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": true,\n \"success\": true,\n \"message\": \"Card creation in progress\",\n \"data\": {\n \"card_id\": \"card_17682910291_a8df1\",\n \"status\": \"PENDING\",\n \"currency\": \"USD\",\n \"brand\": \"VISA\"\n }\n}" } ] }, { "name": "Issue Corporate Card", "request": { "method": "POST", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/issuing/business", "host": [ "{{base_url}}" ], "path": [ "issuing", "business" ], "variable": [], "query": [] }, "description": "Issues a virtual or physical corporate expense card for teams.", "body": { "mode": "raw", "raw": "{\n \"name\": \"Cloud Infra Team\",\n \"type\": \"VIRTUAL\",\n \"brand\": \"MASTERCARD\",\n \"currency\": \"USD\",\n \"amount\": 25000,\n \"auto_approve\": true\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "200 Response", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": true,\n \"success\": true,\n \"message\": \"Card creation in progress\"\n}" } ] }, { "name": "Fund Card", "request": { "method": "POST", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/issuing/:card_id/fund", "host": [ "{{base_url}}" ], "path": [ "issuing", ":card_id", "fund" ], "variable": [ { "key": "card_id", "value": "card_17682910291_a8df1", "description": "" } ], "query": [] }, "description": "Loads balance onto an active virtual or physical card.", "body": { "mode": "raw", "raw": "{\n \"amount\": 10000\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "200 Response", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Card funded\"\n}" } ] }, { "name": "Withdraw From Card", "request": { "method": "POST", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/issuing/:card_id/withdraw", "host": [ "{{base_url}}" ], "path": [ "issuing", ":card_id", "withdraw" ], "variable": [ { "key": "card_id", "value": "card_17682910291_a8df1", "description": "" } ], "query": [] }, "description": "Withdraws balance from card back to main wallet.", "body": { "mode": "raw", "raw": "{\n \"amount\": 5000\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "200 Response", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Funds withdrawn\"\n}" } ] }, { "name": "Get Card Details", "request": { "method": "GET", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/issuing/:card_id", "host": [ "{{base_url}}" ], "path": [ "issuing", ":card_id" ], "variable": [ { "key": "card_id", "value": "card_17682910291_a8df1", "description": "" } ], "query": [] }, "description": "Retrieves card status, pan details, balance, and spending limits." }, "response": [ { "name": "200 Response", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"card_17682910291_a8df1\",\n \"status\": \"ACTIVE\",\n \"brand\": \"VISA\",\n \"currency\": \"USD\",\n \"balance\": 5000\n }\n}" } ] }, { "name": "Freeze Card", "request": { "method": "PATCH", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/issuing/:card_id/freeze", "host": [ "{{base_url}}" ], "path": [ "issuing", ":card_id", "freeze" ], "variable": [ { "key": "card_id", "value": "card_17682910291_a8df1", "description": "" } ], "query": [] }, "description": "Temporarily disables all transactions on a card." }, "response": [] }, { "name": "Unfreeze Card", "request": { "method": "PATCH", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/issuing/:card_id/unfreeze", "host": [ "{{base_url}}" ], "path": [ "issuing", ":card_id", "unfreeze" ], "variable": [ { "key": "card_id", "value": "card_17682910291_a8df1", "description": "" } ], "query": [] }, "description": "Reactivates a frozen card." }, "response": [] }, { "name": "Terminate Card", "request": { "method": "PUT", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/issuing/:card_id/terminate", "host": [ "{{base_url}}" ], "path": [ "issuing", ":card_id", "terminate" ], "variable": [ { "key": "card_id", "value": "card_17682910291_a8df1", "description": "" } ], "query": [] }, "description": "Permanently cancels and terminates a card." }, "response": [] }, { "name": "Get Card Decline Charges", "request": { "method": "GET", "header": [ { "key": "x-api-key", "value": "{{api_key}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/issuing/charges", "host": [ "{{base_url}}" ], "path": [ "issuing", "charges" ], "variable": [], "query": [ { "key": "channel", "value": "CARD", "description": "" } ] }, "description": "Lists fees and decline charges incurred on cards." }, "response": [ { "name": "200 Response", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": []\n}" } ] } ] }, { "name": "Webhooks", "description": "Real-time webhook notifications, HMAC-SHA256 signature verification, and event payloads", "item": [ { "name": "KYC Webhook (customer.updated.status_transitioned)", "request": { "method": "POST", "header": [ { "key": "X-Webhook-Signature", "value": "sha256=abcdef1234567890...", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "https://your-webhook-endpoint.com/webhook/rombex" }, "body": { "mode": "raw", "raw": "{\n \"api_version\": \"v0\",\n \"event_category\": \"customer\",\n \"event_type\": \"customer.updated.status_transitioned\",\n \"event_object_status\": \"approved\"\n}" }, "description": "Triggered when customer KYC is approved/rejected/transitioned." } }, { "name": "Deposit Webhook (deposit.completed)", "request": { "method": "POST", "header": [ { "key": "X-Webhook-Signature", "value": "sha256=abcdef1234567890...", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "https://your-webhook-endpoint.com/webhook/rombex" }, "body": { "mode": "raw", "raw": "{\n \"api_version\": \"v0\",\n \"event_category\": \"deposit\",\n \"event_type\": \"deposit.completed\",\n \"event_object\": {\n \"wallet_id\": \"wal_e9d8c7b6-a5f4-3e2d-1c0b-9a8b7c6d5e4f\",\n \"amount\": 1000,\n \"currency\": \"EUR\",\n \"status\": \"completed\"\n }\n}" }, "description": "Triggered when an incoming deposit is credited." } } ] } ] }