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
Your unique transaction ID.
Possible values: non-empty and <= 50 characters
Example: c5f2accd-2c37-4b2c-bb03-22d168c25a74
referenceTransactionId string
Reference to the related Register, Debit, or Preauthorize containing the merchant's reference (transactionId).
Example: ed0687ad-a876-42fd-bfc2-ce7c91d9700d
referenceUuid string
Reference to the related Register, Debit, or Preauthorize containing the transaction reference (uuid).
Possible values: <= 50 characters
Example: 20230315-6d432fb7217843388847
amount Amount (string)required
Decimal amount separated by ., maximum of 3 decimals.
Possible values: Value must match regular expression ^(([0-9]+)|([0-9]+\.[0-9]{1,3}))$
Example: 9.99
currency Currency (string)required
ISO 4217 three-letter currency code.
Possible values: Value must match regular expression ^[A-Z]{3}$
Example: EUR
status TransactionStatus (string)
Status of Transaction.
Possible values: [success, failed, error_adapter, error_internal, cancelled]
Default value: success
adapterTxId string

PSP's reference of Transaction.

Possible values: <= 50 characters

adapterToken string

Token given by the adapter.

Possible values: <= 50 characters

createdAt date-time
Date/Time of transaction processing, defaults to now().
RFC 3339 Internet Date/Time Format date-time
Default value: null
Example: 2001-02-03T04:05:06+02:00
additionalId1 string

Any additional ID if required by the Adapter.

Possible values: <= 50 characters

additionalId2 string

Any additional ID if required by the Adapter.

Possible values: <= 50 characters

merchantMetaData string

Additional metadata for the merchant.

Possible values: <= 255 characters

description string
Description of your transaction.
Possible values: <= 255 characters
Example: My Purchase Order 123

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
Descriptor which is printed on card-holder's statement.
Possible values: <= 50 characters
Example: Order# 123

error

object

Error/Decline reason data.

message stringrequired

Error message.

Possible values: <= 60 characters

Example: Transaction declined.

code stringrequired

Error code.

Possible values: <= 20 characters

Example: 3002

adapter_error_message stringrequired

Error message of PSP.

Possible values: <= 65535 characters

Example: Do not honour

adapter_error_code string

Error code of PSP.

Possible values: <= 20 characters

Example: 5

created date-time

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

RFC 3339 Internet Date/Time Format date-time.

Example: 2001-02-03T04:05:06+02:00

Responses

200

Push transaction response.

application/json

Schema

Schema

success

string

required

Whether the request was successful or not.

Possible values: [true, false]

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

The error code.

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

property name* any

Example (from schema)

{
  "success": true
}

Success

Success

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

Error

Error

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

Loading...