Skip to main content
POST
/
v1
/
checkout
/
sessions
/
by-token
/
{token}
/
submit
Submit payment through the hosted checkout page
curl --request POST \
  --url https://sandbox.api.eqxpay.io/v1/checkout/sessions/by-token/{token}/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Checkout-Token: <x-checkout-token>' \
  --data '
{
  "rail": "mobile_money",
  "customer": {
    "phone_number": "+265991234567"
  }
}
'
{
  "session_id": "e3d4b5c6-...",
  "status": "collection_bound",
  "collection_id": "a1b2c3d4-...",
  "collection_status": "pending"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
X-Checkout-Token
string
required

Session token from checkout URL

Path Parameters

Body

application/json
​
rail
string
required

Payment rail code

Example:

"mobile_money"

​
customer
object
required

Rail-specific customer fields; must satisfy the rail capability customer_fields

Example:
{ "phone_number": "+265991234567" }

Response

​
session_id
string
required
Example:

"e3d4b5c6-..."

​
status
string
required
Example:

"collection_bound"

​
collection_id
string
required
Example:

"a1b2c3d4-..."

​
collection_status
string
required

Current collection status (created | pending | processing | ...)

Example:

"pending"