Events

Events for the lifecycle of a payment

EventDescription
CREATEDSends / Receive request has been submitted and is undergoing initial validation. It will automatically be moved to PENDING_APPROVAL. No action needed.
PENDING_APPROVALSends / Receive request is pending action from client to accept/deny the returned request. If denied, payment will be marked as FAILED. If request is not acted upon within 5m (10m in sandbox environment), the transaction will be marked as EXPIRED
PROCESSSends / Receive has been accepted and put up for processing, where we do some final checks on the transaction. This typically lasts a second, before being updated to PROCESSING
PROCESSINGSends / Receive is being broadcasted on the selected channel, on successful broadcast transaction will be marked as PENDING, otherwise it will retry until it goes through or eventually mark itself as FAILED.
PENDING_LIQUIDITYSend has not been accepted for processing yet, due to low balance on your account, once balance top-up is complete, payment is automatically moved to PROCESSING, if not it moves to FAILED state after 2 hours in this state.
PENDINGSends / Receive is no longer an internal Yellow Card transaction, has been broadcasted on the channel, and is awaiting results to finalize.
COMPLETESends / Receive has succeeded on sending to the destination and is at the end state.
FAILEDSends / Receive has failed on sending to the destination and is at the end state.
PENDING_REFUNDReceive refund request is received and is queued for processing.
REFUND_PROCESSINGReceive refund request is being processed, waiting for feedback from payment provider.
REFUND_FAILEDWe’ve tried to refund the receive 5 times and it failed from provider's end, advisable
to resend a refund request after a few hours.
REFUNDEDReceive refund is complete, refund has been received by the customer.
CANCELLEDReceive request has been cancelled and would be refunded if we
receive payment for the receive.
EXPIREDSends / Receive was not accepted/denied within expiry timeframe and is at the end state.

Did this page help you?