POST
/
collections
/
requestToPay
/
addFakeTransaction
cURL
curl -X POST "https://api.onekhusa.com/sandbox/v1/collections/requestToPay/addFakeTransaction" \
  --header "Authorization: Bearer your-jwt-token" \
  --header "Content-Type: application/json" \
  --header "Accept-Language: en" \
  --header "X-Idempotency-Key: your-idempotency-key" \
  -d '{
    "merchantAccountNumber": 12345678,
    "transactionAmount": "8375000.00",
    "connectorId": 212188,
    "timedAccountNumber": "11005533",
    "currencyCode": "MWK",
    "capturedBy": "username@example.com"
  }'
"The fake request-to-pay transaction added successfully"

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer , where is your access token.

Headers

​
Accept-Language
string
default:en

Preferred language for the response

​
X-Idempotency-Key
string

A unique key to ensure idempotent requests

Body

application/json
​
merchantAccountNumber
integer
required

An active account number for the merchant used to initiate a request-to-pay transaction.

Example:

12345678

​
transactionAmount
string
required

The total transaction (checkout) amount the customer is supposed to pay for the initiated transaction.

Example:

"8375000.00"

​
connectorId
integer
required

The unique number representing the institution (bank/MNO) a customer used to pay for the merchant goods/services.

Example:

212188

​
timedAccountNumber
string
required

The generated temporary (short-lived) account number tied to an initiated request-to-pay transaction.

Example:

"11005533"

​
currencyCode
string
required

The currency code associated with a transaction and should match with merchant account currency defined.

Example:

"MWK"

​
capturedBy
string<email>
required

The user registered under the merchant account being used.

Example:

"username@example.com"

Response

200 - application/json

Success Response (200)

Success message