Skip to main content

Authorization

POST 
/authorizations

This custodial integrator webhook endpoint is called when an authorization or sale request is made.

For more information on setting up webhooks see the webhooks guide

Request​

Body

required

    cardId stringrequired

    The card ID

    transactionId stringrequired
    authorizationId stringnullable
    transactionType stringrequired

    Possible values: [100, 200]

    The transaction type:

    100 - auth request

    200 - sales request

    merchantName stringrequired

    Card acceptor name

    merchantCurrency stringrequired

    Card acceptor currency

    merchantAmount numberrequired

    Card acceptor amount in minor units of the merchant currency

    billingCurrency stringrequired

    Billing currency

    billingAmount numberrequired

    Billing amount in minor units of the billing currency

    settlementCurrency stringrequired
    settlementAmount numberrequired

    Settlement amount in minor units of the settlement currency

    mcc stringrequired

    Merchant category code

    exchangeRate stringrequired

    Exchange rate between merchant and settlement currencies

    channel stringrequired

    Channel

    transactionDate date-timerequired

    Transaction date

    messageId stringrequired

    Message ID to prevent being processed multiple times

    actualAuthenticationMethod stringrequired

    Possible values: [not_applicable, not_performed, email, sms, push, biometric, other]

    posDataCode stringnullable
    feeAmount number

    The amount charged by IMMERSVE for this transaction in minor units of the settlement currency

Responses​

Authorization request accepted

Loading...