POST
/
checkout
/
create

Body

application/json
merchantId
string
required

Your Mona merchant ID

customerId
string

The ID of the customer in the Mona system. Useful to return saved payment methods without needing an additional OTP.

customerPhone
string

To pre-populate the customers' phone number in the first step of the checkout flow. Make sure to add country code.

amount
integer
required

The amount the customer is being charged, in kobo. Please note, this is the exact amount customer will be charged. To specify taxes, shipping costs or discounts please use the 'lineItems' key.

paymentOptions
any[]
required

An array of payment methods accepted in this session. Options are: card, bankTransfer and mona.

cart
object
payLineItems
object[]

A list of line items for the payment, including names and amounts.

monaEnrolment
object

Optional object to pass if you are enrolling your customer in Mona Pay by Bank

Response

200 - application/json
success
boolean
required

Status of the response

message
string
required

Message from server instructing you to pass the URL to customer.

transactionId
string
required

Status of the response

url
string
required

The gateway URL to pass to the user to complete the transaction