Payco, Paga y Cobra Online S.A.S - Integración Botón de Pagos (WebCkeckout) epayco

Transcripción

1 Integración Botón de Pagos (WebCkeckout) epayco

2 VARIABLES QUE SE DEBEN ENVIAR A LA PASARELA A continuación se muestra las variables que deben ser enviadas a través de un formulario por el método POST vía HTTP. Campo Tipo Tamaño Descripción Requerido p_cust_id_cliente Id del comercio Si p_key Llave de seguridad del comercio Si p_id_invoice Id de la factura Si p_description Descripción del producto Si p_amount Valor total del producto Si p_amount_base Valor sin IVA Si p_tax IVA Si p_ del cliente que realizara la transacción p_currency_code Código de la moneda (COP,USD) Si p_signature p_test_request p_customer_ip p_url_response p_url_confirmation p_confirm_method Firma de seguridad para validar que los datos enviados en el formulario no hayan sido modificados por el cliente o mientras viajan a nuestra plataforma asegurando la integridad de los datos. Fase de integración (TRUE: en pruebas, FALSE: en producción) Dirección IP del cliente que realizara la transacción url donde retornaran los datos después de la transacción url donde confirman los datos de la transacción a nivel de servidor a servidor. Método de confirmación (POST O GET) p_extra1 Dato extra 1 p_extra2 Dato extra 2 p_extra3 Dato extra 3 Si Si Si

3 URL Formulario Todas las variables deben ser enviadas a través del método http POST a la siguiente URL: VARIABLES QUE SON RETORNADAS DESDE LA PASARELA Después de finalizar una transacción con un botón de pago, botón de donación o link de cobro se retornan los siguientes datos a la URL de respuesta por POST y a la URL de confirmación según el método enviado en la variable p_confirm_method. Campo Tipo Tamaño Descripción x_cust_id_cliente x_description x_amount_ok x_id_invoice x_amount_base x_tax x_currency_code x_franchise x_customer_ip x_transaction_date x_ approval_code x_transaction_id x_ref_payco x_cod_response x_response x_response_reason_text Id del cliente Descripción del producto Valor total del producto Id de la factura Valor sin IVA IVA Código de la moneda (COP,USD) Franquicia (VISA, AMEX, AMERICAN EXPRESS ) Dirección IP donde se originó la transacción Fecha y hora de la transacción Código de aprobación Numero de recibo de la transacción Numero de referencia de payco Código de la respuesta Respuesta o estado de la transacción (Aceptada, Rechazada, Pendiente) Descripción de la respuesta x_extra1 Dato extra 1 x_extra2 Dato extra 2 x_extra3 Dato extra 3

4 FORMULARIO DE PAGO (EJEMPLO) Ejemplo HTML con algunos de los parámetros que deben ser enviados: <form method="post" action=" <input name="p_cust_id_cliente" type="hidden" value="8979"> <input name="p_key" type="hidden" value=" cffc021399e9be5c0288ae43238cdbbf943e649d"> <input name="p_id_invoice" type="hidden" value="312312"> <input name="p_description" type="hidden" value="epayco Test"> <input name="p_currency_code" type="hidden" value="cop"> <input name="p_amount" type="hidden" value="80000"> <input name="p_tax" type="hidden" value="0"> <input name="p_amount_base" type="hidden" value="0"> <input name="p_test_request" type="hidden" value="true"> <input name="p_url_response" type="hidden" value=" <input name="p_url_confirmation" value=" <input name="p_confirm_method" type="hidden" value="post"> <input name="p_signature" type="hidden" value="a76d408a c78642d6d0a37"> <input type="image" src=" 60bf0867add971908d4f26a64519c2aa.ssl.cf5.rackcdn.com/files/boton.png" value="pagar_epayco" /> </form> CODIGOS DE RESPUESTA (ESTADO DE TRANSACCIONES) A continuación se muestran los códigos de respuesta que son retornados por epayco los cuales deben ser tenidos en cuenta al momento de registrar la confirmación del pago en su base de datos. Código de Respuesta x_cod_response Respuesta x_response 1 Aceptada 2 Rechazada 3 Pendiente 4 Fallida

5 LLAVE SECRETA P_KEY Y P_SIGNATURE El p_cust_id_cliente y p_key son dos variables obligatorias al momento de generar el pago en la pasarela porque identifican al comercio que esta realizando la transacción. Estos valores los puede encontrar en su panel de clientes en el menú llave secreta. p_signature Firma de seguridad para validar que los datos enviados en el formulario no hayan sido modificados por el cliente o mientras viajan a nuestra plataforma asegurando la integridad de los datos. Generación p_siganture. Para generar esta firma es necesario encriptar con md5 las siguiente variables: (p_cust_id_cliente+p_key+p_id_invoice+p_amount+p_currency_code), separadas por el carácter ^. Ejemplo en PHP generación p_signature. $p_signature= md5($p_cust_id_cliente. ^.$p_key. ^.$p_id_invoice. ^.$p_amount. ^.$p_currency_code );

6 TARJETAS DE CREDITO PARA PRUEBAS Franquicia: Visa Numero: Fecha Expiración: 06/18 Cvv: 123 Estado: Aceptada Respuesta: Aceptada Franquicia: Visa Numero: Fecha Expiración: 06/18 Cvv: 123 Estado: Rechazada Respuesta: Fondos Insuficientes