Skip to main content

Receive Payment Status Updates

CRITICAL STEP

You need to have specified your custom endpoints for Payment Status Update Callback in the Pay iO integration page

With the Pay iO payment process, there are 3 possible outcomes:

  1. Payment Completed : The payment was processed successfully, and we got confirmation of the bank transfer from the bank.
  2. Payment Failed : The payment failed or was cancelled. The most common cause are insufficient funds, customer details incorrect, merchant details incorrect, the customer decided to not go through with the payment, or something went wrong on the side of the bank. In this case, we do not send an update to your store so that the customer can try the payment again with a different bank.
  3. Payment Pending : The payment couldn't be processed within the usual time, and is pending. We will send an update to your store when the status update to either completed or failed. You will have to inform your customer on this payment resolution.

Pay iO server send a POST request to your custom endpoint using the following structure:

{
  "orderId": "Your publicly facing order reference",
  "status": "COMPLETED, PENDING or FAILED",
  "secureToken": "Token provided when the transaction was first created"
}

Payment success page​

Once the payment is successful, the customer will then be redirected to your store using the paymentSuccessUrl provided during the transaction creation.

Back to Checkout page​

If the payment failed, or if the customer decide to use a different payment method, we will redirect them to the checkoutUrl provided during the transaction creation.