.png){kind=logo}
Páginas de respuesta y confirmación
- 21 Sep 2022
- 5 Minutes to read
- Contributors
- Print
- DarkLight
Páginas de respuesta y confirmación
- Updated on 21 Sep 2022
- 5 Minutes to read
- Contributors
- Print
- DarkLight
Article summary
Did you find this summary helpful?
Thank you for your feedback
Tipos de paginas de respuesta
Para presentar el estado de una transacción a sus clientes y obtener los parámetros de la transacción en su página de respuesta, se brindan dos alternativas:
Estática: Consulte el resultado de la transacción y redirija a sus clientes a una página de respuesta personalizada según el resultado obtenido, lo único que debe hacer es incluir la url del archivo html e invocar el parámetro según sea el caso (data-epayco-acepted data-epayco-rejected data-epayco-pending).
Dinámica : Puede usar una página de respuesta dinámica y personalizada, es decir, que dependiendo del estado o los datos que se envíen en una transacción, la información presentada en la página de respuesta varía, para ello deberá incluir el parámetrodata-epayco-responsepara invocarla.
Para obtener los atributos que se envían en la página de respuesta dinámica deberás hacer un llamado mediante el siguiente endpoint:
https://secure.epayco.co/validation/v1/reference/ + ref_paycoA continuación se relaciona la información de la transacción presentada al usuario pagador en la página de respuesta dinámica:
| campo | Datos |
|---|---|
Referencia | 12583865 |
Fecha | 2019-12-10 12:08:01 |
Respuesta | Aceptado |
motivo | 00-Aprobada |
Banco | BANCO DE PRUEBAS |
Recibo | 12583865 |
Total | 100 dolares |
Si deseas verificar la información suministrada en la respuesta de la transacción podrás consultar el código GITHUB, donde se evidencia el proceso de validación según los parámetros enviados.
Atributos de las transacciones:
Los siguientes son los parámetros o atributos que deben integrar cada transacción:
| Campo | Descripción | Formato | Longitud |
|---|---|---|---|
| x_cust_id_cliente | Id del cliente | Números enteros | 11 dígitos máximo |
| x_description | Descripción del producto | Solo texto | No aplica |
| x_amount | Valor total del producto | Números decimales | Numero entero: 15 dígitos máximo Números decimales: 2 dígitos máximo |
| x_id_factura | Id de la factura | Varchar | 255 caracteres máximo |
| x_currency_code | Código de la moneda (COP,USD) | Varchar | 3 caracteres máximo |
| x_transaction_date | Fecha y hora de la transacción | Fecha y hora | Y-m-d H:i:s |
| x_transaction_id | Número de recibo de la transacción | Varchar | 255 caracteres máximo |
| x_ref_payco | Número de recibo de la transacción | Números enteros | 11 dígitos máximo |
| x_cod_transaction_state | Código estado de la transacción | Varchar | 255 caracteres máximo |
| x_signature | Llave de seguridad generada por ePayco para firmar los valores enviados a las url de respuesta y de confirmación | Text | No aplica |
| x_test_request | Estado de la petición (prueba="TRUE" producción="FALSE") | Varchar | 20 caracteres máximo |
Página de confirmación
Este parámetro se podrá utilizar para recibir confirmaciones de las transacciones creadas mediante herramientas de cobra (Link de cobro, botón de cobro), botón de donación o pago dividido. Para ellos deberás enviar el parámetro: data-epayco-confirmation.
Se devuelven los siguientes datos o atributos a la URL de respuesta por POST ya la URL de confirmación según el método enviado en la variable p_confirm_method . Ver enGITHUB
Atributos de las transacciones:
| Campo | Descripción | Formato | Longitud |
|---|---|---|---|
| x_cust_id_cliente | Id del cliente | Números enteros | 11 dígitos máximo |
| x_ref_payco | Número de recibo de la transacción | Números enteros | 11 dígitos máximo |
| x_id_factura | Id de la factura | Varchar | 255 caracteres máximo |
| x_id_invoice | Id de la factura | Varchar | 255 caracteres máximo |
| x_description | Descripción del producto | Solo texto | No aplica |
| x_amount | Valor total del producto | Números decimales | Numero entero: 15 dígitos máximo Números decimales: 2 dígitos máximo |
| x_amount_country | Valor total del producto | Números decimales | Numero entero: 15 dígitos máximo Números decimales: 2 dígitos máximo |
| x_amount_ok | Valor total del producto | Números decimales | Numero entero: 15 dígitos máximo Número Números decimales: 2 dígitos máximo |
| x_tax | IVA | Números decimales | Numero entero: 15 dígitos máximo Número Números decimales: 2 dígitos máximo |
| x_tax_ico | Impuesto al consumo ICO | Números decimales | Numero entero: 15 dígitos máximo Número Números decimales: 2 dígitos máximo |
| x_amount_base | Valor sin IVA | Números decimales | Numero entero: 15 dígitos máximo Número Números decimales: 2 dígitos máximo |
| x_currency_code | Código de la moneda (COP,USD) | Varchar | 3 caracteres máximo |
| x_bank_name | Nombre del banco | Varchar | 255 caracteres máximo |
| x_cardnumber | Nombre del tarjetahabiente | Varchar | 20 caracteres máximo |
| x_quotas | Número de cuotas a diferir el pago | Números enteros | Máximo 2 dígitos |
| x_respuesta | x_respuesta | Varchar | 255 caracteres máximo |
| x_response | x_respuesta | Varchar | 255 caracteres máximo |
| x_approval_code | Código de aprobación | Varchar | 255 caracteres máximo |
| x_transaction_id | Número de recibo de la transacción | Varchar | 255 caracteres máximo |
| x_fecha_transaccion | Fecha y hora de la transacción | Fecha y hora | Y-m-d H:i:s |
| x_transaction_date | Fecha y hora de la transacción | Fecha y hora | Y-m-d H:i:s |
| x_cod_respuesta | Código de respuesta de la transacción | Numeros enteros | 11 dígitos máximo |
| x_cod_response | Código de respuesta de la transacción | Numeros enteros | 11 dígitos máximo |
| x_response_reason_text | Descripción de la respuesta | Varchar | 255 caracteres máximo |
| x_errorcode | Código error de la transacción | Numeros enteros | Máximo 2 dígitos |
| x_cod_transaction_state | Código estado de la transacción | Varchar | 255 caracteres máximo |
| x_transaction_state | Estado de la transacción | Varchar | 255 caracteres máximo |
| x_franchise | Franquicias | Varchar | 255 caracteres máximo |
| x_business | Negocio | Varchar | 255 caracteres máximo |
| x_customer_doctype | Tipo de documento del tarjetahabiente | Varchar | 10 caracteres máximo |
| x_customer_document | Documento del tarjetahabiente | Varchar | 100 caracteres máximo |
| x_customer_name | Nombre del tarjetahabiente | Varchar | 45 caracteres máximo |
| x_customer_lastname | Apellidos del tarjetahabiente | Varchar | 45 caracteres máximo |
| x_customer_email | Email del tarjetahabiente | Varchar | 45 caracteres máximo |
| x_customer_phone | Teléfono del tarjetahabiente | Varchar | 255 caracteres máximo |
| x_customer_movil | Celular del tarjetahabiente | Varchar | 50 caracteres máximo |
| x_customer_ind_pais | Indicador del país del cliente | Varchar | 20 caracteres máximo |
| x_customer_country | País del tarjetahabiente | Varchar | 255 caracteres máximo |
| x_customer_city | Ciudad del tarjetahabiente | Varchar | 255 caracteres máximo |
| x_customer_address | Dirección del tarjetahabiente | Varchar | 255 caracteres máximo |
| x_customer_ip | Ubicación IP del tarjetahabiente | Varchar | 255 caracteres máximo |
| x_signature | Llave de seguridad generada por ePayco para firmar los valores enviados a las url de respuesta y de confirmación | Text | No aplica |
| x_test_request | Estado de la petición (prueba="TRUE" producción="FALSE") | Varchar | 20 caracteres máximo |
| x_extra1 | Dato extra 1 | Varchar | 255 caracteres máximo |
| x_extra2 | Dato extra 2 | Varchar | 255 caracteres máximo |
| x_extra3 | Dato extra 3 | Varchar | 255 caracteres máximo |
| x_extra4 | Dato extra 4 | Varchar | 255 caracteres máximo |
| x_extra5 | Dato extra 5 | Varchar | 255 caracteres máximo |
| x_extra6 | Dato extra 6 | Varchar | 255 caracteres máximo |
| x_extra7 | Dato extra 7 | Varchar | 255 caracteres máximo |
| x_extra8 | Dato extra 8 | Varchar | 255 caracteres máximo |
| x_extra9 | Dato extra 9 | Varchar | 255 caracteres máximo |
| x_extra10 | Dato extra 10 | Varchar | 255 caracteres máximo |
Tener en cuenta:
Los parámetros x_cod_response x_response x_response_reason_text permiten conocer y entender la respuesta de la transacción.Recepción de datos en la página de confirmación:
Es importante que al recibir los datos de la transacción en la página de confirmación, verifiques el valor pagado, referencias y demás información con el fin de garantizar que coincida con el valor asignado al producto o servicio ofrecido.
Comprobación x_signature
Para comprobar el valor de esta variable y la integridad de los datos enviados se debe generar una firma concatenando los siguiente valores:
hash('sha256',$p_cust_id_cliente.'^'.$p_key.'^'.$x_ref_payco.'^'.$x_transaction_id.'^'.$x_amount.'^'.$x_currency_code)
Es importante que estas variables estén separadas por el carácter '^'
Franquicias
A continuación se muestran los códigos de las franquicias (Medios de pago) que son retornados por ePayco.
Código | Descripción |
|---|---|
| AM | Amex |
| BA | Baloto |
| CR | Credencial |
| DC | Diners Club |
| EF | Efecty |
| GA | Gana |
| PR | Punto Red |
| RS | Red Servi |
| MC | Mastercard |
| PSE | PSE |
| SP | SafetyPay |
| VS | Visa |
Códigos de respuesta
A continuación se muestran los códigos de respuesta (x_cod_transaction_state) y response (x_cod_transaction_state) que son retornados por ePayco, los cuales deben de tenerse en cuenta al momento de registrar la confirmación de una transacción:
| Cod Respuesta | Estado | Response |
|---|---|---|
| 1 | Aceptada | la transacción fue aprobada |
| 2 | Rechazada | transacción rechazada con el detalle del motivo, para PSE están las opciones el usuario no aceptó o rechazó la transacción en el banco ó el usuario cerró el navegador, en Tarjeta de crédito las opciones son: fondos insuficientes, tarjeta no válida, rechazada por la red de procesamiento. |
| 3 | Pendiente | La transacción se encuentra pendiente por aprobación, para PSE las transacciones quedan pendientes y pueden tardar hasta 20 minutos en que retornen el final de la transacción ya sea con estado aprobado o rechazado, para pagos en efectivo las transacciones quedan inicialmente como pendientes hasta que el usuario no realice el pago en un punto físico. |
| 4 | Fallida | No se culmina el flujo de creación de la transacción de manera exitosa |
| 6 | Reversada | Reintegro del dinero al cliente pagador, es de aclarar que sólo se pueden revertir transacciones por tarjeta de crédito, esta acción se puede gestionar directamente desde el Dashboard si la transacción fue realizada el mismo día hasta las 9pm, pasado este tiempo debe solicitarse ante la red de procesamiento. |
| 7 | retenido | La es retenida cuando el área de auditoría no finalizará la validación de la transacción ya sea porque no se tuvo contacto con el cliente pagador o incluso el comercio (aplica sólo para modelo agregado con medio de pago tarjeta de crédito) |
| 8 | iniciada | Estado interno para iniciar una transacción |
| 9 | caducada | Transacción caducada, este estado solo se da en el medio de pago en efectivo y SafetyPay debido a que el usuario no realiza el pago en el punto físico en un tiempo determinado (este tiempo de vencimiento lo define el comercio que va desde 12 horas hasta 8 días) |
| 10 | abandonada | El usuario por algún motivo cerró el navegador y no culminó el proceso de diligenciamiento de la información. |
| 11 | Cancelada | El usuario no culmino el proceso final pero diligencio la informacion |
Tipos de documentos
A continuación se enumeran los códigos que retornan ePayco para representar los tipos de documentos de identificación:
| ID | Tipo de documento | Formato | Longitud |
|---|---|---|---|
| NIT | Número de identificación tributaria | Numérico | mínimo 7 dígitos y máximo 10 dígitos |
| CC | Cedula de ciudadanía | Numérico | mínimo 5 y máximo 15 dígitos |
| CE | Cedula de extranjería | Numérico | mínimo 4 dígitos y máximo 8 dígitos |
| TI | Tarjeta de identidad | Numérico | mínimo 4 dígitos y máximo 20 dígitos |
| PPN | Pasaporte | Alfanumérico | mínimo 4 dígitos y máximo 12 dígitos |
| SSN | Número de seguridad social | Numérico | mínimo 9 dígitos y máximo 9 dígitos |
| LIC | Licencia de conducción | Numérico | mínimo 1 dígitos y máximo 20 dígitos |
| DNI | Documento nacional de identificación | Alfanumérico | mínimo 1 digito y máximo 20 dígitos |
Was this article helpful?