POST
/
pay
/
create
cURL
curl --request POST \
  --url https://api.development.mona.ng/pay/create \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "amount": 2000,
  "phone": "7083287899",
  "bvn": "2222222222222222",
  "name": "John Doe",
  "dob": "01-01-1990"
}'
{
  "success": true,
  "message": "Gateway checkout created",
  "transactionId": "68363964c63df477cf65fd44",
  "friendlyID": "MNA-TRC-343827",
  "url": "https://pay.mona.ng/68363964c63df477cf65fd44",
  "savedPaymentOptions": {
    "card": [
      {}
    ],
    "bank": [
      {}
    ]
  }
}

Authorizations

​
x-api-key
string
header
required

Body

application/json

Checkout session parameters

​
amount
integer
required

The amount to be paid in kobo (Nigerian minor currency unit)

Example:

2000

​
phone
string

The customer's phone number (Optional)

Example:

"7083287899"

​
bvn
string

The customer's BVN (Optional)

Example:

"2222222222222222"

​
name
string

The customer's name (Optional)

Example:

"John Doe"

​
dob
string

The customer's date of birth in DD-MM-YYYY format (Optional)

Example:

"01-01-1990"

Response

Checkout created response

​
success
boolean
required

Indicates if the request was successful

Example:

true

​
message
string
required

Success message

Example:

"Gateway checkout created"

​
transactionId
string
required

Unique identifier for the transaction (pass to SDK)

Example:

"68363964c63df477cf65fd44"

​
friendlyID
string
required

Human-readable transaction ID

Example:

"MNA-TRC-343827"

​
url
string<uri>
required

Payment URL to redirect the customer to

Example:

"https://pay.mona.ng/68363964c63df477cf65fd44"

​
savedPaymentOptions
object
required

Customer's saved payment methods