ServerToServer Notification

The ServerToServer notification flow is intended to notify the merchant by sending a JSON frame with the final result of the authorization request to a callback url.

Request sent by Alignet

Header

Field	Description	Type
`signature`	It will contain a signature to validate that the response json is authentic.	`String`

Body

Field	Description	Accepted Value	Type	Mandatory
`success`	Indicates whether the process was successful	Alfanumeric: true false	`String`	YES
`merchant_code`	Merchant ID	Alfanumeric	`String`	YES
`merchant_operation_number`	Merchant order number	Numeric greater than or equal to 6 digits	`String`	YES
`transaction`	Object with transaction information		`Object`	YES
`transaction.transaction_id`	Transaction amount	Numeric	`String`	YES
`transaction.state`	Transaction status	AUTORIZADO DENEGADO INVALIDO	`String`	YES
`transaction.currency`	Currency code of the transaction that was authorized	Numeric	`String`	YES
`transaction.amount`	Amount of the transaction that was authorized. The amount must be in cents.	Numeric	`Object`	YES
`transaction.processor_response`	Object containing detailed result of processing. This object may change depending on the payment method. This field is variable and modifiable over time, take it as a reference. CARD → Card Authorization API BANK_TRANSFER → Bank Transfer Authorization API		`Object`	NO*
`meta`	Object containing metadata of the executed flow		`Object`	YES
`meta.status`	Object containing the result of the executed flow		`Object`	YES
`meta.status.code`	Code representing the result of the executed flow	Numeric	`String`	YES
`meta.status.message_ilgn`	Object that contains the message resulting from the flow.		`Object`	YES
`meta.status.message_ilgn.[].locale`	Language-level locale for the message of the executed stream	Alfanumeric	`String`	YES
`meta.status.message_ilgn.[].value`	Message resulting from the executed flow	Alfanumeric	`String`	YES

Example

JSON

{
    "success": "true",
    "action": "authorize",
    "merchant_code":"b0deb6f3-e51a-48a7-9268-f1441d46f7bd",
    "merchant_operation_number": "2391645",
    "transaction": {
        "transaction_id": "5hk8rwa3h3cq9oyfs3a28v1ms",
        "state": "AUTORIZADO"
        "amount": "15000",
        "currency": "604",
        "processor_response": {
            "date": "17-01-2024 12:27:46",
            "authorization_code": "055552",
            "result_message": {
                "code": "00",
                "description": "Approval and completed successfully"
            }
        }
    },
    "meta": {
        "status": {
            "code": "00",
            "message_ilgn": [
                {
                    "locale": "es_PE",
                    "value": "Procesado correctamente"
                }
            ]
        }
    }
}

Callback response

After sending the frame to callback, Alignet will wait 10 seconds to get a HTTPS STATUS-CODE 200 response otherwise it will retry later. The amount of retry notifications is configurable per merchant.