Este servicio tiene como función permitir realizar un PayIn con el Token de Seguridad obtenido anteriormente.

Ambiente

EndPoint

Método

Desarrollo

https://api.dev.alignet.io/charges

POST

Producción

https://api.alignet.io/charges

POST

Headers

Cabecera

Valor

Requerido

Content-Type

application/json

SI

Authorization

Bearer <Access_Token>

SI

"Content-Type":"application/json",
"Authorization":"Bearer yJhbGciOiJSUzI1NsInR5cCI6IkpXVCIsImt………",
JSON

Request

Parámetro

Tipo

Longitud

Requerido

Descripción

action

String

6

Si

La acción prevista de la carga de pago. Para el uso actual se debe utilizar el valor fijo "authorize".

channel

String

1

Si

Describe el tipo de canal a través del cual se enviará la transacción a procesar. Para transacciones en efectivo el valor debe ser : "7".
Para pagos de comercio electrónico, debe utilizar el valor "1".

payment_method.alternative.provider_name

String

6

Si

Nombre del proveedor que procesará la transacción.

payment_method.alternative.method_name

String

6

Si

Tipo de método de pago alternativo. Valor fijo: “pay_in”

payment_method.alternative. method_details. payin_method

String

12

Si

Método de pago asociado a la transacción. Valor fijo: card

payment_method.alternative.method_details. currency

String

3

Si

Moneda de la transacción en valor numérico ISO

payment_method.alternative.method_details. amount

String

1024

Si

Importe de la transacción en céntimos de moneda, teniendo en cuenta que consideramos las 5 últimas posiciones como la parte decimal del importe.

meta. internal_operation_number

String

1024

Si

Número de operación

meta. description

String

2048

Si

Descripción de la operación

meta.additional_fields.capture_method_version

String

3

Si

Método de captura. Valor fijo "3.0"

meta.additional_fields.pay_in_verification

String

128

No

Valor hexadecimal de una representación SHA512 de la siguiente concatenación: payinMerchantID+payin MerchantOperationNu mber+payinAmount+pa yinCurrency+KeyProvider

meta.additional_fields.pay_in_transaction_successful_url

String

2048

Si

Debe ser Https

meta.additional_fields.pay_in_transaction_error_url

String

2048

Si

Debe ser Https

meta.additional_fields.pay_in_expiration_time

String

32

Si

Tiempo sugerido minimo:

  • Online: 30 minutos

  • Efectivo: 2 horas

meta.additional_fields.pay_in_product_id

String

128

No

El Id interno del producto

meta.additional_fields.pay_in_product_description

String

2048

No

Descripción del producto

meta.additional_fields.pay_in_product_amount

String

1024

No

Coste del producto

meta.additional_fields.pay_in_product_sku

String

32

No

Valor de la SKU

meta.additional_fields.pay_in_product_quantity

String

128

No

Cantidad del producto

meta.additional_fields.pay_in_regular_customer

String

255

No

Un flag para saber si el cliente es frecuente o no.

meta.additional_fields.pay_in_customer_id

String

2048

No

Un identificador interno relacionado con el cliente

meta.additional_fields.pay_in_discount_coupon

String

256

No

Valor del cupón

meta.additional_fields.pay_in_customer_type_document

String

255

No

Tipo de documento

meta.additional_fields.pay_in_customer_document

String

255

No

Número de documento

meta.additional_fields.pay_in_customer_name

String

255

No

Nombre del cliente

meta.additional_fields.pay_in_customer_lastname

String

255

No

Apellido del cliente

meta.additional_fields.pay_in_customer_email

String

254

No

Correo electrónico de cliente

meta.additional_fields.pay_in_customer_phone

String

160

No

Teléfono del cliente

meta.additional_fields.pay_in_customer_address

String

1024

No

Dirección del cliente

meta.additional_fields.pay_in_customer_city

String

1024

No

Ciudad del cliente

meta.additional_fields.pay_in_customer_region

String

1024

No

Región del cliente

meta.additional_fields.pay_in_customer_country

String

1024

No

País cliente

meta.additional_fields.pay_in_customer_zip_code

String

1024

No

Código postal del cliente

meta.additional_fields.pay_in_customer_shipping_name

String

255

No

Nombre de la persona a la que llegará el envío

meta.additional_fields.pay_in_customer_shipping_phone

String

160

No

Teléfono de la persona a la que llegará el envío

