menu

Payment API

What's on this page

API Reference / Transaction Confirm

Transaction confirm

Payments are scanned for fraudulent activity and if a payment is seen as suspicious, it will be flagged, meaning manual approval is required. This is exposed in the payment status with the manualApprovalRequired field set to true. A transaction in this situation will remain pending until it is either manually approved or rejected by contacting support. Upon confirmation:

  • If the transaction is approved, processing will continue
  • If the transaction is rejected, the status is updated to FAILED and the failure code is set to REJECTED

The transaction processing is an asynchronous process and will update the status after an undetermined time. If you have webhooks configured, you’ll be notified accordingly. If not, you should poll the transaction until a final status is reached.

Confirm transaction request

The confirm transaction request is used to manually approve or reject a transaction.

  • Resource: /api/v1/transaction/confirm
  • Method: POST
  • Content-Type: application/json
  • Authentication: basic auth
  • Parameters
Name Required Description
reference Yes The transaction to approve
note Yes A text message that will be attached to the transaction
action Yes Possible values: approve or reject

Example

{
  "reference" : "C1507301136356120.1",
  "note" : "This transaction was considered OK after manual inspection",
  "action" : "approve"
}

Confirm transaction response

  • Status Code: 200
  • Content Type: application/json
  • Content: No content