Generar PayIn con Tarjeta alternativo
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 | 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". |
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:
|
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"
}
}
}
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."
}
]
}
}
}
Ejemplo del Capture_url
![](../../../__attachments/75530316/MicrosoftTeams-image%20(9).png?inst-v=6b80ff29-4ad3-495f-872e-e39c5dc724d0)