Skip to main content
Skip table of contents

Create PayIn Agent Payment / Bank Transfer

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

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. Methods: cash, bank_transfer

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

Description of the operation

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

Must be Https

meta.additional_fields.pay_in_transaction_error_url

String

2048

Si

Must be Https

meta.additional_fields.pay_in_expiration_time

String

32

Si

Suggested minimum time:

  • Online: 30 minutes

  • Effective: 2 hours

meta.additional_fields.pay_in_product_id

String

128

No

Internal product ID

meta.additional_fields.pay_in_product_description

String

2048

No

Product description

meta.additional_fields.pay_in_product_amount

String

1024

No

Product cost

meta.additional_fields.pay_in_product_sku

String

32

No

SKU value

meta.additional_fields.pay_in_product_quantity

String

128

No

Cantidad del producto

meta.additional_fields.pay_in_regular_customer

String

255

No

A flaProduct Quantityg to know if the customer is frequent or not.

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 An internal identifier related to the customerdel cupón

meta.additional_fields.pay_in_customer_type_document

String

255

No

Tipo Valor An internal identifier that refers to the customer cupón documento

meta.additional_fields.pay_in_customer_document

String

255

No

Document number

meta.additional_fields.pay_in_customer_name

String

255

No

Client's name

meta.additional_fields.pay_in_customer_lastname

String

255

No

Customer's last name

meta.additional_fields.pay_in_customer_email

String

254

No

Customer e-mail

meta.additional_fields.pay_in_customer_phone

String

160

No

Customer's phone number

meta.additional_fields.pay_in_customer_address

String

1024

No

Customer's address

meta.additional_fields.pay_in_customer_city

String

1024

No

Customer City

meta.additional_fields.pay_in_customer_region

String

1024

No

Customer region

meta.additional_fields.pay_in_customer_country

String

1024

No

Customer country

meta.additional_fields.pay_in_customer_zip_code

String

1024

No

Customer's zip code

meta.additional_fields.pay_in_customer_shipping_name

String

255

No

Name of the person to whom the shipment will arrive

meta.additional_fields.pay_in_customer_shipping_phone

String

160

No

Telephone number of the person to whom the shipment is to be sent

meta.additional_fields.pay_in_customer_shipping_address

String

1024

No

Address to which the shipment will arrive

meta.additional_fields.pay_in_customer_shipping_city

String

1024

No

City to which the shipment will arrive

meta.additional_fields.pay_in_customer_shipping_region

String

1024

No

Region to which the shipment will arrive

meta.additional_fields.pay_in_customer_shipping_country

String

1024

No

Country to which shipment will arrive

meta.additional_fields.pay_in_customer_shipping_zip_code

String

1024

No

Postal code to which the shipment will arrive

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.

In Chile only whole amounts are processed, there are no decimals.

Ejemplo