meta.additional_fields.pay_in_customer_shipping_address

String

1024

No

Dirección a la que llegará el envío

meta.additional_fields.pay_in_customer_shipping_city

String

1024

No

Ciudad a la que llegará el envío

meta.additional_fields.pay_in_customer_shipping_region

String

1024

No

Región a la que llegará el envío

meta.additional_fields.pay_in_customer_shipping_country

String

1024

No

País al que llegará el envío

meta.additional_fields.pay_in_customer_shipping_zip_code

String

1024

No

Código postal al que llegará el envío

meta.additional_fields.pay_in_url

String

32

Si

Flag para solicitar la url de proveedor para cargar la página de instrucciones de pago. Si viene con el valor enable, la URL se enviará en la respuesta.

Cualquier otro valor no enviará la URL.

En Chile sólo se procesan cantidades enteras, no hay decimales.

Ejemplo

{
    "action": "pay_in",
    "channel": "1",
    "payment_method": {
        "alternative": {
            "provider_name": "alignet",
            "method_name": "pay_in",
            "method_details": {
                "payin_method": "Card",
                "currency": "152",
                "amount": "100000"
            }
        }
    },
    "meta": {
        "internal_operation_number": "{{operationNumber}}",
        "description": "payin_request",
        "additional_fields": {
            "capture_method_version": "3.0",
            "pay_in_verification": "string",
            "pay_in_transaction_successful_url": "https://test.com",
            "pay_in_transaction_error_url": "https://test.com",
            "pay_in_expiration_time": "1200",
            "pay_in_product_id": "00",
            "pay_in_product_description": "pay_in_request",
            "pay_in_product_amount": "100000",
            "pay_in_product_sku": "string",
            "pay_in_product_quantity": "00",
            "pay_in_regular_customer": "string",
            "pay_in_customer_id": "string",
            "pay_in_discount_coupon": "string",
            "pay_in_filter_by": "string",
            "pay_in_customer_type_document": "RUT",
            "pay_in_customer_document": "25334722-8",
            "pay_in_customer_name": "string",
            "pay_in_customer_lastname": "string",
            "pay_in_customer_email": "test@test.com",
            "pay_in_customer_phone": "999444555",
            "pay_in_customer_address": "string",
            "pay_in_customer_city": "string",
            "pay_in_customer_region": "string",
            "pay_in_customer_country": "Chile",
            "pay_in_customer_zip_code": "0000",
            "pay_in_customer_shipping_name": "string",
            "pay_in_customer_shipping_phone": "00",
            "pay_in_customer_shipping_address": "string",
            "pay_in_customer_shipping_city": "string",
            "pay_in_customer_shipping_region": "string",
            "pay_in_customer_shipping_country": "Chile",
            "pay_in_customer_shipping_zip_code": "0000"
        }
    }
}
JSON

Response

Parámetro

Descripción

action

Proceso realizado, en este caso es "authorize"

success

True en caso que la petición sea satisfactoria o False en caso contrario.

code

El código del vale

amount

El importe de la transacción

code_expiration_time

Hora de caducidad del código

currency

Moneda Código ISO

capture_url

URL que se utilizará en caso de que sea necesario redirigir al proveedor de pagos

available_payout_financial_insititutions

Lista de entidades financieras disponibles donde es posible realizar el pago

meta. internal_operation_number

Número de operación

meta.description

Descripción de la operación

meta.additional_fields

meta.metrics.aggregate.start

Hora de inicio en timestamp

meta.metrics.aggregate.end

Hora final en timestamp

meta.metrics.aggregate.duration.milliseconds

Duración en milisegundos

meta.metrics.aggregate.duration.seconds

Duración en segundos

meta.status.code

El código de estado de la transacción

meta.status.message_ilgn.locale

El lenguaje de la transacción

meta.status.message_ilgn.value

Valor del mensaje

Ejemplo

La respuesta dará toda la información adecuada para que el usuario final pueda proceder al pago.

