{"openapi":"3.0.3","info":{"title":"Slikpay Global Contactless Payment Infrastructure API","version":"1.0.0","description":"\n**Slikpay** is an enterprise contactless payment infrastructure for Nigeria that completely eliminates traditional hardware POS machines.\nIt combines:\n- **SoftPOS / COTS (PCI MPoC compliant)**\n- **NTAG 424 DNA Smart Cryptographic Tags**\n- **Dynamic Micro-QR & USSD Fallback**\n- **Double-Entry Accounting Core**\n- **Unified Banking-as-a-Service Rails**\n- **Sub-300ms Acoustic Voicebox Announcements**\n    ","contact":{"name":"Slikpay Engineering & Developer Relations","email":"support@slikpay.online","url":"https://slikpay.online"}},"servers":[{"url":"https://api.slikpay.online","description":"Production & Sandbox Financial Switch (Live/Test controlled via API Key)"},{"url":"https://business.slikpay.online","description":"Merchant & Developer Console API Gateway"}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key / JWT","description":"Merchant Secret API Key (Authorization: Bearer sk_live_... or sk_test_...)"},"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Institutional merchant secret key (sk_live_... or sk_test_...)"}},"schemas":{"Merchant":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"businessName":{"type":"string","example":"Acme FinTech Global Ltd"},"phone":{"type":"string","example":"08023456789"},"virtualAccountNumber":{"type":"string","example":"7943128784"},"virtualAccountBank":{"type":"string","example":"Wema Bank"},"kycTier":{"type":"integer","example":2},"walletBalance":{"type":"number","example":84500}}},"SmartTag":{"type":"object","properties":{"tagSerial":{"type":"string","example":"PAD-LAG-YAB-001"},"tagUid":{"type":"string","example":"04A2B3C4D5E601"},"dynamicUrl":{"type":"string","example":"https://pay.slikpay.online/t?tag=04A2B3C4D5E601"},"ussdCode":{"type":"string","example":"*992*001*AMOUNT#"},"status":{"type":"string","enum":["UNASSIGNED","ACTIVE","SUSPENDED"]}}},"Transaction":{"type":"object","properties":{"reference":{"type":"string","example":"PAD_1790685033_AB12"},"amount":{"type":"number","example":5000},"platformFee":{"type":"number","example":17.5},"netMerchantAmount":{"type":"number","example":4982.5},"channel":{"type":"string","enum":["NFC_TAG","DYNAMIC_QR","USSD_CODE","SOFTPOS_CARD"]},"status":{"type":"string","enum":["PENDING","SUCCESSFUL","FAILED","REFUNDED"]},"voiceboxDelivered":{"type":"boolean","example":true}}}}},"paths":{"/health":{"get":{"summary":"System Health & Connection Telemetry","responses":{"200":{"description":"Server and WebSocket status healthy"}}}},"/metrics":{"get":{"summary":"Prometheus Metrics Exposition","description":"Exports real-time GMV, fee revenue, request rates, and WebSocket gauges in Prometheus format.","responses":{"200":{"description":"Prometheus metrics string"}}}},"/v1/pricing":{"get":{"summary":"Public Pricing & Fee Matrix","description":"Returns the transparent fee schedule across all 10 financial rails and subscription tiers (Starter, Growth, Enterprise).","tags":["Pricing & Commercials"],"responses":{"200":{"description":"Live pricing schedule and tier plans","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"currency":{"type":"string","example":"NGN"},"version":{"type":"string","example":"2026-10-01"},"plans":{"type":"array"},"rails":{"type":"array"}}}}}}}}}}},"/v1/pricing/calculate":{"post":{"summary":"Dynamic Fee Calculator","description":"Calculates the exact customer debit, platform fee, and net settlement for any financial rail and subscription plan.","tags":["Pricing & Commercials"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"rail":{"type":"string","example":"collections","enum":["collections","payouts","bulk_payouts","virtual_cards_usd","virtual_cards_ngn","identity_bvn","identity_nin","identity_cac","telecom_sms","telecom_voice_otp","open_banking_auth","open_banking_statement","crypto_swap","escrow"]},"amount":{"type":"number","example":50000},"plan":{"type":"string","example":"starter","enum":["starter","growth","enterprise"]}},"required":["rail","amount"]}}}},"responses":{"200":{"description":"Calculated fee and net settlement breakdown","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"rail":{"type":"string","example":"collections"},"plan":{"type":"string","example":"starter"},"grossAmount":{"type":"number","example":50000},"fee":{"type":"number","example":400},"netAmount":{"type":"number","example":49600},"description":{"type":"string","example":"0.8% of ₦50,000 (Capped at ₦1,000)"}}}}}}}}}}},"/v1/gateway/initialize":{"post":{"summary":"Initialize Hosted / Inline Checkout Session","description":"Creates a high-speed multi-currency checkout session returning dedicated bank transfer coordinates, checkout URL, and USSD dial strings.","tags":["Payment Gateway & Global Acquiring"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"amount":{"type":"number","example":5000},"currency":{"type":"string","example":"NGN","default":"NGN"},"email":{"type":"string","format":"email","example":"customer@domain.com"},"name":{"type":"string","example":"Patrick Achua"},"reference":{"type":"string","example":"ORD_1792348000"},"channels":{"type":"array","items":{"type":"string"},"example":["transfer","card","ussd","opay"]},"callback_url":{"type":"string","example":"https://myshop.com/checkout/callback"}},"required":["amount","email"]}}}},"responses":{"200":{"description":"Checkout session created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"checkout_url":{"type":"string","example":"https://pay.slikpay.online/t?ref=PAD_GW_179..."},"reference":{"type":"string","example":"PAD_GW_1791311707_34AB"},"access_code":{"type":"string","example":"acc_87e1a3b5c4"},"account_number":{"type":"string","example":"7943128784"},"bank_name":{"type":"string","example":"Wema Bank"},"account_name":{"type":"string","example":"slikpay Global Ltd (via Slikpay)"}}}}}}}}}}},"/v1/gateway/global/intent":{"post":{"summary":"Initialize Global Acquiring Intent (USD, EUR, GBP, CAD, AUD)","description":"Initializes a white-labeled global payment intent supporting international cards (Visa, Mastercard, Amex 3DS2), Apple Pay, Google Pay, BNPL (Klarna, Afterpay, Affirm), and auto-provisioned local bank details (US ACH/Fedwire, EU SEPA IBAN, UK Bacs). Settles automatically to multi-currency merchant balance.","tags":["Payment Gateway & Global Acquiring"],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"amount":{"type":"number","example":150},"currency":{"type":"string","enum":["USD","EUR","GBP","CAD","AUD"],"example":"USD"},"customerEmail":{"type":"string","format":"email","example":"customer@domain.com"},"customerName":{"type":"string","example":"Jonathan Edwards"},"reference":{"type":"string","example":"PAD_GLB_1792348120_A1"},"paymentMethods":{"type":"array","items":{"type":"string"},"example":["card","apple_pay","google_pay","bank_transfer","klarna"]}},"required":["amount","currency","customerEmail"]}}}},"responses":{"200":{"description":"Global Payment Intent created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"intent_id":{"type":"string","example":"pi_pad_94a08bc71e"},"client_token":{"type":"string","example":"tok_pad_sec_87e1a3b5c4"},"reference":{"type":"string","example":"PAD_GLB_1792348120_A1"},"amount":{"type":"number","example":150},"currency":{"type":"string","example":"USD"},"status":{"type":"string","example":"REQUIRES_PAYMENT_METHOD"},"checkout_url":{"type":"string","example":"https://pay.slikpay.online/t?ref=PAD_GLB_1792348120_A1&currency=USD&amount=150"},"supported_methods":{"type":"array","items":{"type":"string"}},"bank_transfer_instructions":{"type":"object"},"statement_descriptor":{"type":"string","example":"SLIKPAY* SLIKPAY"}}}}}}}}}}},"/v1/gateway/bank-debit/charge":{"post":{"summary":"Direct Bank Debit (US ACH, EU SEPA, UK Bacs)","description":"Initiates a compliant white-labeled bank debit mandate and pull transaction across US ACH, EU SEPA Core Direct Debit, or UK Bacs.","tags":["Payment Gateway & Global Acquiring"],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"amount":{"type":"number","example":250},"currency":{"type":"string","enum":["USD","EUR","GBP"],"example":"USD"},"customerEmail":{"type":"string","format":"email","example":"customer@domain.com"},"customerName":{"type":"string","example":"Johnathan Edwards"},"routingNumber":{"type":"string","example":"021000021","description":"9-digit ABA routing (US ACH)"},"accountNumber":{"type":"string","example":"0284719283","description":"Account number (US ACH, UK Bacs)"},"iban":{"type":"string","example":"DE89370400440532013000","description":"IBAN (EU SEPA)"},"sortCode":{"type":"string","example":"200000","description":"6-digit Sort Code (UK Bacs)"}},"required":["amount","currency","customerEmail"]}}}},"responses":{"200":{"description":"Bank debit mandate accepted","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"debit_id":{"type":"string","example":"ach_pad_31f7ac981b"},"mandate_reference":{"type":"string","example":"MND_ACH_US_1792348120"},"reference":{"type":"string","example":"PAD_DBT_1792348120_01"},"rail":{"type":"string","example":"US_ACH_DIRECT_DEBIT"},"amount":{"type":"number","example":250},"currency":{"type":"string","example":"USD"},"status":{"type":"string","example":"PROCESSING"},"estimated_settlement":{"type":"string","example":"1-2 Business Days"}}}}}}}}}}},"/v1/gateway/refunds":{"post":{"summary":"Instant Multi-Currency Refund","description":"Issues a full or partial refund for a settled transaction across any supported currency (USD, EUR, GBP, NGN, KES, GHS, ZAR). Atomically adjusts double-entry ledgers and triggers upstream reversal.","tags":["Payment Gateway & Global Acquiring"],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"reference":{"type":"string","example":"PAD_GLB_1792348120_A1","description":"Original transaction reference"},"amount":{"type":"number","example":50,"description":"Optional partial refund amount. Defaults to full amount."},"reason":{"type":"string","enum":["requested_by_customer","duplicate","fraudulent"],"default":"requested_by_customer"}},"required":["reference"]}}}},"responses":{"200":{"description":"Refund processed successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"refund_id":{"type":"string","example":"re_pad_78dae39c"},"transaction_reference":{"type":"string","example":"PAD_GLB_1792348120_A1"},"amount_refunded":{"type":"number","example":50},"currency":{"type":"string","example":"USD"},"status":{"type":"string","example":"SUCCEEDED"},"reason":{"type":"string","example":"requested_by_customer"}}}}}}}}}}},"/v1/gateway/verify/{reference}":{"get":{"summary":"Verify Payment Settlement (Server-to-Server)","description":"Verifies final transaction settlement on the ledger before merchant fulfills goods or services.","tags":["Payment Gateway & Global Acquiring"],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"parameters":[{"name":"reference","in":"path","required":true,"schema":{"type":"string"},"example":"PAD_GW_1791311707_34AB"}],"responses":{"200":{"description":"Transaction verified and settled","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"reference":{"type":"string","example":"PAD_GW_1791311707_34AB"},"amount":{"type":"number","example":5000},"currency":{"type":"string","example":"NGN"},"status":{"type":"string","example":"success"},"channel":{"type":"string","example":"BANK_TRANSFER"}}}}}}}}}}},"/api/auth/developer/login":{"post":{"summary":"Merchant & Developer Console Login","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","example":"developer@company.com"},"password":{"type":"string","example":"YourSecurePassword!"}},"required":["email","password"]}}}},"responses":{"200":{"description":"JWT authentication token, API keys, and merchant profile"}}}},"/api/merchants":{"get":{"summary":"List Registered Merchants","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Paginated list of merchants"}}},"post":{"summary":"Onboard Merchant (Auto-issues dedicated Virtual NUBAN)","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"businessName":{"type":"string"},"contactName":{"type":"string"},"email":{"type":"string"},"phone":{"type":"string"},"bvn":{"type":"string"}},"required":["businessName","contactName","email","phone"]}}}},"responses":{"201":{"description":"Merchant created with dedicated NUBAN"}}}},"/api/tags/resolve":{"get":{"summary":"Public NFC Tap & QR Ingress Resolve","description":"Endpoint hit when any customer phone taps the ₦200 NFC counter tag or scans the QR code.","parameters":[{"name":"tag","in":"query","required":true,"schema":{"type":"string"},"example":"04A2B3C4D5E601"},{"name":"cmac","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Tag details and merchant dedicated NUBAN"}}}},"/api/attestation/verify":{"post":{"summary":"PCI MPoC Mobile Device Attestation","description":"Submits Android hardware security telemetry (Play Integrity, TEE, Root status) to authorize SoftPOS card reading.","responses":{"200":{"description":"Attestation evaluation and temporary SoftPOS token"}}}},"/api/webhooks/simulate":{"post":{"summary":"Simulate Incoming Payment Webhook","description":"Simulates an authorized customer payment, triggering double-entry ledger posting and Voicebox audio dispatch.","responses":{"200":{"description":"Transaction processed and Voicebox audio triggered"}}}},"/api/disputes/refund/{reference}":{"post":{"summary":"Execute Transaction Refund","security":[{"BearerAuth":[]}],"parameters":[{"name":"reference","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Refund processed and ledger adjusted"}}}},"/v1/accounts/virtual":{"post":{"tags":["1. Virtual Accounts & Banking"],"summary":"Issue Dedicated Virtual NUBAN Account (Wema / Providus)","description":"Provisions a permanent or dynamic Nigerian Virtual NUBAN account with automatic settlement into merchant treasury.","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accountName":{"type":"string","example":"Adebayo Tunde"},"customerEmail":{"type":"string","example":"tunde@example.com"},"customerPhone":{"type":"string","example":"2348012345678"},"bvn":{"type":"string","description":"Optional 11-digit customer BVN. Omit (or pass useMerchantBvn: true) to issue under your Merchant BVN.","example":"22119988776"},"useMerchantBvn":{"type":"boolean","description":"Optional. Set true (default when bvn is omitted) to issue the account under the Merchant BVN.","example":true},"currency":{"type":"string","example":"NGN"},"accountType":{"type":"string","enum":["individual","corporate"],"example":"corporate"}},"required":["accountName"]}}}},"responses":{"201":{"description":"Dedicated Virtual Account issued successfully"}}}},"/v1/accounts/banks":{"get":{"tags":["1. Virtual Accounts & Banking"],"summary":"List Supported Nigerian Commercial Banks & FinTech MFBs","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"List of banks with 3-digit and 6-digit NIP codes"}}}},"/v1/accounts/resolve":{"post":{"tags":["1. Virtual Accounts & Banking"],"summary":"Real-Time NIP Account Name Inquiry (Resolve NUBAN)","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accountNumber":{"type":"string","example":"0123456789"},"bankCode":{"type":"string","example":"058"}},"required":["accountNumber","bankCode"]}}}},"responses":{"200":{"description":"Verified legal account holder name"}}}},"/v1/payouts/transfer":{"post":{"tags":["2. Payouts & NIP Transfers"],"summary":"Disburse Instant Express NIP Transfer (Single Payout)","description":"Executes an instant sub-second transfer to any Nigerian commercial bank account with atomic ledger debit.","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"amount":{"type":"number","example":50000},"destinationBankCode":{"type":"string","example":"058"},"destinationAccountNumber":{"type":"string","example":"0123456789"},"destinationAccountName":{"type":"string","example":"Olumide Johnson"},"narration":{"type":"string","example":"Contractor settlement"},"reference":{"type":"string","example":"PO-2026-001"}},"required":["amount","destinationBankCode","destinationAccountNumber"]}}}},"responses":{"200":{"description":"Transfer executed with NIP session ID"}}}},"/v1/payouts/bulk":{"post":{"tags":["2. Payouts & NIP Transfers"],"summary":"Disburse Bulk Batch NIP Transfers","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","example":"Monthly Creator Royalties"},"transfers":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"destinationBankCode":{"type":"string"},"destinationAccountNumber":{"type":"string"},"destinationAccountName":{"type":"string"}}}}},"required":["transfers"]}}}},"responses":{"200":{"description":"Bulk batch processed"}}}},"/v1/cards/create":{"post":{"tags":["3. Virtual & Physical Card Issuing"],"summary":"Issue Virtual USD or NGN Mastercard / Visa","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cardHolderName":{"type":"string","example":"Tunde Adeleke"},"customerEmail":{"type":"string","example":"tunde@example.com"},"brand":{"type":"string","enum":["MASTERCARD","VISA"],"example":"MASTERCARD"},"currency":{"type":"string","enum":["USD","NGN"],"example":"USD"},"amount":{"type":"number","example":50},"spendingLimit":{"type":"number","example":5000}},"required":["cardHolderName"]}}}},"responses":{"201":{"description":"Virtual Card created with masked PAN"}}}},"/v1/cards/{cardId}/secure-data":{"get":{"tags":["3. Virtual & Physical Card Issuing"],"summary":"Reveal Decrypted Card PAN, CVV, Expiry & Billing Address","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"cardId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sensitive cardholder credentials"}}}},"/v1/cards/{cardId}/fund":{"post":{"tags":["3. Virtual & Physical Card Issuing"],"summary":"Fund Virtual Card from Merchant Treasury","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"cardId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"amount":{"type":"number","example":100}},"required":["amount"]}}}},"responses":{"200":{"description":"Card funded successfully"}}}},"/v1/bills/airtime/topup":{"post":{"tags":["4. Bills, Utilities & Telecom"],"summary":"Instant VTU Airtime Recharge","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"operatorId":{"type":"integer","example":341},"amount":{"type":"number","example":1000},"phone":{"type":"string","example":"08023456789"},"reference":{"type":"string","example":"AIR-102938"}},"required":["amount","phone"]}}}},"responses":{"200":{"description":"Airtime delivered instantly"}}}},"/v1/bills/electricity/discos":{"get":{"tags":["4. Bills, Utilities & Telecom"],"summary":"List All 11 Nigerian Electricity DISCOs","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"List of DISCO billers"}}}},"/v1/bills/electricity/recharge":{"post":{"tags":["4. Bills, Utilities & Telecom"],"summary":"Recharge Electricity & Generate 20-Digit STS Prepaid Token","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"meterNumber":{"type":"string","example":"45028192019"},"billerCode":{"type":"string","example":"BIL112"},"amount":{"type":"number","example":10000}},"required":["meterNumber","billerCode","amount"]}}}},"responses":{"200":{"description":"Token generated with kWh units"}}}},"/v1/identity/bvn":{"post":{"tags":["5. KYC & Identity Verification"],"summary":"Verify Bank Verification Number (BVN) with NIBSS","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"bvn":{"type":"string","example":"22119988776"},"firstName":{"type":"string","example":"Oluwaseun"},"lastName":{"type":"string","example":"Adeyemi"}},"required":["bvn"]}}}},"responses":{"200":{"description":"Verified BVN demographic profile"}}}},"/v1/identity/nin":{"post":{"tags":["5. KYC & Identity Verification"],"summary":"Verify National Identity Number (NIN) with NIMC","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"nin":{"type":"string","example":"12345678901"}},"required":["nin"]}}}},"responses":{"200":{"description":"Verified NIN demographic profile"}}}},"/v1/identity/cac":{"post":{"tags":["5. KYC & Identity Verification"],"summary":"Verify Corporate Affairs Commission (CAC) Registration","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rcNumber":{"type":"string","example":"9551125"}},"required":["rcNumber"]}}}},"responses":{"200":{"description":"Verified corporate registration and status"}}}},"/v1/identity/liveness":{"post":{"tags":["5. KYC & Identity Verification"],"summary":"3D Biometric Anti-Spoofing Facial Liveness Check","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"image":{"type":"string","description":"Base64 image or accessible URL","example":"data:image/jpeg;base64,..."}},"required":["image"]}}}},"responses":{"200":{"description":"Liveness confidence score, spoof probability, and anti-spoof verdict"}}}},"/v1/identity/face-match":{"post":{"tags":["5. KYC & Identity Verification"],"summary":"1:1 Biometric Facial Similarity Match","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"imageOne":{"type":"string","description":"Primary selfie image","example":"data:image/jpeg;base64,..."},"imageTwo":{"type":"string","description":"Comparison image or ID photo","example":"data:image/jpeg;base64,..."}},"required":["imageOne","imageTwo"]}}}},"responses":{"200":{"description":"Facial similarity confidence score and match level"}}}},"/v1/identity/drivers-license":{"post":{"tags":["5. KYC & Identity Verification"],"summary":"FRSC Driver License Registry Verification","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"licenseNumber":{"type":"string","example":"AAA00000AA00"},"dateOfBirth":{"type":"string","format":"date","example":"1990-08-15"}},"required":["licenseNumber"]}}}},"responses":{"200":{"description":"Driver license authenticity, validity period, and driver details"}}}},"/v1/identity/voters-card":{"post":{"tags":["5. KYC & Identity Verification"],"summary":"INEC Voter Identification Number (VIN) Verification","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"vin":{"type":"string","example":"90F5B0482019284"},"state":{"type":"string","example":"Lagos"},"lga":{"type":"string","example":"Ikeja"}},"required":["vin"]}}}},"responses":{"200":{"description":"Voter registry polling unit, ward, and voter identity"}}}},"/v1/identity/passport":{"post":{"tags":["5. KYC & Identity Verification"],"summary":"NIS Sovereign International Passport Verification","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"passportNumber":{"type":"string","example":"A10293847"},"lastName":{"type":"string","example":"Adeleke"}},"required":["passportNumber"]}}}},"responses":{"200":{"description":"Official passport validity, holder details, and expiry"}}}},"/v1/identity/document-ocr":{"post":{"tags":["5. KYC & Identity Verification"],"summary":"AI Document OCR & Holographic Tamper Analysis","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"image":{"type":"string","description":"Base64 image of document","example":"data:image/jpeg;base64,..."},"documentType":{"type":"string","enum":["NATIONAL_ID","PASSPORT","DRIVERS_LICENSE","VOTERS_CARD"],"example":"NATIONAL_ID"}},"required":["image"]}}}},"responses":{"200":{"description":"Extracted fields, MRZ validation, and authenticity score"}}}},"/v1/identity/address/ocr":{"post":{"tags":["5. KYC & Identity Verification"],"summary":"Utility Bill Proof of Address OCR Extraction","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"image":{"type":"string","description":"Base64 image of utility bill","example":"data:image/jpeg;base64,..."},"expectedAddress":{"type":"string","example":"14 Admiralty Way, Lekki, Lagos"}},"required":["image"]}}}},"responses":{"200":{"description":"DisCo provider, meter number, extracted address, and match score"}}}},"/v1/identity/address/physical":{"post":{"tags":["5. KYC & Identity Verification"],"summary":"Schedule On-Ground Physical Premises Agent Inspection","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"businessName":{"type":"string","example":"Acme Global Ventures"},"address":{"type":"string","example":"Plot 4 Commercial Avenue, Yaba"},"city":{"type":"string","example":"Lagos"},"state":{"type":"string","example":"Lagos"},"contactPhone":{"type":"string","example":"+2348012345678"},"contactPerson":{"type":"string","example":"Emeka Nwosu"},"notes":{"type":"string","example":"2nd floor, Suite 204"}},"required":["address","city","contactPhone","contactPerson"]}}}},"responses":{"200":{"description":"Inspection task ticket ID and SLA window"}}}},"/v1/identity/sim-swap":{"post":{"tags":["5. KYC & Identity Verification"],"summary":"Telco SIM Swap Fraud Detection (Identityradar)","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"phoneNumber":{"type":"string","example":"+2348031234567"}},"required":["phoneNumber"]}}}},"responses":{"200":{"description":"Carrier, swap status, and 48-hour swap alert"}}}},"/v1/identity/ip-intelligence":{"post":{"tags":["5. KYC & Identity Verification"],"summary":"IP Geolocation, VPN, Tor & Proxy Risk Scoring","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ipAddress":{"type":"string","example":"102.89.23.45"}},"required":["ipAddress"]}}}},"responses":{"200":{"description":"Fraud risk score, VPN/Tor detection, and recommendation (ALLOW/CHALLENGE/BLOCK)"}}}},"/v1/identity/email-intelligence":{"post":{"tags":["5. KYC & Identity Verification"],"summary":"Email Deliverability, Disposable Domain & Breach Risk","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","example":"director@company.com"}},"required":["email"]}}}},"responses":{"200":{"description":"Domain age, disposable status, breach history, and risk score"}}}},"/v1/identity/credit-bureau":{"post":{"tags":["5. KYC & Identity Verification"],"summary":"Credit Bureau Multi-Institutional Financial Scoring","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"bvn":{"type":"string","example":"22119988776"},"phoneNumber":{"type":"string","example":"+2348012345678"},"customerName":{"type":"string","example":"Patrick Achua"}}}}}},"responses":{"200":{"description":"Credit score (300-850), delinquent accounts, and debt summary"}}}},"/v1/identity/vehicle-plate":{"post":{"tags":["5. KYC & Identity Verification"],"summary":"FRSC Vehicle Plate & Chassis Registration Inquiry","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"plateNumber":{"type":"string","example":"KJA123AB"}},"required":["plateNumber"]}}}},"responses":{"200":{"description":"Make, model, color, chassis number, and registered owner"}}}},"/v1/otp/send":{"post":{"tags":["6. Telecom OTP & Transactional SMS"],"summary":"Send High-Priority DND-Bypass Numeric OTP","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"to":{"type":"string","example":"2348012345678"},"senderId":{"type":"string","example":"Slikpay"},"pinLength":{"type":"integer","example":6},"pinTimeToLiveMinutes":{"type":"integer","example":10}},"required":["to"]}}}},"responses":{"200":{"description":"OTP dispatched with pinId"}}}},"/v1/otp/verify":{"post":{"tags":["6. Telecom OTP & Transactional SMS"],"summary":"Verify OTP Token","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"pinId":{"type":"string","example":"pin_179068492"},"pin":{"type":"string","example":"123456"}},"required":["pinId","pin"]}}}},"responses":{"200":{"description":"OTP verification outcome"}}}},"/v1/open-banking/accounts/{accountId}":{"get":{"tags":["7. Open Banking Direct Link"],"summary":"Get Connected Bank Account Details & Real-Time Balance","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Bank account balance and metadata"}}}},"/v1/open-banking/accounts/{accountId}/statement":{"get":{"tags":["7. Open Banking Direct Link"],"summary":"Fetch Verified Bank Statements (1-12 Months)","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string"}},{"name":"period","in":"query","schema":{"type":"string","default":"last6months"}}],"responses":{"200":{"description":"Bank statements transactions & turnover totals"}}}},"/v1/escrow/create":{"post":{"tags":["8. Programmable Escrow Engine"],"summary":"Create Multi-Milestone Escrow Contract","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","example":"Purchase of 3-Bedroom Lekki Duplex"},"totalAmount":{"type":"number","example":120000000},"currency":{"type":"string","example":"NGN"},"buyer":{"type":"object","properties":{"name":{"type":"string"},"email":{"type":"string"}}},"seller":{"type":"object","properties":{"name":{"type":"string"},"email":{"type":"string"}}},"milestones":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"amount":{"type":"number"}}}}},"required":["title","totalAmount","buyer","seller"]}}}},"responses":{"201":{"description":"Escrow contract created"}}}},"/v1/escrow/{escrowId}/fund":{"post":{"tags":["8. Programmable Escrow Engine"],"summary":"Lock Buyer Funds into Escrow Trust Vault","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"escrowId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Escrow funded and locked"}}}},"/v1/escrow/{escrowId}/milestones/{milestoneId}/release":{"post":{"tags":["8. Programmable Escrow Engine"],"summary":"Release Milestone Payout to Seller","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"escrowId","in":"path","required":true,"schema":{"type":"string"}},{"name":"milestoneId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Milestone released to seller"}}}},"/v1/wallet/balance":{"get":{"tags":["9. Treasury Wallet & Ledger"],"summary":"Query Merchant Treasury Balances (NGN & Multi-Currency)","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Merchant available and ledger balances"}}}},"/v1/ledger/trial-balance":{"get":{"tags":["9. Treasury Wallet & Ledger"],"summary":"Double-Entry Accounting Balanced Trial Balance","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Audit-ready balanced financial statement"}}}},"/v1/docs/openapi.json":{"get":{"tags":["1. Core Platform & Telemetry"],"summary":"GET /v1/docs/openapi.json","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}}},"/v1/openapi.json":{"get":{"tags":["1. Core Platform & Telemetry"],"summary":"GET /v1/openapi.json","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}}},"/v1/docs/postman.json":{"get":{"tags":["1. Core Platform & Telemetry"],"summary":"GET /v1/docs/postman.json","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}}},"/v1/postman.json":{"get":{"tags":["1. Core Platform & Telemetry"],"summary":"GET /v1/postman.json","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}}},"/v1/health":{"get":{"tags":["1. Core Platform & Telemetry"],"summary":"GET /v1/health","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}}},"/v1/pricing/plans":{"get":{"tags":["1. Core Platform & Telemetry"],"summary":"GET /v1/pricing/plans","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}}},"/v1/pricing/verify/{reference}":{"get":{"tags":["1. Core Platform & Telemetry"],"summary":"GET /v1/pricing/verify/{reference}","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"parameters":[{"name":"reference","in":"path","required":true,"schema":{"type":"string"},"description":"The reference identifier"}]}},"/v1/overview/metrics":{"get":{"tags":["1. Core Platform & Telemetry"],"summary":"GET /v1/overview/metrics","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}}},"/v1/history/{category}":{"get":{"tags":["1. Core Platform & Telemetry"],"summary":"GET /v1/history/{category}","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"parameters":[{"name":"category","in":"path","required":true,"schema":{"type":"string"},"description":"The category identifier"}]}},"/v1/accounts/virtual/{accountNumber}":{"get":{"tags":["1. Core Platform & Telemetry"],"summary":"GET /v1/accounts/virtual/{accountNumber}","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"parameters":[{"name":"accountNumber","in":"path","required":true,"schema":{"type":"string"},"description":"The accountNumber identifier"}]}},"/v1/accounts/global":{"post":{"tags":["2. Domiciliary & Foreign Banking"],"summary":"POST /v1/accounts/global","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}},"get":{"tags":["2. Domiciliary & Foreign Banking"],"summary":"GET /v1/accounts/global","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}}},"/v1/accounts/domiciliary":{"post":{"tags":["2. Domiciliary & Foreign Banking"],"summary":"POST /v1/accounts/domiciliary","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}},"get":{"tags":["2. Domiciliary & Foreign Banking"],"summary":"GET /v1/accounts/domiciliary","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}}},"/v1/payouts/global":{"post":{"tags":["3. Instant Payouts & Bulk Transfers"],"summary":"POST /v1/payouts/global","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/payouts/tuition":{"post":{"tags":["3. Instant Payouts & Bulk Transfers"],"summary":"POST /v1/payouts/tuition","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/payouts/{reference}":{"get":{"tags":["3. Instant Payouts & Bulk Transfers"],"summary":"GET /v1/payouts/{reference}","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"parameters":[{"name":"reference","in":"path","required":true,"schema":{"type":"string"},"description":"The reference identifier"}]}},"/v1/cards/{cardId}/controls":{"get":{"tags":["4. Virtual Card Issuing"],"summary":"GET /v1/cards/{cardId}/controls","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"parameters":[{"name":"cardId","in":"path","required":true,"schema":{"type":"string"},"description":"The cardId identifier"}]},"post":{"tags":["4. Virtual Card Issuing"],"summary":"POST /v1/cards/{cardId}/controls","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"parameters":[{"name":"cardId","in":"path","required":true,"schema":{"type":"string"},"description":"The cardId identifier"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/cards/{cardId}/withdraw":{"post":{"tags":["4. Virtual Card Issuing"],"summary":"POST /v1/cards/{cardId}/withdraw","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"parameters":[{"name":"cardId","in":"path","required":true,"schema":{"type":"string"},"description":"The cardId identifier"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/cards/{cardId}/freeze":{"post":{"tags":["4. Virtual Card Issuing"],"summary":"POST /v1/cards/{cardId}/freeze","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"parameters":[{"name":"cardId","in":"path","required":true,"schema":{"type":"string"},"description":"The cardId identifier"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/cards/{cardId}/transactions":{"get":{"tags":["4. Virtual Card Issuing"],"summary":"GET /v1/cards/{cardId}/transactions","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"parameters":[{"name":"cardId","in":"path","required":true,"schema":{"type":"string"},"description":"The cardId identifier"}]}},"/v1/crypto/address":{"post":{"tags":["2b. Crypto Multi-Chain & FX Swap"],"summary":"POST /v1/crypto/address","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/crypto/swap":{"post":{"tags":["2b. Crypto Multi-Chain & FX Swap"],"summary":"POST /v1/crypto/swap","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/bills/airtime/operators":{"get":{"tags":["5. Value Added Services (VAS) & Utilities"],"summary":"GET /v1/bills/airtime/operators","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}}},"/v1/bills/airtime/detect":{"post":{"tags":["5. Value Added Services (VAS) & Utilities"],"summary":"POST /v1/bills/airtime/detect","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/bills/data/purchase":{"post":{"tags":["5. Value Added Services (VAS) & Utilities"],"summary":"POST /v1/bills/data/purchase","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/bills/electricity/validate":{"post":{"tags":["5. Value Added Services (VAS) & Utilities"],"summary":"POST /v1/bills/electricity/validate","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/bills/cable/plans":{"get":{"tags":["5. Value Added Services (VAS) & Utilities"],"summary":"GET /v1/bills/cable/plans","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}}},"/v1/bills/cable/renew":{"post":{"tags":["5. Value Added Services (VAS) & Utilities"],"summary":"POST /v1/bills/cable/renew","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/bills/betting/operators":{"get":{"tags":["5. Value Added Services (VAS) & Utilities"],"summary":"GET /v1/bills/betting/operators","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}}},"/v1/bills/betting/validate":{"post":{"tags":["5. Value Added Services (VAS) & Utilities"],"summary":"POST /v1/bills/betting/validate","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/bills/betting/fund":{"post":{"tags":["5. Value Added Services (VAS) & Utilities"],"summary":"POST /v1/bills/betting/fund","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/bills/internet/providers":{"get":{"tags":["5. Value Added Services (VAS) & Utilities"],"summary":"GET /v1/bills/internet/providers","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}}},"/v1/bills/internet/purchase":{"post":{"tags":["5. Value Added Services (VAS) & Utilities"],"summary":"POST /v1/bills/internet/purchase","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/bills/tolls":{"get":{"tags":["5. Value Added Services (VAS) & Utilities"],"summary":"GET /v1/bills/tolls","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}}},"/v1/bills/tolls/pay":{"post":{"tags":["5. Value Added Services (VAS) & Utilities"],"summary":"POST /v1/bills/tolls/pay","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/bills/education/pins":{"get":{"tags":["5. Value Added Services (VAS) & Utilities"],"summary":"GET /v1/bills/education/pins","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}}},"/v1/bills/education/purchase":{"post":{"tags":["5. Value Added Services (VAS) & Utilities"],"summary":"POST /v1/bills/education/purchase","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/bills/remita/validate":{"post":{"tags":["5b. Statutory Tax & Government Revenue"],"summary":"POST /v1/bills/remita/validate","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/bills/remita/pay":{"post":{"tags":["5b. Statutory Tax & Government Revenue"],"summary":"POST /v1/bills/remita/pay","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/bills/firs/validate":{"post":{"tags":["5b. Statutory Tax & Government Revenue"],"summary":"POST /v1/bills/firs/validate","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/bills/firs/pay":{"post":{"tags":["5b. Statutory Tax & Government Revenue"],"summary":"POST /v1/bills/firs/pay","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/bills/giftcards":{"get":{"tags":["5. Value Added Services (VAS) & Utilities"],"summary":"GET /v1/bills/giftcards","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}}},"/v1/bills/giftcards/order":{"post":{"tags":["5. Value Added Services (VAS) & Utilities"],"summary":"POST /v1/bills/giftcards/order","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/identity/phone-intelligence":{"post":{"tags":["6. Identity Verification & KYC/KYB"],"summary":"POST /v1/identity/phone-intelligence","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/messaging/sms":{"post":{"tags":["7. Telecom & Multi-Factor Auth"],"summary":"POST /v1/messaging/sms","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/messaging/balance":{"get":{"tags":["7. Telecom & Multi-Factor Auth"],"summary":"GET /v1/messaging/balance","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}}},"/v1/open-banking/auth":{"post":{"tags":["8. Open Banking Sync Engine"],"summary":"POST /v1/open-banking/auth","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/open-banking/accounts/{accountId}/identity":{"get":{"tags":["8. Open Banking Sync Engine"],"summary":"GET /v1/open-banking/accounts/{accountId}/identity","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string"},"description":"The accountId identifier"}]}},"/v1/escrow/{escrowId}/dispute":{"post":{"tags":["9. Programmable Escrow Engine"],"summary":"POST /v1/escrow/{escrowId}/dispute","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"parameters":[{"name":"escrowId","in":"path","required":true,"schema":{"type":"string"},"description":"The escrowId identifier"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/escrow/{escrowId}/refund":{"post":{"tags":["9. Programmable Escrow Engine"],"summary":"POST /v1/escrow/{escrowId}/refund","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"parameters":[{"name":"escrowId","in":"path","required":true,"schema":{"type":"string"},"description":"The escrowId identifier"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/ledger/statements":{"get":{"tags":["10. Treasury Wallet & Ledger"],"summary":"GET /v1/ledger/statements","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}}},"/v1/logs":{"get":{"tags":["1. Core Platform & Telemetry"],"summary":"GET /v1/logs","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}}},"/v1/counterparties":{"get":{"tags":["11. Counterparties & Beneficiaries"],"summary":"GET /v1/counterparties","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}},"post":{"tags":["11. Counterparties & Beneficiaries"],"summary":"POST /v1/counterparties","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/counterparties/{id}":{"delete":{"tags":["11. Counterparties & Beneficiaries"],"summary":"DELETE /v1/counterparties/{id}","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id identifier"}]}},"/v1/disputes":{"get":{"tags":["12. Disputes & Chargebacks"],"summary":"GET /v1/disputes","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}}},"/v1/disputes/{reference}/refund":{"post":{"tags":["12. Disputes & Chargebacks"],"summary":"POST /v1/disputes/{reference}/refund","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"parameters":[{"name":"reference","in":"path","required":true,"schema":{"type":"string"},"description":"The reference identifier"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/disputes/{reference}/resolve":{"post":{"tags":["12. Disputes & Chargebacks"],"summary":"POST /v1/disputes/{reference}/resolve","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"parameters":[{"name":"reference","in":"path","required":true,"schema":{"type":"string"},"description":"The reference identifier"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/team":{"get":{"tags":["13. Team Collaboration & RBAC"],"summary":"GET /v1/team","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}}},"/v1/team/invite":{"post":{"tags":["13. Team Collaboration & RBAC"],"summary":"POST /v1/team/invite","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/team/{id}":{"delete":{"tags":["13. Team Collaboration & RBAC"],"summary":"DELETE /v1/team/{id}","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id identifier"}]}},"/v1/audit":{"get":{"tags":["1. Core Platform & Telemetry"],"summary":"GET /v1/audit","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}}},"/v1/treasury/balances":{"get":{"tags":["17. Enterprise Treasury & Spend Management"],"summary":"Query Dual-Balance Ledger (Spend Float, Vault Reserves & Pockets)","description":"Returns real-time institutional liquidity split between T+0 Spend Float, T+3 Treasury Vault Reserves, virtual envelope pockets, and solvency metrics.","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Institutional Treasury & Solvency Balances"}}}},"/v1/treasury/book-transfer":{"post":{"tags":["17. Enterprise Treasury & Spend Management"],"summary":"Execute Zero-Fee Internal Book Transfer (Spend <-> Vault)","description":"Transfers funds instantly between Available Spend Float and Treasury Vault with atomic double-entry ledger postings.","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["fromAccount","toAccount","amount"],"properties":{"fromAccount":{"type":"string","enum":["SPEND","VAULT"]},"toAccount":{"type":"string","enum":["SPEND","VAULT"]},"amount":{"type":"number","example":100000},"currency":{"type":"string","default":"NGN","example":"NGN"},"description":{"type":"string","example":"Transfer float to Treasury Vault"}}}}}},"responses":{"200":{"description":"Book transfer executed or queued for approval"}}}},"/v1/treasury/sentinel-rules":{"get":{"tags":["17. Enterprise Treasury & Spend Management"],"summary":"Get Autonomous Liquidity Floor & Ceiling Policies","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Current Sentinel rules"}}},"post":{"tags":["17. Enterprise Treasury & Spend Management"],"summary":"Update Autonomous Floor Auto-Replenish & Surplus Sweeps","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean"},"floorThreshold":{"type":"number","example":50000},"floorReplenishAmount":{"type":"number","example":100000},"surplusCeilingThreshold":{"type":"number","example":2000000},"surplusRetainAmount":{"type":"number","example":500000},"eodSweepEnabled":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Sentinel rules updated"}}}},"/v1/treasury/sentinel/evaluate":{"post":{"tags":["17. Enterprise Treasury & Spend Management"],"summary":"Trigger Autonomous Sentinel Evaluation Run","description":"Manually evaluates live float balances and executes auto-replenishment from Vault or surplus sweeps.","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Evaluation outcome and actions taken"}}}},"/v1/treasury/pockets":{"get":{"tags":["17. Enterprise Treasury & Spend Management"],"summary":"List Virtual Sub-Account Pockets (Envelope Budgeting)","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"List of virtual envelope pockets"}}},"post":{"tags":["17. Enterprise Treasury & Spend Management"],"summary":"Create Virtual Sub-Account Pocket","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","example":"Vendor Escrow Reserve"},"category":{"type":"string","example":"custom"},"currency":{"type":"string","default":"NGN"},"targetAmount":{"type":"number","example":500000}}}}}},"responses":{"201":{"description":"Virtual pocket created"}}}},"/v1/treasury/pockets/{id}/allocate":{"post":{"tags":["17. Enterprise Treasury & Spend Management"],"summary":"Allocate Capital into Virtual Pocket","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["amount"],"properties":{"amount":{"type":"number","example":50000}}}}}},"responses":{"200":{"description":"Capital allocated successfully"}}}},"/v1/treasury/pockets/{id}/release":{"post":{"tags":["17. Enterprise Treasury & Spend Management"],"summary":"Release Capital from Pocket back to Spend Float","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["amount"],"properties":{"amount":{"type":"number","example":50000}}}}}},"responses":{"200":{"description":"Capital released successfully"}}}},"/v1/treasury/maker-checker-rules":{"get":{"tags":["17. Enterprise Treasury & Spend Management"],"summary":"Get Maker-Checker Dual Custody Policy","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Dual authorization policy"}}},"post":{"tags":["17. Enterprise Treasury & Spend Management"],"summary":"Update Maker-Checker Dual Custody Threshold","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean"},"threshold":{"type":"number","example":1000000},"requireForPayouts":{"type":"boolean"},"requireForBookTransfers":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Maker-Checker policy updated"}}}},"/v1/treasury/approvals/pending":{"get":{"tags":["17. Enterprise Treasury & Spend Management"],"summary":"List Pending High-Value Approvals Queue","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Pending approval items"}}}},"/v1/treasury/approvals/{id}/approve":{"post":{"tags":["17. Enterprise Treasury & Spend Management"],"summary":"Approve and Execute High-Value Transaction (Checker)","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Transaction approved and executed"}}}},"/v1/treasury/approvals/{id}/reject":{"post":{"tags":["17. Enterprise Treasury & Spend Management"],"summary":"Reject High-Value Transaction (Checker)","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string"}}}}}},"responses":{"200":{"description":"Transaction rejected"}}}},"/v1/treasury/hedging-rules":{"get":{"tags":["17. Enterprise Treasury & Spend Management"],"summary":"Get Autonomous FX Hedging Desk Configuration","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Hedging rules"}}},"post":{"tags":["17. Enterprise Treasury & Spend Management"],"summary":"Update Autonomous FX Hedging Rules","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean"},"triggerCurrency":{"type":"string","example":"NGN"},"targetCurrency":{"type":"string","example":"USD"},"triggerBalanceThreshold":{"type":"number","example":5000000},"hedgePercentage":{"type":"number","example":30}}}}}},"responses":{"200":{"description":"Hedging rules updated"}}}},"/v1/treasury/certificate":{"get":{"tags":["17. Enterprise Treasury & Spend Management"],"summary":"Generate Cryptographically Sealed Balance Certificate & Solvency Attestation","description":"Issues an institutional IFRS-9 / Basel III compliant balance certificate with SHA-256 Merkle root and HMAC verification signature.","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Certified Proof of Solvency document"}}}},"/v1/treasury/sweep-rules":{"get":{"tags":["1. Core Platform & Telemetry"],"summary":"GET /v1/treasury/sweep-rules","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}},"post":{"tags":["1. Core Platform & Telemetry"],"summary":"POST /v1/treasury/sweep-rules","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/security/ip-whitelist":{"get":{"tags":["14. Security & IP Whitelisting"],"summary":"GET /v1/security/ip-whitelist","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}},"post":{"tags":["14. Security & IP Whitelisting"],"summary":"POST /v1/security/ip-whitelist","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/security/scoped-keys":{"get":{"tags":["14. Security & IP Whitelisting"],"summary":"GET /v1/security/scoped-keys","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}},"post":{"tags":["14. Security & IP Whitelisting"],"summary":"POST /v1/security/scoped-keys","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/security/scoped-keys/{id}":{"delete":{"tags":["14. Security & IP Whitelisting"],"summary":"DELETE /v1/security/scoped-keys/{id}","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id identifier"}]}},"/v1/integrations/slack-discord":{"get":{"tags":["15. Alerting & Webhooks"],"summary":"GET /v1/integrations/slack-discord","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}},"post":{"tags":["15. Alerting & Webhooks"],"summary":"POST /v1/integrations/slack-discord","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/integrations/slack-discord/test":{"post":{"tags":["15. Alerting & Webhooks"],"summary":"POST /v1/integrations/slack-discord/test","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/webhooks/deliveries":{"get":{"tags":["1. Core Platform & Telemetry"],"summary":"GET /v1/webhooks/deliveries","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}}},"/v1/webhooks/deliveries/{id}/retry":{"post":{"tags":["1. Core Platform & Telemetry"],"summary":"POST /v1/webhooks/deliveries/{id}/retry","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id identifier"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/idempotency/logs":{"get":{"tags":["1. Core Platform & Telemetry"],"summary":"GET /v1/idempotency/logs","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}}},"/v1/test/simulate-inbound":{"post":{"tags":["1. Core Platform & Telemetry"],"summary":"POST /v1/test/simulate-inbound","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/test/webhooks/simulate":{"post":{"tags":["1. Core Platform & Telemetry"],"summary":"POST /v1/test/webhooks/simulate","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/support/metrics":{"get":{"tags":["16. Enterprise Support"],"summary":"GET /v1/support/metrics","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}}},"/v1/support/tickets":{"get":{"tags":["16. Enterprise Support"],"summary":"GET /v1/support/tickets","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}},"post":{"tags":["16. Enterprise Support"],"summary":"POST /v1/support/tickets","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/support/tickets/{id}":{"get":{"tags":["16. Enterprise Support"],"summary":"GET /v1/support/tickets/{id}","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id identifier"}]}},"/v1/support/tickets/{id}/reply":{"post":{"tags":["16. Enterprise Support"],"summary":"POST /v1/support/tickets/{id}/reply","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id identifier"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/support/tickets/{id}/resolve":{"post":{"tags":["16. Enterprise Support"],"summary":"POST /v1/support/tickets/{id}/resolve","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id identifier"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/support/tickets/{id}/reopen":{"post":{"tags":["16. Enterprise Support"],"summary":"POST /v1/support/tickets/{id}/reopen","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id identifier"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/pricing/current":{"get":{"tags":["1. Core Platform & Telemetry"],"summary":"GET /v1/pricing/current","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}}}},"/v1/pricing/subscribe":{"post":{"tags":["1. Core Platform & Telemetry"],"summary":"POST /v1/pricing/subscribe","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Bad Request / Validation error"},"401":{"description":"Unauthorized / Missing API Key"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/v1/flights/health":{"get":{"tags":["10. Global Flights & NDC Ticketing"],"summary":"Flight Rail Health & Global Carrier Connectivity","description":"Real-time connectivity and latency telemetry for Slikpay Global NDC & GDS Wholesale Flight Ticketing rail connected to 300+ global airlines.","responses":{"200":{"description":"Flight rail is online and operational"}}}},"/v1/flights/search":{"post":{"tags":["10. Global Flights & NDC Ticketing"],"summary":"Search Wholesale Flight Inventory (300+ Airlines)","description":"Initiate a live multi-airline inventory search across 300+ global carriers via NDC and GDS rails. Returns verified flight offers with cabin class, fare breakdown, luggage allowances, and wholesale partner pricing.","security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["origin","destination","departureDate"],"properties":{"origin":{"type":"string","example":"LOS","description":"3-letter IATA departure airport code"},"destination":{"type":"string","example":"LHR","description":"3-letter IATA arrival airport code"},"departureDate":{"type":"string","format":"date","example":"2026-11-20","description":"Departure date (YYYY-MM-DD)"},"returnDate":{"type":"string","format":"date","example":"2026-11-28","description":"Optional return date (YYYY-MM-DD)"},"adults":{"type":"integer","example":1,"description":"Number of adult passengers"},"cabinClass":{"type":"string","enum":["economy","premium_economy","business","first"],"example":"economy"},"waitForResults":{"type":"boolean","example":true},"timeoutMs":{"type":"integer","example":15000}}}}}},"responses":{"200":{"description":"Live flight offers found and retrieved"},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"}}}},"/v1/flights/search/{searchId}":{"get":{"tags":["10. Global Flights & NDC Ticketing"],"summary":"Poll Flight Search Results by Search ID","description":"Retrieve or poll aggregated airline offers for an asynchronous flight search session.","security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"parameters":[{"name":"searchId","in":"path","required":true,"schema":{"type":"string"},"description":"Unique search identifier returned from POST /v1/flights/search"}],"responses":{"200":{"description":"Search status and offer list"},"404":{"description":"Search session expired or not found"}}}},"/v1/flights/orders":{"post":{"tags":["10. Global Flights & NDC Ticketing"],"summary":"Issue Wholesale Flight Ticket (PNR & E-Ticket)","description":"Book confirmed flight reservation and generate electronic ticket with airline PNR and 13-digit ticket numbers. Automatically checks the merchant Available Spend Wallet equity in USD or NGN before ticketing.","security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["offer_id","passengers"],"properties":{"offer_id":{"type":"string","example":"off_034ka1V9eHUwPMiTVmqMC0"},"amount":{"type":"number","example":439.62},"currency":{"type":"string","example":"USD"},"clientReference":{"type":"string","example":"FLT-ORDER-10029"},"passengers":{"type":"array","items":{"type":"object","required":["given_name","family_name","born_on","email","phone_number"],"properties":{"title":{"type":"string","enum":["mr","ms","mrs","miss"],"example":"mr"},"given_name":{"type":"string","example":"John"},"family_name":{"type":"string","example":"Doe"},"born_on":{"type":"string","format":"date","example":"1990-05-15"},"gender":{"type":"string","enum":["m","f"],"example":"m"},"email":{"type":"string","format":"email","example":"john.doe@example.com"},"phone_number":{"type":"string","example":"+2348012345678"}}}}}}}}},"responses":{"200":{"description":"Ticket issued successfully with PNR and e-ticket numbers"},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"402":{"description":"INSUFFICIENT_WALLET_EQUITY: Spend wallet balance below ticket price"}}}}}}