Sign in
external-payments

Get a payment

Add ?live=true to ask the gateway for the current status while the payment is still pending.

get/v1/payments/{refNo}

Path parameters

refNostring required
Example:RP1757150000000A1B2

Query parameters

livestring
Example:true

Set to 'true' to ask the gateway for the live status when the payment is still pending.

Response

refNostring required
clientReferencestring
gatewaystring required
status'pending' | 'processing' | 'success' | 'failed' | 'cancelled' | 'refunded' | 'expired' required
amountstring required
currencystring required
descriptionstring required
paymentUrlstring

Send the customer here. Present while the payment can still be paid.

returnUrlstring required
gatewayTransactionIdstring
bankReferencestring
responseCodestring

Raw gateway result code (RevPay Appendix C)

errorDescriptionstring
paymentMethodstring

RevPay Payment_ID actually used

refundedAmountstring required
createdAtstring date-time required
completedAtstring date-time

Example response

{
  "refNo": "RP1757150000000A1B2",
  "clientReference": "INV-1001",
  "gateway": "revpay",
  "amount": "52.40",
  "currency": "MYR",
  "description": "Order #1001",
  "refundedAmount": "0.00"
}

Changes

Changed in 1 of the 4 revisions of this API.1