Capture

POST 
/:apiKey/capture

Records a capture transaction.

warning

Either referenceTransactionId or referenceUuid must be provided.

Request

Path Parameters

apiKey stringrequired

Possible values: <= 50 characters

API key of connector.

application/json

Body

required

transactionId stringrequired

Possible values: non-empty and <= 50 characters

Your unique transaction ID.

referenceTransactionId string

Reference to the related Register, Debit, or Preauthorize containing the merchant's reference (transactionId).

referenceUuid string

Possible values: <= 50 characters

Reference to the related Register, Debit, or Preauthorize containing the transaction reference (uuid).

amount Amount (string)required

Possible values: Value must match regular expression ^(([0-9]+)|([0-9]+\.[0-9]{1,3}))$

Decimal amount separated by ., maximum of 3 decimals.

currency Currency (string)required

Possible values: Value must match regular expression ^[A-Z]{3}$

ISO 4217 three-letter currency code.

status TransactionStatus (string)

Possible values: [success, failed, error_adapter, error_internal, cancelled]

Default value: success

Status of Transaction.

adapterTxId string

Possible values: <= 50 characters

PSP's reference of Transaction.

adapterToken string

Possible values: <= 50 characters

Token given by the adapter.

createdAt date-time

Date/Time of transaction processing, defaults to now().

RFC 3339 Internet Date/Time Format date-time

additionalId1 string

Possible values: <= 50 characters

Any additional ID if required by the Adapter.

additionalId2 string

Possible values: <= 50 characters

Any additional ID if required by the Adapter.

merchantMetaData string

Possible values: <= 255 characters

Additional metadata for the merchant.

description string

Possible values: <= 255 characters

Description of your transaction.

extraData

object

Object containing key-value pairs (string-to-string), to be used by either the upstream Adapter, the Risk Engine etc.

property name* string
descriptor string

Possible values: <= 50 characters

Descriptor which is printed on card-holder's statement.

error

object

Error/Decline reason data.

message stringrequired

Possible values: <= 60 characters

Error message.

code stringrequired

Possible values: <= 20 characters

Error code.

adapter_error_message stringrequired

Possible values: <= 65535 characters

Error message of PSP.

adapter_error_code string

Possible values: <= 20 characters

Error code of PSP.

created date-time

Date and time of error, defaults to now().

RFC 3339 Internet Date/Time Format date-time.

Responses

200

Push transaction response.

application/json

Schema

Schema

success

string

required

Possible values: [true, false]

Whether the request was successful or not.

true

uuid string

The assigned transaction uuid.

false

error_message string

On error, this field will contain a description of the error.

error_code string

Possible values: [MISSING_FIELDS, INVALID_DATA, DUPLICATE_ID, INVALID_REFERENCE]

The error code.

property name* any

Example (from schema)

{
  "success": true
}

Success

{
  "success": true,
  "uuid": "12c0b3f4aa1d02d1608a"
}

Error

{
  "success": false,
  "error_message": "The following fields are missing: registrationId",
  "error_code": "MISSING_FIELDS"
}

Loading...