Skip to main content
Skip table of contents

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.

  

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.

 

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.