Integración personalizada
  • 16 May 2024
  • 1 Minute to read
  • Contributors
  • Dark
    Light

Integración personalizada

  • Dark
    Light

Article summary

Con esta integración podrás desplegar nuestro checkout con cualquier evento en javascript 

Agrega el script en su web.

<script type="text/javascript" src="https://checkout.epayco.co/checkout.js">script>

Configuración inicial

key: llave secreta del comercio.

test: true (prueba), false (producción).

var handler = ePayco.checkout.configure({
  				key: '45b960805ced5c27ce34b1600b4b9f54',
  				test: true
  			});
 
Configuración de variables

Iniciar un objeto con los parámetros de la compra, atributos del cliente y ocultar métodos de pago

var data={
          //Parametros compra (obligatorio)
          name: "Vestido Mujer Primavera",
          description: "Vestido Mujer Primavera",
          invoice: "FAC-1234",
          currency: "cop",
          amount: "5000",
          tax_base: "4000",
          tax: "500",
          tax_ico: "500",
          country: "co",
          lang: "en",

          //Onpage="false" - Standard="true"
          external: "true",


          //Atributos opcionales
          extra1: "extra1",
          extra2: "extra2",
          extra3: "extra3",
          confirmation: "http://secure2.payco.co/prueba_curl.php",
          response: "http://secure2.payco.co/prueba_curl.php",

          //Atributos cliente
          name_billing: "Jhon Doe",
          address_billing: "Carrera 19 numero 14 91",
          type_doc_billing: "cc",
          mobilephone_billing: "3050000000",
          number_doc_billing: "100000000"
          email_billing: "jhondoe@epayco.com"

         //atributo deshabilitación método de pago
          methodsDisable: ["TDC", "PSE","SP","CASH","DP"]

          }

 

Es importante que en la url que configure para la confirmación de la transacción haga una validación del monto y la factura que se está pagando, estos valores deben coincidir con los parámetros inicialmente configurado en la transacción 
 Desplegar checkout
handler.open(data)

Atributos checkout

Conoce las opciones de personalización.

CampoRequeridoDescripciónEjemplo
externalNoCon este atributo determinas el tipo de checkout.true - false
keySiPublic key del comercio491d6a0b6e992cf924edd8d3d088aff1
amountSiMonto total de la transacción. Se permite el uso del punto como separador de decimal.5000 o 1000000.89
tax_baseNoMonto antes de impuesto4000
taxNoMonto impuestos (IVA)500
tax_icoNoImpuesto al consumo (Impoconsumo)500
nameSiTítulo del cobroVestido Mujer Primavera
descriptionSiDescripción del cobroVestido rojo para el verano
currencySiMonedacop ó usd
countrySiPaís del cobroCO
langNoIdioma del Checkout
ES,EN
testSitrue = pruebas
false = producción
true ó false
invoiceNoNúmero de factura del productoabc123
extra1NoCampo 1 de información extraDato extra 1
extra2NoCampo 2 de información extraDato extra 2
extra3NoCampo 3 de información extraDato extra 3
responseNoPágina de respuesta personalizada ó dinámicahttp://midominio.com/respuesta.html
aceptedNoUrl estática para transacción aceptadahttp://misitio.com/aceptada.html
rejectedNoUrl estática para transacción rechazadahttp://misitio.com/rechazada.html
pendingNoUrl estática para transacción pendientehttp://misitio.com/pendiente.html
confirmationNoPágina de confirmación dinámicahttp://midominio.com/confirmation
unique_transaction_per_bill
NoTransacción única por facturatrue

Atributos cliente (Opcional)

A continuación se describen los parámetros para el envió de información de clientes.

CampoDescripciónEjemplo
name-billingNombre del cliente pagadorAndres Perez
address-billingDirección del cliente pagadorCarrera 19 numero 14 91
type-doc-billingTipo de documento del cliente pagadorCC (Tipo de documento del cliente pagador)
mobilephone-billingTeléfono del cliente pagador3050000000
number-doc-billingNúmero de documento del cliente pagador1073000000
email-billingCorreo electrónico del cliente pagadorandresperez@epayco.com

Ocultar métodos de pago(Opcional)

Con esta opción podrá ocultar uno o mas medio de pago para no recibir pagos desde estos a excepción del medio de pago Davivienda.

CampoDescripciónEjemplo
methodsDisableOcultar métodos de pago["TDC"] tarjeta de crédito
["PSE"] PSE
["SP"] SafetyPay
["CASH"] Efectivo
["DP"] Daviplata

Was this article helpful?