After the Payment

Webhooks

Overview

You can create webhooks to set up callbacks and get notified about certain events from DECTA Gate. Once created, DECTA Gate will contact your servers whenever a hooked event fires. You do not need to do it for each individual order: setting up a webhook once will fire for all related events.

To receive callbacks as a Partner, you can select the “Partner webhooks” radio button in the “Webhooks type” section. After that, you need to select the connected merchants, for which you want to receive the callbacks, in the “Connected merchants” section. When a callback is received, the body of the callback will contain the merchant ID by which you can identify the particular connected merchant.

Supported Event Types

Event ID	Description
order.issued	an order has been issued
order.payment_success	customer has successfully paid for the order
order.payment_failure	an error has occurred during the order payment
order.hold	funds for the order have been reserved
order.canceled	an order has been cancelled; additionally, if funds were reserved for this order (`skip_capture = true`), they will be returned
order.in_progress	an order has been issued and is being processed
order.invoice_viewed	customer has viewed the invoice for this order
order.invoice_refunded	merchant has refunded the invoice for this order
order.invoice_reversal	merchant has reversed the invoice for this order
order.refund_failure	an error occurred during the invoice refund
order.invoice_refund_reversed	a refund has been reversed
order.refund_init_failure	an error has occurred during the process of initialization of a refund
order.reversal_init_failure	an error has occurred during the process of initialization of a reversal
order.reversal_failure	an error occurred during the invoice reversal
order.refund_in _progress	an invoice refund is being processed
order.reversal_in _progress	an invoice reversal in being processed
order.received	an order has been received
order.rejected	an invoice has been rejected by the customer
order.expired	an order has expired
order.chargeback	a chargeback has been received
order.representation	a representation has been processed
order.retrieval	a retrieval request has been received
order.pre-arbitration	a pre-arbitration has been received
order.good_faith	a good faith has been received
order.fraud_advice	a fraud advice has been received
oct.issued	an OCT order has been issued
oct.success	an OCT transaction has been successfully executed
oct.failure	an error has occurred during OCT transaction execution
card.created	customer's card data has been saved
card.deleted	customer's card data has been deleted
card.updated	customer's card data has been updated

You can alternatively set all_events to true to hook all events to the same callback URL in one request.

Payment Response Analysis

Merchant Advice Code

The parameter merchant_advice_code provides additional information on a given transaction response decline. Merchant Advice Codes are supported by Mastercard to enable issuers to communicate insights to acquirers and merchants and thus let them optimize their subsequent retry strategies for declined transactions.

01 New account information available
02 Cannot approve at this time, try again later
03 Do not try again
04 Token requirements not fulfilled for this token type
21 Payment Cancellation

Merchant advice code values 03 and 21 are intended to send a clear message that a transaction should not be resubmitted for approval:

Value 03 is sent by issuers to indicate that an account is closed or fraudulent, and that no further approvals will be forthcoming;
Value 21 is sent by Mastercard Payment Cancellation Service (PCS) to indicate a cardholder canceled the agreement and instruct the merchant and acquirer to not retry the transaction.

In order to avoid unnecessary declines, pay close attention to the returned merchant advice code value.

AVS Response Codes

If you are using Address Verification System, then in the response you will receive avs_status object:

    {
        "avs_status": {
                    "description": "Street address and ZIP code do not match",
                    "avs_status": "N",
                    "avs_status_timestamp": "2022-10-26T07:17:17Z"
                    }
    }

avs_status	description
A	Street address matches ZIP code does not match
B	Street address matches. ZIP code not verified (incorrect format)
C	Street address and ZIP code not verified (incorrect format)
D	Street address and ZIP code match
F	Street address and ZIP code match. Applies to UK-issued cards
G	Not verified or not supported
I	Street address and ZIP code not verified
M	Street address and ZIP code match
N	Street address and ZIP code do not match
P	ZIP code matches. Street address not verified (incorrect format)
R	Service unavailable
S	Not supported
T	Nine-digit zip code matches address does not match
U	Address not verified due to lack of issuer support or system malfunction
W	ZIP code matches street address does not
X	ZIP code and address match
Y	Cardholder street address and ZIP code match
Z	ZIP code matches