CODE
{
  "action": "pay_in",
  "channel": "1",
  "payment_method": {
    "alternative": {
      "provider_name": "alignet",
      "method_name": "pay_in",
      "method_details": {
        "payin_method": "Cash",
        "currency": "604",
        "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": "10000",
      "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": "DNI",
      "pay_in_customer_document": "99999999",
      "pay_in_customer_name": "string",
      "pay_in_customer_lastname": "string",
      "pay_in_customer_email": "correo@gmail.com",
      "pay_in_customer_phone": "999999999",
      "pay_in_customer_address": "string",
      "pay_in_customer_city": "Lima",
      "pay_in_customer_region": "Lima",
      "pay_in_customer_country": "Peru",
      "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": "Lima",
      "pay_in_customer_shipping_region": "Lima",
      "pay_in_customer_shipping_country": "Peru",
      "pay_in_customer_shipping_zip_code": "0000",
      "pay_in_url": "enable"
    }
  }
}

Response

Parámetro

Description

action

Proceso realizado, en este caso es "authorize"

success

True in case the request is successful or False otherwise.

code

The voucher code

amount

The amount of the transaction

code_expiration_time

Code expiration time

currency

Currency ISO code

url

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

available_payout_financial_insititutions

List of available financial entities where payment can be made

meta. internal_operation_number

Transaction number

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",
    "code": "231445866794",
    "code_expiration_time": "2023-05-31T20:13:26",
    "currency": "PEN",
    "amount": "1.00",
    "url": "https://gateway.kashio.net/e/index.html?token=oVJDyrU9tiKciJcNbbx2GH",
    "available_payout_financial_institutions": [
        {
            "description": [
                "Banco de credito"
            ],
            "code": [
                "BCP"
            ],
            "agreementNumber": [
                "None"
            ],
            "name": [
                "Banco de Credito del Peru"
            ],
            "acronym": [
                "BCP"
            ],
            "logo_url": [
                "https://cert-gateway.kashio.net/img/logos/bcp.png?version=09242021"
            ],
            "type": [
                "bank"
            ],
            "payment_medium_instruction": [
                {
                    "app": "<ol><li>Ingresa a la aplicación móvil del BCP, accede al menú principal y selecciona la opción Pagar Servicios.</li><li>Selecciona la opción Buscar en la sección.</li><li>Busca KashIO Perú, elige KashIO Perú Soles o Dólares e ingresa tu código de pago.</li><li>Selecciona la deuda a pagar, confirma y ¡Listo!</li></ol>'",
                    "web": "<ol><li>Ingresa a tu banca web BCP desde: https://www.viabcp.com</li><li>Ve al menú de Pagos, y selecciona Pagar un servicio.</li><li>Busca KashIO Perú, elige KashIO Perú Soles o Dólares e ingresa tu código de pago.</li><li>Selecciona la deuda a pagar, confirma y ¡Listo!</li></ol>'",
                    "teller": "<ol><li>Acércate a un agente del BCP e indica que deseas pagar al servicio de recaudación de KashIO Perú.</li><li>Indica el Código de Agente de KashIO: <strong>15813</strong>.</li><li>Indica tu código de pago.</li><li>Indica monto total, moneda a pagar y ¡Listo! </li><li>Recibe el voucher de pago de la operación.</li></ol>'",
                    "branch": "<ol><li>Acércate a una oficina o agencia del BCP e indica que deseas pagar al servicio de recaudación de KashIO.</li><li>Elije el tipo de moneda a pagar y proporciona el número de tu DNI, RUC, teléfono o código único, según corresponda.</li><li>Elije la deuda que deseas pagar y listo. Recibe el voucher de pago de la operación.</li></ol>'"
                }
            ]
        },
        {
            "description": [
                "Banco Continental"
            ],
            "code": [
                "BBVA"
            ],
            "agreementNumber": [
                "None"
            ],
            "name": [
                "BBVA"
            ],
            "acronym": [
                "BBVA"
            ],
            "logo_url": [
                "https://cert-gateway.kashio.net/img/logos/bbva.png?version=09242021"
            ],
            "type": [
                "bank"
            ],
            "payment_medium_instruction": [
                {
                    "app": "<ol><li>Ingresa a la aplicación móvil del BBVA, accede al menú principal y selecciona tu cuenta bancaria.</li><li>Elige la opción “Pagar servicio” y selecciona Agregar servicio a pagar.</li><li>Busca KashIO Perú, elige KashIO Perú Soles o Dólares e ingresa tu código de pago.</li><li>Selecciona la deuda a pagar, confirma y ¡Listo!</li></ol>'",
                    "web": "<ol><li>Ingresa a tu banca web BBVA desde: https://www.bbva.pe</li><li>Ve a tu cuenta, pulsa el botón Quiero y selecciona la opción Pagar servicio.</li><li>Selecciona la opción Instituciones y empresas y pulsa la opción Nombre.</li><li>Busca KashIO Perú, elige KashIO Perú Soles o Dólares, pulsa siguiente e ingresa tu código de pago</li><li>Selecciona la deuda a pagar, confirma y ¡Listo!!</li></ol>'",
                    "teller": "<ol><li>Acércate a un agente del BBVA e indica que deseas pagar al servicio de recaudación de KashIO Perú.</li><li>Indica el Código de Agente de KashIO:</li><ul>Pago en Soles: <strong>  11140 </strong></ul><ul>Pago en Dólares:<strong> 11141 </strong></ul><li>Indica tu código de pago.</li><li>Indica monto total, moneda a pagar y ¡Listo! </li><li>Recibe el voucher de pago de la operación.</li></ol>'",
                    "branch": "<ol><li>Acércate a una oficina o agencia del BBVA e indica que deseas pagar al servicio de recaudación de KashIO.</li><li>Elije el tipo de moneda en la que quieres pagar.</li><li>Proporciona tu número de DNI, RUC, teléfono o código único según corresponda y elije la deuda que quieres pagar.</li><li>Recibe el voucher de pago de la operación.</li></ol>'"
                }
            ]
        },
        {
            "description": [
                "Interbank"
            ],
            "code": [
                "IBK"
            ],
            "agreementNumber": [
                "None"
            ],
            "name": [
                "Interbank"
            ],
            "acronym": [
                "IBK"
            ],
            "logo_url": [
                "https://cert-gateway.kashio.net/img/logos/interbank.png?version=09242021"
            ],
            "type": [
                "bank"
            ],
            "payment_medium_instruction": [
                {
                    "app": "<ol><li>Ingresa a la aplicación móvil de Interbank.</li><li>Selecciona la opción Operaciones y elige la opción Pago y recargas.</li><li>Selecciona Pago a institución o empresa.</li><li>Busca KashIO Perú, elige KashIO Perú Soles o Dólares e ingresa tu código de pago.</li><li>Selecciona la deuda a pagar, confirma y ¡Listo!</li></ol>'",
                    "web": "<ol><li>Ingresa a tu banca web Interbank desde: https://interbank.pe</li><li>Selecciona Mis operaciones y eligen la opción Pago o Recarga.</li><li>Selecciona Pago a institución o empresa.</li><li>Busca KashIO Perú, elige KashIO Perú Soles o Dólares e ingresa tu código de pago.</li><li>Selecciona la deuda a pagar, confirma y ¡Listo!</li></ol>'",
                    "teller": "<ol><li>Acércate a un agente de Interbank e indica que deseas pagar al servicio de recaudación de KashIO Perú.</li><li>Indica el Código de Agente de KashIO:<ul>Pago en Soles: <strong> 0791501 </strong></ul><ul>Pago en Dólares:<strong> 0791502 </strong></ul></li><li>Indica tu código de pago.</li><li>Indica monto total, moneda a pagar y ¡Listo! </li><li>Recibe el voucher de pago de la operación.</li></ol>'",
                    "branch": "<ol><li>Acércate a una oficina o agencia del Interbank e indica que deseas pagar al servicio de recaudación de KashIO.</li><li>Elige la moneda a pagar y proporciona tu número de DNI, RUC, teléfono o código único según corresponda.</li><li>Elije las deudas a pagar y listo. </li><li>Recibe el voucher de pago de la operación.</li></ol>'"
                }
            ]
        },
        {
            "description": [
                "Scotiabank"
            ],
            "code": [
                "SBK"
            ],
            "agreementNumber": [
                "None"
            ],
            "name": [
                "Scotia Bank"
            ],
            "acronym": [
                "BNS"
            ],
            "logo_url": [
                "https://cert-gateway.kashio.net/img/logos/scotiabank.png?version=09242021"
            ],
            "type": [
                "bank"
            ],
            "payment_medium_instruction": [
                {
                    "app": "<ol><li>Ingresa a la aplicación móvil de Scotiabank.</li><li>Selecciona la opción Quiero y elige la opción Pagar.</li><li>Selecciona Servicios o Instituciones. </li><li>Busca KashIO Perú, elige KashIO Perú Soles o Dólares e ingresa tu código de pago.</li><li>Selecciona la deuda a pagar, confirma y ¡Listo!</li></ol>'",
                    "web": "<ol><li>Ingresa a tu banca web Scotiabank desde: https://mi.scotiabank.com.pe/</li><li>Elige la opción Pagar y selecciona la opción Servicios o Instituciones. </li><li>Busca KashIO Perú, elige KashIO Perú Soles o Dólares e ingresa tu código de pago.</li><li>Selecciona la deuda a pagar, confirma y ¡Listo!</li></ol>'",
                    "teller": "<ol><li>Acércate a un agente de Scotiabank e indica que deseas pagar al servicio de recaudación de KashIO Perú o indica nuestro  RUC 20602393799.</li><li>Indica tu código de pago.</li><li>Indica monto total, moneda a pagar y ¡Listo! </li><li>Recibe el voucher de pago de la operación.</li></ol>'",
                    "branch": "<ol><li>Acércate a una oficina o agencia del Scotiabank e indica que deseas pagar al servicio de recaudación de KASHIO PERU.</li><li>Proporciona tu número de DNI, RUC, teléfono o código único según corresponda y elije la deuda que quieres pagar.</li><li>Elije el tipo de moneda y el moto a pagar.</li><li>Recibe el voucher de pago de la operación.</li></ol>'"
                }
            ]
        },
        {
            "description": [
                "AgenteKasnet"
            ],
            "code": [
                "KASNET"
            ],
            "agreementNumber": [
                "220044"
            ],
            "name": [
                "KASNET"
            ],
            "acronym": [
                ""
            ],
            "logo_url": [
                "https://cert-gateway.kashio.net/img/logos/tambo.png?version=09242021"
            ],
            "type": [
                "correspondent_teller"
            ],
            "payment_medium_instruction": [
                {
                    "correspondent_teller": "<ol><li>Acércate a un agente de KASNET e indica que deseas pagar al servicio de recaudación de KashIO Perú.</li><li>Indica el Código de Agente de KashIO:  <strong>220044 </strong>.</li><li>Indica tu código de pago.</li><li>Indica monto total, moneda a pagar y ¡Listo! </li><li>Recibe el voucher de pago de la operación.</li></ol>'"
                }
            ]
        },
        {
            "description": [
                "Tambo"
            ],
            "code": [
                "TAMBO"
            ],
            "agreementNumber": [
                "None"
            ],
            "name": [
                "TAMBO+"
            ],
            "acronym": [
                ""
            ],
            "logo_url": [
                "https://cert-gateway.kashio.net/img/logos/tambo.png?version=09242021"
            ],
            "type": [
                "convenience_store"
            ],
            "payment_medium_instruction": [
                {
                    "convenience_store": "<ol><li>Acércate a una tienda Tambo+ e indica que deseas realizar pagos por agente a KashIO.</li><li>Indica tu código de pago.</li><li>Elige la Deuda a pagar y ¡Listo! </li><li>Recibe el voucher de pago de la operación.</li></ol>'"
                }
            ]
        }
    ],
    "meta": {
        "internal_operation_number": "320593",
        "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 de url

 

JavaScript errors detected

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

If this problem persists, please contact our support.