Sign in

v1

latestOpenAPI 3.0.02026-07-2436163302.7 KB

Submit a business response

Submit a business response to a previously received transaction.

Business response must reference the transaction you want to respond to.

Use /response endpoint to submit a business response.

post/v1/transactions/response

Request body

country_codestring

ISO 3166-1 alpha-2 uppercase country code the transaction is taking place in.

Validations:

  • The /transactions/response endpoint is not supported for this country.
notestring

A text note attached to a transaction. Notes are HTML enabled and will be displayed on the visual document.

Validations:

  • Maximum length: 3000
reference_transaction_idstring required

The external transaction identifier of the original transaction the response is referencing. e.g., MY_ORIGINAL_IDENTIFIER_0001

Validations:

  • Maximum length: 150
  • Required property
transaction_datestring required

RFC3339 datetime string representing the point in time when transaction is executed.

Validations:

  • Required property
  • Must be an RFC3339 format date
transaction_idstring required

External transaction identifier provided by the customer. e.g., MY_RESPONSE_IDENTIFIER_0001

Validations:

  • Maximum length: 150
  • Required property

Example request

{
  "note": "This is my HTML <e>enabled</e> note.",
  "tax_reason": {
    "code": "S01",
    "description": "S01",
    "tax_reason_details": [
      {
        "code": "S01",
        "note": "S01"
      }
    ]
  }
}

Response

Accepted - business response was successfully submitted for processing.

messagestring

Information about the failure reason in case the request was unsuccessful.

operation_idstring

Auto-generated unique identifier of a transaction operation returned upon async operation request.

transaction_idstring

The unique external transaction identifier provided with the initial request.