Parameter mapping classic integration - Direct integration
To process transactions with Direct you need to provide certain information in your request. For the classic integration, you use a set of parameters for each integration mode. The most common parameters for each classic integration mode are:
| Classic integration mode |
Classic parameters |
|---|---|
| PSPID ORDERID CURRENCY AMOUNT LANGUAGE SHASIGN OPERATION |
|
|
ACCOUNT.PSPID ALIAS.STOREPERMANENTLY |
|
| PSPID ORDERID USERID PSWD AMOUNT CURRENCY CARDNO ED CN SHASIGN CVC browserAcceptHeader browserColorDepth browserJavaEnabled browserLanguage browserScreenHeight browserScreenWidth browserTimeZone browserUserAgent ACCEPTURL DECLINEURL EXCEPTIONURL LANGUAGE FLAG3D OPERATION |
In Direct, these parameters translate to properties in JSON format. To help you re-create your classic integration for the new platform, we provide a mapping of these classic parameters with Direct properties. Check out API Reference for a full overview of available properties.
|
Classic parameter |
Direct property |
|---|---|
| PSPID |
N/A PSPID routing is covered by the SDK initialisation/By replacing {merchantId} in the API resource. Learn more in our dedicated Authentication guide |
| ORDERID |
order.references.merchantReference Not mandatory for Direct. If omitted, our platform will generate a random string |
| CURRENCY | amountOfMoney.currencyCode |
| AMOUNT |
amountOfMoney.amount Not mandatory for Direct. If omitted, our platform will take the language configured in your Back Office (Configuration > Account > Your administrative details > Language) |
| LANGUAGE |
hostedCheckoutSpecificInput.locale Not mandatory for Direct. If omitted, our platform will take the language configured in your Back Office (Configuration > Account > Your administrative details > Language) |
| SHASIGN |
N/A Authentication is covered in the SDK initialisation/manual authentication for requests sent directly to our API. Learn more in our dedicated Authentication guide |
| OPERATION | cardPaymentMethodSpecificInput.authorizationMode |
| ACCOUNT.PSPID |
N/A PSPID routing is covered by the SDK initialisation/By replacing {merchantId} in the API resource. Learn more in our dedicated Authentication guide |
| ALIAS.ALIASID | tokens |
| ALIAS.ORDERID | N/A |
| ALIAS. STOREPERMANENTLY |
askConsumerConsent |
| CARD. PAYMENTMETHOD |
N/A |
| LAYOUT. TEMPLATENAME |
variant |
| PARAMETERS. ACCEPTURL |
N/A Is covered bycardPaymentMethodSpecificInput.returnURL in the subsequent Server-to-server/ CreatePayment request with the tokenised credit card profile |
| PARAMETERS. EXCEPTIONURL |
N/A Not applicable. Is covered by cardPaymentMethodSpecificInput.returnURL in the subsequent Server-to-server/ CreatePayment request with the tokenised credit card profile |
| SHASIGNATURE. SHASIGN |
N/A Authentication is covered in the SDK initialisation/manual authentication for requests sent directly to our API. Learn more in our dedicated Authentication guide |
| CARD.BRAND | N/A |
| CARD. PAYMENTMETHOD |
N/A |
| LAYOUT. LANGUAGE |
locale |
| USERID |
N/A Authentication is covered in the SDK initialisation/manual authentication for requests sent directly to our API. Learn more in our dedicated Authentication guide |
| PSWD |
N/A Authentication is covered in the SDK initialisation/manual authentication for requests sent directly to our API. Learn more in our dedicated Authentication guide |
| CARDNO | cardPaymentMethodSpecificInput.card.cardNumber |
| ED | cardPaymentMethodSpecificInput.card.expiryDate |
| CN | cardPaymentMethodSpecificInput.card.cardholderName |
| CVC | cardPaymentMethodSpecificInput.card.cvv |
| browserAcceptHeader | order.customer.device.acceptHeader |
| browserColorDepth | order.customer.device.browserData.colorDepth |
| browserJavaEnabled | order.customer.device.browserData.javaEnabled |
| browserLanguage | order.customer.device.locale |
| browserScreenHeight | order.customer.device.browserData.screenHeight |
| browserScreenWidth | order.customer.device.browserData.screenWidth |
| browserTimeZone | order.customer.device.timezoneOffsetUtcMinutes |
| browserUserAgent | order.customer.device.userAgent |
| ACCEPTURL |
cardPaymentMethodSpecificInput.threeDSecure.redirectionData.returnURL Direct uses one redircection URL for all outcomes. Read more in the Optimise payment experience chapter |
| DECLINEURL | |
| EXCEPTIONURL | |
| FLAG3D | cardPaymentMethodSpecificInput.threeDSecure.skipAuthentication |