Process a register

Registers a customer’s payment instrument for future use (Debit or Preauthorize).

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 register

merchantTransactionIdstringRequired1-50 characters

Your own unique identifier for this registration. Must be unique per merchant.

additionalId1stringOptional1-50 characters

Optional free-form identifier for your own reconciliation (e.g. order or invoice number).

additionalId2stringOptional1-50 characters

A second optional free-form identifier for your own reconciliation.

extraDatamap from strings to stringsOptional

pspPassthroughDatamap from strings to stringsOptional

merchantMetaDatastringOptional<=255 characters

Opaque metadata echoed back unchanged in callbacks and the transaction status response.

successUrlstringOptional<=65535 characters

URL the customer's browser is redirected to after successfully registering their payment instrument.

cancelUrlstringOptional<=65535 characters

URL the customer's browser is redirected to if they cancel a redirect-based registration flow.

errorUrlstringOptional<=65535 characters

URL the customer's browser is redirected to if a redirect-based registration flow fails.

callbackUrlstringOptional<=65535 characters

Server-to-server URL IXOPAY calls with the final registration result; overrides the connector's configured default callback URL.

transactionTokenstringOptional

Token identifying a previously tokenized/stored payment instrument, instead of raw card data.

descriptionstringOptional<=255 characters

Free-text description of the registration, shown to the customer or PSP where supported.

transactionIndicatorenumOptional

Classifies the transaction for card-scheme compliance (e.g. recurring, card-on-file, MOTO) — required by some acquirers/schemes for off-session charges.

customerobjectOptional

scheduleobjectOptional

customerProfileDataobjectOptional

threeDSecureDataobjectOptional

payByLinkobjectOptional

languagestringOptional=2 characters

Two-letter language code (ISO 639-1) used to localize the hosted payment page shown to the customer.

l2l3DataobjectOptional

referenceUuidstringOptional1-50 characters

UUID of a previous register transaction on the same merchant. Used by the register-with-expiry-update flow to point at the existing token whose expiry date should be patched. When set together with extraData.expiryMonthUpdate / expiryYearUpdate, the request becomes a card-data-less expiry refresh — no PAN/CVV is required.

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