Generate PayIn with alternative card

This service allows you to perform a PayIn with the previously obtained Security Token.

Environment	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

CODE

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

Request

Parámetro	Tipo	Longitud	Requerido	Descripción
action	String	6	Si	The intended action of the payment charge. For the current usage the fixed value "authorize" should be used.
channel	String	1	Si	Describes the type of channel through which the transaction to be processed will be sent. For cash transactions the value should be : "7". For e-commerce payments, you should use the value "1".
payment_method.alternative.provider_name	String	6	Si	Name of the supplier who will process the transaction.
payment_method.alternative.method_name	String	6	Si	Type of alternative payment method. Fixed value: "pay_in".
payment_method.alternative. method_details. payin_method	String	12	Si	Payment method associated with the transaction. Fixed value: card
payment_method.alternative.method_details. currency	String	3	Si	Transaction currency in ISO numerical value
payment_method.alternative.method_details. amount	String	1024	Si	Amount of the transaction in currency cents, taking into account that we consider the last 5 positions as the decimal part of the amount.
meta. internal_operation_number	String	1024	Si	Transaction number
meta. description	String	2048	Si	Descripción de la operación
meta.additional_fields.capture_method_version	String	3	Si	Capture method. Fixed value "3.0".
meta.additional_fields.pay_in_verification	String	128	No	Hexadecimal value of a SHA512 representation of the following concatenation: 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

CODE

{
    "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"
        }
    }
}

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.

CODE

{
    "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."
                }
            ]
        }
    }
}

Ejemplo del Capture_url