AFT Payment Request

Initiate an Account Funding Transaction (AFT) to fund an account from a card.

Endpoint Information

Name: Account Funding Transactions Payment Request
Method: POST
URL: {{BASE_URL}}/api/v1/payment/request

Description

Account Funding Transactions (AFT) are used to pull funds from a card to deposit into an account (e.g., wallet top-up, prepaid card loading).

Authentication

Type: Basic Auth

• Username: App Key
• Password: Secret Key

Request Body

Content-Type: application/json

{
  "firstName": "wx",
  "middleName": "",
  "lastName": "yz",
  "reference": "XYOCJXEBF20",
  "email": "[email protected]",
  "dob": "1994-12-20",
  "contactNumber": "01234567890",
  "merchantAccountId": "100012",
  "address": "Dhaka, Bangladesh",
  "country": "Bangladesh",
  "state": "Dhaka",
  "city": "Dhaka",
  "zipCode": "11115",
  "currency": "USD",
  "amount": "10",
  "ttl": "10",
  "tagName": "",
  "solutionUniqueId": [
    ""
  ],
  "additionalInfo": {  // required for AFT payment
    "aft": {
      "accountNumber": "123456789",
      "accountType": "ACCOUNT",
      "customerCountryIso2a": "BD",
      "customerFirstName": "John",
      "customerLastName": "Danny"
    }
  },
  "requestType": "aft"  // required for AFT payment
}

Key Parameters

Parameter	Type	Required	Description
requestType	string	Yes	Must be set to "aft"
additionalInfo	object	Yes	Container for AFT details
additionalInfo.aft	object	Yes	Specific AFT transaction details
additionalInfo.aft.accountNumber	string	Yes	The account number receiving funds
additionalInfo.aft.accountType	string	Yes	Type of account (e.g., "ACCOUNT")
additionalInfo.aft.customerCountryIso2a	string	Yes	Customer's 2-letter country code (ISO 3166-1 alpha-2)
additionalInfo.aft.customerFirstName	string	Yes	First name of account holder
additionalInfo.aft.customerLastName	string	Yes	Last name of account holder

All other basic parameters are the same as the standard Payment Request.

Response

Success Response

{
  "success": true,
  "message": "Payment Request Accepted",
  "data": {
    "payment_url": "https://sgw.paymid.com/secure-checkout/d02da6a7-c62e-4a13-b46a-35877fdb2597",
    "reference": "XYOCJXEBF517",
    "session_id": "d02da6a7-c62e-4a13-b46a-35877fdb2597"
  }
}

Related Endpoints

• Standard Payment Request - Standard purchase transaction