Transactions

Get an online transaction

API to return details of a given online transaction by its authentication id. <br><strong>Access Token Required scope:</strong> transactions/online/id/get

get/v2/transactions/online/{authentication_id}

Request

Path parameters

authentication_idstring uuid required

The unique identifier for the new transaction by its authentication id

Example:5f7b1a3a-3b7a-4b1a-9b1a-3a3b7a4b1a9b

The authentication id

Headers

User-Agentstring required
Example:YourCompany-Integration/1.0

Identifies your integration, for example YourCompany-Integration/1.0. Requests without a User-Agent can be blocked by our firewall before they reach the API.

Response

Transaction has been returned

authentication_idstring uuid required

The unique identifier for the authentication

created_atstring date-time required

The datetime that the transaction was created (ISO 8601 format)

status'SUCCESS' | 'FAILURE' | 'PENDING' required

The status of the transaction

status_reason'ACCOUNT_INVALID' | 'BLOCKED_CARD' | 'BLOCKED_CROSS_BORDER_TRANSACTION' | 'AMOUNT_TOO_SMALL' | 'CANNOT_VALIDATE_AUTHENTICATION' | 'CARD_COUNT_EXCEEDED' | 'CARD_DECLINED' | 'CARD_EXPIRED' | 'CARD_LIMIT_EXCEEDED' | 'CARD_NOT_ACTIVE' | 'DISABLED_ACCOUNT' | 'DO_NOT_HONOR' | 'ECOM_NEGATIVE_CARD_AUTHENTICATION_VERIFICATION' | 'EXCEEDS_AMOUNT_LIMIT' | 'FORMAT_ERROR' | 'INCORRECT_CARD_AUTHENTICATION' | 'INSUFFICIENT_FUNDS' | 'INVALID_CARD_NUMBER' | 'INVALID_TRANSACTION' | 'ISSUER_DECLINED' | 'LOST_OR_STOLEN' | 'MERCHANT_CONFIGURATION' | 'NEGATIVE_BALANCE' | 'PIN_LIMIT_EXCEEDED' | 'PROCESSOR_UNAVAILABLE' | 'RESTRICTED_CARD' | 'SCA_PIN_REQUIRED' | 'SCA_REQUIRED' | 'SUSPECTED_FRAUD' | 'TEMPORARY_ISSUE_RETRY' | 'TIMEOUT' | 'TRANSACTION_NOT_ALLOWED' | 'UNABLE_TO_ROUTE_TRANSACTION' | 'UNSUPPORTED_ISSUER' | 'FEATURE_NOT_ACTIVATED_MANUAL_ENTRY' | 'FEATURE_NOT_ACTIVATED_PAY_BY_LINK' | 'FEATURE_NOT_ACTIVATED_ECOMMERCE' | 'FEATURE_NOT_ACTIVATED_UNREFERENCED_REFUNDS' | 'OTHER' enum

Detailed reasons for the transaction failure status. This is provided when the transaction response status is FAILURE and is null when the payment succeeds or is pending.

transaction_idstring uuid required

The unique identifier for the new transaction

updated_atstring date-time required

The datetime that the transaction was updated (ISO 8601 format)

Example response

{
  "authentication_id": "5f7b1a3a-3b7a-4b1a-9b1a-3a3b7a4b1a9b",
  "created_at": "2022-03-01T15:29:59Z",
  "issuer_result": {
    "approval_code": "123456",
    "response_code": "00"
  },
  "status": "SUCCESS",
  "transaction_id": "5f7b1a3a-3b7a-4b1a-9b1a-3a3b7a4b1a9b",
  "updated_at": "2022-03-01T15:35:00Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.