# Request Format

act always
The type of event that happened, values can be payment_started, payment_updated, payment_confirmed
options always
The optional string that can be passed on the initial payment request.
this can be null
reference_id always
Unique reference you your system (sessionid, paymentid). This is passed on the initial payment request.
payment_request_id always
The ID of the payment request received on the request-payment API request
payment_id always
The ID of the payment
status conditional
The status of the payment

This is present on payment_updated act.

Single Payments and QR Payments: COMPLETED, PENDING, FAILED.
Periodic Payments: SCHEDULED, PENDING, FAILED.
date_scheduled conditional
The status estimate date of the next payment

This is present on payment_updated act for periodic payments.

# Payment Status:

TIP

Single Payments and QR / Link Payments
A payment can be considered successful when the status is COMPLETED. Initiation request has passed validation checks and been accepted by the Bank. Settlement is expected to happen in due course.

Periodic Payments
A payment can be considered scheduled when the status is SCHEDULED. The estimate date of the first payment will be present on the callback request (date_scheduled)

payment_confirmed act is triggered when we have the confirmation that the funds are received.

WARNING

First payment date is different for each bank and it can take up to 5 working days!