URL de confirmación
  • 08 Mar 2022
  • 4 Minutes to read
  • Contributors
  • Dark
    Light

URL de confirmación

  • Dark
    Light

Página de confirmación

Este parámetro se podrá utilizar para recibir confirmaciones de las transacciones creadas mediante los proyectos de recaudo. Para ellos deberás enviar  el parámetrodata-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 en GITHUB

Atributos de las transacciones:

campo
DescripcionFormatoLongitud
x_cliente_id_clienteid del clienteNúmeros enteros11 dígitos máximo
x_ref_paycoNumero de recibo de la transaccionNúmeros enteros11 dígitos máximo
x_id_facturaid de la facturaVárchar255 caracteres máximo
x_id_facturaid de la facturaVárchar255 caracteres máximo
x_descripciónDescripcion del productoTexto soloSin aplicación
cantidad_xvalor total del productoNúmeros decimalesNúmero entero: 15 dígitos máximo
 Números decimales: 2 dígitos máximo
x_cantidad_paísvalor total del productoNúmeros decimalesNúmero entero: 15 dígitos máximo
 Números decimales: 2 dígitos máximo
x_cantidad_okvalor total del productoNúmeros decimalesNúmero entero: 15 dígitos máximo
 Números decimales: 2 dígitos máximo
x_impuestoIVANúmeros decimalesNúmero entero: 15 dígitos máximo
 Números decimales: 2 dígitos máximo
x_tax_icoImpuesto al consumo ICONúmeros decimalesNúmero entero: 15 dígitos máximo
 Números decimales: 2 dígitos máximo
x_cantidad_baseValor sin IVANúmeros decimalesNúmero entero: 15 dígitos máximo
 Números decimales: 2 dígitos máximo
código_moneda_xCodigo de la moneda (COP,USD)Várchar3 caracteres máximo
x_nombre_banconombre del bancoVárchar255 caracteres máximo
x_número de tarjetaNombre del tarjetahabienteVárchar20 caracteres máximo
x_cuotasNúmero de cuotas a diferir el pagoNúmeros enteros2 dígitos máximo
x_respuestax_respuestaVárchar255 caracteres máximo
respuesta_xx_respuestaVárchar255 caracteres máximo
x_aprobación_códigocodigo de aprobacionVárchar255 caracteres máximo
x_transaction_idNumero de recibo de la transaccionVárchar255 caracteres máximo
x_fecha_transaccionFecha y hora de la transaccionFecha y horaYmd H:i:s
x_transacción_fechaFecha y hora de la transaccionFecha y horaYmd H:i:s
x_cod_respuestaCodigo de respuesta de la transaccionNúmeros enteros11 dígitos máximo
x_cod_respuestaCodigo de respuesta de la transaccionNúmeros enteros11 dígitos máximo
x_response_reason_textDescripcion de la respuestaVárchar255 caracteres máximo
x_código de errorCodigo error de la transaccionNúmeros enteros2 dígitos máximo
x_cod_transaction_stateCódigo estado de la transacciónVarchar255 caracteres máximo
x_transaction_stateEstado de la transacciónVarchar255 caracteres máximo
x_franchiseFranquiciasVarchar255 caracteres máximo
x_businessNegocioVarchar255 caracteres máximo
x_customer_doctypeTipo de documento del tarjetahabienteVarchar10 caracteres máximo
x_customer_documentDocumento del tarjetahabienteVarchar100 caracteres máximo
x_customer_nameNombre del tarjetahabienteVarchar45 caracteres máximo
x_customer_lastnameApellidos del tarjetahabienteVarchar45 caracteres máximo
x_customer_emailEmail del tarjetahabienteVarchar45 caracteres máximo
x_customer_phoneTeléfono del tarjetahabienteVarchar255 caracteres máximo
x_customer_movilCelular del tarjetahabienteVarchar50 caracteres máximo
x_customer_ind_paisIndicador del país del clienteVarchar20 caracteres máximo
x_customer_countryPaís del tarjetahabienteVarchar255 caracteres máximo
x_customer_cityCiudad del tarjetahabienteVarchar255 caracteres máximo
x_customer_addressDirección del tarjetahabienteVarchar255 caracteres máximo
x_customer_ipUbicación IP del tarjetahabienteVarchar255 caracteres máximo
x_signatureLlave de seguridad generada por ePayco para firmar los valores enviados a las url de respuesta y de confirmaciónTextNo aplica
x_test_requestEstado de la petición (prueba="TRUE" producción="FALSE")Varchar20 caracteres máximo
x_extra1Dato extra 1Varchar255 caracteres máximo
x_extra2Dato extra 2Varchar255 caracteres máximo
x_extra3Dato extra 3Varchar255 caracteres máximo
x_extra4Dato extra 4Varchar255 caracteres máximo
x_extra5Dato extra 5Varchar255 caracteres máximo
x_extra6Dato extra 6Varchar255 caracteres máximo
x_extra7Dato extra 7Varchar255 caracteres máximo
x_extra8Dato extra 8Varchar255 caracteres máximo
x_extra9Dato extra 9Varchar255 caracteres máximo
x_extra10Dato extra 10Varchar255 caracteres máximo

Tener en cuenta:
Los parámetros x_cod_responsex_responsex_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 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

AMAmex
BABaloto
CRCredencial
DCDiners Club
EFEfecty
GAGana
PRPunto Red
RSRed Servi
MCMastercard
PSEPSE
SPSafetyPay
VSVisa

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
EstadoResponse
1Aceptadala transacción fue aprobada
2Rechazada 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.
3PendienteLa 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.
4FallidaNo se culmina el flujo de creación de la transacción de manera exitosa
6ReversadaReintegro 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.
7retenidoLa 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)
8iniciadaEstado interno para iniciar una transacción
9caducadaTransacció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)
10abandonadaEl usuario por algún motivo cerró el navegador y no culminó el proceso de diligenciamiento de la información.
11CanceladaEl 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:

codigoTipo de documento

CC

Cédula de ciudadanía

CE

Cédula de extranjería

NPP

Pasaporte

Número de Seguro Social

número de seguridad social

licencia de conducir

licencia de conduccion

LIENDRE

numero de identificacion tributaria

TI

tarjeta de identidad

DNI

Documento nacional de identificacion


Was this article helpful?