How to query payment status after CheckoutID has expired


If you need to pull the transaction response from our system after the checkout ID has expired, there are several options to do this.


Option 1

What you need to query transaction status:

This call requires you to have the "merchantTransactionId" value that represents your order reference. You would need to send this value in the payment request, to us to make sure you can query using it later. If you do not send this value, this API call cannot be used.

You would also need your Peach Payments API authentication parameters. Summary of required parameters for this call below :
MerchantTransactionId (This is your merchant order number)

Please see recommended parameters to include in checkout request.

The sample API call to pull a transaction response from the system using the "MerchantTransactionId" value looks like this:


The final response delivered to your system looks like this (this is just a sample):

payload: {"id":"8a82944a5028ad6xxxxxxxx1ed285180","registrationId":"8a829449xxxxxxxx01503771eaf4533b","paymentType":"DB","paymentBrand":"VISA","amount":"2000.00","currency":"ZAR","descriptor":"9347.7571.8562 PP01 Nedbank","result":{"code":"000.100.110","description":"Request successfully processed in 'Merchant in Integrator Test Mode'"},"card":{"last4Digits":"*","holder":"Johnny Bravo","expiryMonth":"12","expiryYear":""},"risk":{"score":""},"timestamp":"2015-10-05 10:00:24+**","ndc":"4B7BFA7xxxxxx4627B49ECA42.sbg-vm-tx02"}

Please note the above endpoint applies to the TEST system. Please see documentation for your LIVE endpoint. 


Option 2

The requires the

  • Unique ID from the payment
  • userID
  • Password
  • entityId

Should you have any questions, feel free to email us at

Have more questions? Submit a request


Powered by Zendesk