{
    "action": "authorize",
    "success": "Successfull process",
    "capture_url": "https://payin.api.monnetpayments.com/api-payin/v3/card-async-yuno/token/77cf52c5-2938-49da-8066-12d6823ba5fc",
    "currency": "CLP",
    "available_payout_financial_institutions": [
        {
            "description": [
                "ServiEstado"
            ],
            "code": [
                "serviestado"
            ],
            "agreementNumber": [
                "None"
            ],
            "name": [
                "ServiEstado"
            ],
            "acronym": [
                "ServiEstado"
            ],
            "logo_url": [
                "https://payimage.s3.amazonaws.com/cert/serviEstado.png?version=09242021"
            ],
            "type": [
                "convinience_store"
            ],
            "payment_medium_instruction": [
                {
                    "teller": "<ol><li>Acércate al punto de pago elegido.</li><li>Indica el siguiente número de convenio: <strong>10612963</strong>.</li><li>Indica tu código de pago.</li><li>Indica monto total y ¡Listo! </li></ol>'"
                }
            ]
        },
        {
            "description": [
                "CajaVecina"
            ],
            "code": [
                "cajavecina"
            ],
            "agreementNumber": [
                "None"
            ],
            "name": [
                "CajaVecina"
            ],
            "acronym": [
                "CajaVecina"
            ],
            "logo_url": [
                "https://payimage.s3.amazonaws.com/cert/cajaVecina.png?version=09242021"
            ],
            "type": [
                "convinience_store"
            ],
            "payment_medium_instruction": [
                {
                    "teller": "<ol><li>Acércate al punto de pago elegido.</li><li>Indica el siguiente número de convenio: <strong>10612963</strong>.</li><li>Indica tu código de pago.</li><li>Indica monto total y ¡Listo! </li></ol>'"
                }
            ]
        },
        {
            "description": [
                "Líder"
            ],
            "code": [
                "lider"
            ],
            "agreementNumber": [
                "None"
            ],
            "name": [
                "Líder"
            ],
            "acronym": [
                "Líder"
            ],
            "logo_url": [
                "https://payimage.s3.amazonaws.com/cert/lider.png?version=09242021"
            ],
            "type": [
                "convinience_store"
            ],
            "payment_medium_instruction": [
                {
                    "teller": "<ol><li>Acércate al punto de pago elegido y ubica un totem servifácil.</li><li>Ingresa a <strong>Pago de cuentas</strong>, selecciona <strong>Servicios y cobranzas</strong> y elige <strong>SafetyPay</strong>.</li><ul>Ingresa tu código de pago.</li><li>Imprime el cúpon y acércate a cualquier caja para realizar el pago.</li></ol>'"
                }
            ]
        },
        {
            "description": [
                "Líder Express"
            ],
            "code": [
                "liderexpress"
            ],
            "agreementNumber": [
                "None"
            ],
            "name": [
                "Líder Express"
            ],
            "acronym": [
                "Líder Express"
            ],
            "logo_url": [
                "https://payimage.s3.amazonaws.com/cert/express.png?version=09242021"
            ],
            "type": [
                "convinience_store"
            ],
            "payment_medium_instruction": [
                {
                    "teller": "<ol><li>Acércate al punto de pago elegido y ubica un totem servifácil.</li><li>Ingresa a <strong>Pago de cuentas</strong>, selecciona <strong>Servicios y cobranzas</strong> y elige <strong>SafetyPay</strong>.</li><ul>Ingresa tu código de pago.</li><li>Imprime el cúpon y acércate a cualquier caja para realizar el pago.</li></ol>'"
                }
            ]
        },
        {
            "description": [
                "Sencillito"
            ],
            "code": [
                "sencillito"
            ],
            "agreementNumber": [
                "None"
            ],
            "name": [
                "Sencillito"
            ],
            "acronym": [
                "Sencillito"
            ],
            "logo_url": [
                "https://cert-gateway.kashio.net/img/logos/interbank.png?version=09242021"
            ],
            "type": [
                "convinience_store"
            ],
            "payment_medium_instruction": [
                {
                    "branch": "<ol><li>Acércate a la Agencia de Sencillito de tu preferencia.</li><li>Brinda tu código de pago y el monto a pagar.</li></ol>'"
                }
            ]
        }
    ],
    "meta": {
        "internal_operation_number": "605859",
        "description": "payin_request",
        "additional_fields": {},
        "metrics": {
            "aggregate": {
                "start": "1648145022000",
                "end": "1648145023000",
                "duration": {
                    "milliseconds": "1000",
                    "seconds": "1"
                }
            }
        },
        "status": {
            "code": "00",
            "message_ilgn": [
                {
                    "locale": "es_PE",
                    "value": "Peticion de Payin Realizado Correctamente."
                }
            ]
        }
    }
}
JSON

Ejemplo del Capture_url