Advance Payment

The API endpoint to make an advance payment is POST /Smart/Transaction/STX_xxx/start/prepaid. There is no prior authorisation needed.

POST /api/v2/Smart/Transactions/STX_xxx/start/prepaid HTTP/1.1
Authorization: Bearer qb56tjj1bcvo9n2nj4u38k84lo
Accept: application/json

If everything is fine, the API responds with 200 OK and a representation of the Smart Transaction:

HTTP/1.1 200 OK
Content-Type: application/json
"object": "smart.transactions",
// ...
"transactions": [
"object": "payment.transactions",
// ...
"created": "2020-03-27T10:55:23+01:00",
"status": "pending",
// ...

The Smart Transaction will change to status pending to signalise that we still wait for the payment. When the payment has arrived, it switches to ok (intent sale), and you can deliver.