Skip to main content

- Create, Hold, Confirm

Withdrawal method using (Create, Hold, Confirm)​

Use this method if you want Xprizo to do the final check ie Xprizo checks that the transaction has been created on the platform by sending a callback and waiting for a valid response. Based on the response from the platform, Xprizo with either commit the transaction or void it.

Using this method, Xprizo will create a transaction and put it on hold. It will then send a callback to check that the platform has successfully updated the transaction on their side. If Xprizo gets a positive response then the transaction will be completed. If a negative response is received or there is no response for 24 hrs then the transaction will be voided.

The Process is as follows:

  • Create a pending transaction on your system
  • Create a payment transaction on Xprizo and wait for the response. api/Transaction/SendPayment?action=2
    • Xprizo will create a transaction marked as ‘Hold’ and return 200 (success)
    • If you get the 200 (success) response then leave your transaction as pending
    • If the transaction failed with any error 400,401,403,500 excluding a timeout mark the transaction as rejected (Xprizo automatically deleted failed transactions)
  • Xprizo will a send callback to the platform (make sure you have the "Payment Webhook" setup in Xprizo) api/Preference/SetPaymentWebhook
    • You should now set the transaction on your platform as paid and respond to the callback with 200 (success) response.
    • It is recommended to check the status of the transaction on Xprizo to ensure that is completed api/Transaction/StatusByReference
    • Xprizo will keep sending callbacks until the platform responds
    • If your platform does not response for 24 hours
      • The transaction is voided
      • Funds released back to the merchant
    • If the platform responds with a success
      • The Hold is removed and the transaction is marked as active
    • If the platform responds with an error
      • The transaction is voided
      • Funds released back to the merchant