Fuspay
WebsiteSupportDemo Meeting
  • Overview
    • Welcome
  • API ONBOARDING
    • Introduction
    • Partner Onboarding
    • Regenerate Partner Keys
    • IP Check & Whitelisting
  • API Onboarding
  • Authentication
    • Swap, Collection, & P2P Automation
  • Webhook Validation & Request Integrity
  • Currency Swap
    • Introduction
    • Authentication
      • Partner Onboarding Endpoints
      • Partner Activate Endpoint
      • Regenerate Partners Public & Private Keys
      • Digital Signature
    • User KYC
      • Create KYC
      • Verify KYC Status
      • Reconciliation
      • Post KYC Data
    • Exchange Rate
    • Buy
      • Create Order
      • Events
    • Sell
      • Create Order
      • Events
    • Transaction Resolution
      • Overview
      • Log Issue
      • Check Issue Status
    • Transaction Records
      • Pending Transaction
      • Get Single Order Endpoint
      • Get Multiple Order Endpoint
      • Sell/Payout Verification Endpoint
    • Provider/Bank Codes
  • Virtual card
    • Introduction
      • Getting Started
        • Partner Onboarding
        • Partner Activate Endpoint
    • Authentication
    • Partner
      • Create Merchant
      • List of Merchants
    • Merchant
      • Create User
      • Verify User KYC Status
      • List Users
    • User
      • Create Card
      • Fetch Cards
      • Get Card Details
    • Card
      • Fund Card
      • Freeze Card
      • Delete Card
    • Payments
      • Withdraw From Card
      • Withdrawal History
    • Transactions
      • Card Transactions
      • Export Card Transactions
      • Filter Card Transactions
    • Wallet
      • Merchant Wallet Balance
      • Card Wallet Balance
  • Collection and payout
    • Introduction
    • Onboarding
    • Getting Started for Partner
      • Partner Onboarding Endpoints
      • IP Capture & Whitelisting
      • Regenerate Partners Pub/Priv Keys
    • Getting Started for Merchant
    • Collection
      • Digital Signatures
      • Collection (GHS, KHS, ZAR)
      • Collection (Virtual Account-NGN )
      • Fetch Order
      • Assigning Virtual Accounts
        • Get Available Assignable Virtual Account
        • Check if specific account is available for use
        • Create Order- using Available Virtual Account from your Account Pool
        • Cancel Order
      • Get Mobile Money Providers
    • Payout
      • Account verification
      • Payout
      • Payout Status
      • Crypto Withdrawal
        • Wallet Balance
        • Withdrawal Payout
        • Get Withdrawal Payout Fee
      • Bank and Bank Codes
    • Transaction History
      • Get Transaction Records
  • P2p Automation
    • Integration Journey (API-Dashboard)
  • Payment and Utilities
    • Introduction
      • Sign Up
      • Compliance
      • Create an App
      • Configure App
    • Authentication
    • User Onboarding
    • Error Handling
    • Plugin (Frontend)
      • Integrating Finswich checkout via NPM or Yarn
      • Integrating the Finswich Checkout on your Vanilla Javascript app
      • Steps for integrating Finswich Checkout via Flutter
      • Pseudocode for Integrating Finswich Checkout in Application (Native iOS & Android)
    • Services (Backend)
      • Inter-wallet Transfer
      • Bank Transfer
      • Wallet Funding
      • Utility Purchases
  • KYC As A Service
    • Introduction
    • App Registration Endpoint
    • App Activate/Verify Endpoint
    • Request Verification Token
    • KYC (Individual)
      • Get KYC Types
      • Create KYC Request
      • Get Verification Status and User's Data
      • Create order with meta data
      • Migrate
    • KYC (Business)
      • Get KYC Types
      • Create KYC Request
      • Get Verification Status and User's Data
    • Face Stamp
      • Create Facestamp Order
      • Create OTP
      • Verify OTP
      • Post Transaction Data
    • KYC(Transactional)
    • Callbacks (Webhook Responses)
Powered by GitBook
On this page
  1. Collection and payout
  2. Collection
  3. Assigning Virtual Accounts

Create Order- using Available Virtual Account from your Account Pool

This endpoint is used to create an order on Intrapay.

POST https://exchanger-api.fuspay.finance/api/v1/no-auth/PartnerP2P/CreateOrder/

This endpoint puts you in charge of assigning virtual accounts to your collection orders. So to create orders this way, we have provided an endpoint above where you can get the list of available Virtual accounts (Accounts not assigned to any transaction yet) and once you get the free VA you send it along with your new order.

The intrapay merchant id is different for each account (currency) created on Intrapay. You can find your intrapay merchant id at the bottom left AFTER YOU HAVE SETUP the wallet of that currency.

The merchant secret is also different per currency. Find your merchant secret at the partner mapping screen by clicking on your name on the partner list.

Name
Type
Description

Authorization*

String

Bearer pk_partner_xxx

Content-Type*

String

application/json

Request Body

Name
Type
Description

partner_order_id*

String

Id of order generated on partners's system

amount_to_collect*

String

amount seller or buy as listed

intrapay_merchant_id*

Number

merchant id on Intrapay (this is different per account)

timestamp*

Number

Time order was signed. unix or epoch time in milleseconds (GMT+0)

order_expiration*

String

the time to be elapsed before order becomes invalid. unix or epoch time in milleseconds (GMT+0)

currency*

String

currency the buyer is paying the merchant with

partner_callback_url*

String

partner payment notification url used by IntraPay to notify Partner System about the Payment status of the order

partner_redirect_url*

String

provided by partner url to redirect buyer

signature*

String

SHA-512 of request payload signed with both merchant and partner secret key(SK_merchant_xxx+SK_partner_xxx)

assigned_virtual_account_number*

String

The virtual account picked from the get free account endpoint. eg 1234567890

partner_id*

String

The partner Id returned from the onboarding endpoint

API Callback Response

//API Response 
{
    message:"OK",
    redirect_url:""
    }
    
    //Response sent to callback URL
    {
      "status": "success",
      "messsage": "",
      "virtual_account": {
      "account_name": "",
        "bank_name": "",
        "account_number": ""
      },
      "order_details": {
      "status": "PENDING",
      "partner_order_id": "",
      "intrapay_order_reference": ""
     }
}
{
  "status": "fail",
  "messsage": "",
  "error_code": ""
}


1001 - Order is already open / pending
1002 - Order has been canceled
1003- Order has been completed
1004- Order has expired

Sample Request Body

// request body sample
{
    "partner_order_id": "Shayo_8",
    "amount_to_collect": "300",
    "timestamp": "1726059780",
    "order_expiration": "1726061000",
    "partner_id": "p890458",
    "currency": "NGN",
    "intrapay_merchant_id": "intra_merchant_999419",
    "partner_callback_url": "https://webhook.site/fd6cdcfc76eebdfb",
    "partner_redirect_url": "https://google.com",
    "assigned_virtual_account_number": "123457812",
    "signature": "ce3822ba01f064a8ed5289b8523ddd39cea25a78ec37185ee36eedb568ff8ffd994859e10716210a627dc46a5571"
}
PreviousCheck if specific account is available for useNextCancel Order

Last updated 6 months ago