Skip to navigation
Transaction APITransaction

Process incremental authorization

Increases or prolongs the authorization on a customer’s payment instrument (made with Preauthorize before).

Authentication

AuthorizationBasic

Basic authentication of the form Basic <base64(username:password)>.

Path parameters

apiKeystringRequired
API Key of Connector

Request

Data which is required to process a incremental auth
merchantTransactionIdstringRequired1-50 characters
referenceUuidstringRequired1-50 characters
amountstringRequiredformat: "^(([0-9]{1,10})|([0-9]{1,10}\.[0-9]{1,3}))$"
currencyenumRequired

ISO 4217 three-letter currency code (e.g. EUR, USD, GBP).

additionalId1stringOptional1-50 characters
additionalId2stringOptional1-50 characters
referenceSchemeLifecycleIdentifierstringOptional1-50 characters
extraDatamap from strings to stringsOptional
merchantMetaDatastringOptional<=255 characters
successUrlstringOptional<=65535 characters
cancelUrlstringOptional<=65535 characters
errorUrlstringOptional<=65535 characters
callbackUrlstringOptional<=65535 characters
descriptionstringOptional<=255 characters
itemslist of objectsOptional
transactionIndicatorenumOptional
languagestringOptional=2 characters
l2l3DataobjectOptional

Response

Transaction response
successbooleanOptional
Whether the transaction was processed successfully.
uuidstringOptional

IXOPAY's unique identifier for this transaction. Use this to reference the transaction in later calls (e.g. capture, void, refund).

purchaseIdstringOptional

IXOPAY's human-readable purchase identifier for this transaction.

returnTypeenumOptional

How to continue the transaction — a final result (FINISHED/ERROR), or that further customer interaction is required (REDIRECT/HTML/PENDING/PENDING_DCC).

redirectTypeenumOptional

When returnType is REDIRECT, how the customer should be sent to redirectUrl (full-page redirect, iframe, or a 3-D Secure challenge).

Allowed values:
redirectUrlstringOptional<=255 characters
URL to send the customer to when further interaction is required.
redirectQRCodestringOptional
DataUrl
htmlContentstringOptional
Raw HTML to render to the customer when returnType is HTML.
paymentDescriptorstringOptional
Short descriptor shown on the customer's statement for this transaction, where supported by the acquirer.
paymentMethodstringOptional

Payment method used for this transaction (e.g. Creditcard, PayPal).

adapterMerchantTransactionIdstringOptional1-64 characters

Adapter/PSP-side merchant transaction identifier recorded for transaction matching and reconciliation. Omitted when unavailable.

returnDataobjectOptional
scheduleDataobjectOptional
customerProfileDataobjectOptional
riskCheckDataobjectOptional
errorslist of objectsOptional
adapterMessagestringOptional

Raw error message returned by the underlying PSP/adapter for this transaction, where available.

adapterCodestringOptional

Raw error code returned by the underlying PSP/adapter for this transaction, where available.

extraDatamap from strings to stringsOptional
dccDataobjectOptional