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 | POST | |
Producción | POST |
Headers
Cabecera | Valor | Requerido |
Content-Type | application/json | SI |
Authorization | Bearer <Access_Token> | SI |
"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". |
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:
|
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
{
"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.
{
"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