
INTRODUCCIÓN
CONSOLA
WEBCHECKOUT
WIDGET
CARTAS DE PAGO
PLUGINS
INTEGRACIONES
POSTMAN COLLECTION
CONEXIONES API COMUNES
CARD
WEBHOOK
Última actualización: 10 de octubre de 2024
INTRODUCCIÓN
CONSOLA
WEBCHECKOUT
WIDGET
CARTAS DE PAGO
PLUGINS
INTEGRACIONES
POSTMAN COLLECTION
CONEXIONES API COMUNES
CARD
WEBHOOK
WebCheckout
¿QUÉ ES NUESTRO WEBCHECKOUT?
¿Cómo crear un link con valor fijo para el WebCheckout?
Inicialmente, tienes que crear una terminal seguido de esto tienes que crear un botón de pago
Te diriges a nuestro menú en donde buscaras un apartado llamado «Links de pago»

En este apartado tendras dos opciones:
En este apartado tendras dos opciones:
- Crear links masivos
- Crear link de pago
CREAR LINKS MASIVOS
Esta función te permitirá crear links masivos para diferentes clientes en específico a partir de una plantilla de Excel

CREAR LINK DE PAGO
Esta función te permitirá crear links masivos para diferentes clientes en específico a partir de una plantilla de Excel

LINK GENERADO
Una vez creado el link te aparecerá en la tabla mostrando la descripción, monto a pagar y la fecha de vencimiento y tendremos los links generados en los que tendrás 3 opciones
- Ver: Esta opción te abrirá el link hacia el WebCheckout
- Copiar: Esta opción te copiará el link en la clipboard, podrás pegarlo en cualquier parte que lo necesites, la diferencia con ver el link es que esta opción te generara un link recortado
- Compartir: Esta opción te abrirá un modal en el que podrás colocar el número del cliente y enviárselo, al igual que la opción de copiar te generara un link recortado

¿Cómo crear un link con valor dinamico para el WebCheckout?
Inicialmente, tienes que crear una terminal seguido de esto tienes que crear un botón de pago
Te diriges a nuestro menú en donde buscaras un apartado llamado «Links de pago express»
Seleccionas la opción crear link de pago abierto.

Inicialmente, tienes que crear una terminal seguido de esto tienes que crear un botón de pago
Te diriges a nuestro menú en donde buscaras un apartado llamado «Links de pago express»
Seleccionas la opción crear link de pago abierto.

Botones de pago
- Para el correcto acceso a la consola de Coltefinanciera, usted deberá ingresar con su usuario y contraseña, el cual fue enviado a su correo electrónico.

- Una vez haya ingresado a nuestra plataforma, se re direccionará al “Botón de pagos”.

- Creara el botón de pago para el comercio/persona.

WebCheckout
¿QUÉ ES NUESTRO WEBCHECKOUT?
¿Cómo crear un link con valor fijo para el WebCheckout?
Inicialmente, tienes que crear una terminal seguido de esto tienes que crear un botón de pago
Te diriges a nuestro menú en donde buscaras un apartado llamado «Links de pago»

En este apartado tendras dos opciones:
En este apartado tendras dos opciones:
- Crear links masivos
- Crear link de pago
CREAR LINKS MASIVOS
Esta función te permitirá crear links masivos para diferentes clientes en específico a partir de una plantilla de Excel

CREAR LINK DE PAGO
Esta función te permitirá crear links masivos para diferentes clientes en específico a partir de una plantilla de Excel

LINK GENERADO
Una vez creado el link te aparecerá en la tabla mostrando la descripción, monto a pagar y la fecha de vencimiento y tendremos los links generados en los que tendrás 3 opciones
- Ver: Esta opción te abrirá el link hacia el WebCheckout
- Copiar: Esta opción te copiará el link en la clipboard, podrás pegarlo en cualquier parte que lo necesites, la diferencia con ver el link es que esta opción te generara un link recortado
- Compartir: Esta opción te abrirá un modal en el que podrás colocar el número del cliente y enviárselo, al igual que la opción de copiar te generara un link recortado

¿Cómo crear un link con valor dinamico para el WebCheckout?
Inicialmente, tienes que crear una terminal seguido de esto tienes que crear un botón de pago
Te diriges a nuestro menú en donde buscaras un apartado llamado «Links de pago express»
Seleccionas la opción crear link de pago abierto.

Inicialmente, tienes que crear una terminal seguido de esto tienes que crear un botón de pago
Te diriges a nuestro menú en donde buscaras un apartado llamado «Links de pago express»
Seleccionas la opción crear link de pago abierto.

BOTÓN DE PAGO
<form method="Post" action="https://merchant.coltefinanciera.com.co/cartaspago/redirect">
<input name="merchant_id" type="hidden" value="0">
<input name="form_id" type="hidden" value="0">
<input name="terminal_id" type="hidden" value="0">
<input name="order_number" type="hidden" value="0">
<input name="amount" type="hidden" value="0">
<input name="currency" type="hidden" value="cop">
<input name="order_description" type="hidden" value="Test de compra">
<input name="client_email" type="hidden" value="user@example.com">
<input name="client_phone" type="hidden" value="3000000000">
<input name="client_firstname" type="hidden" value="pepito perez">
<input name="client_lastname" type="hidden" value="ramirez ramirez">
<input name="client_doctype" type="hidden" value="4">
<input name="client_numdoc" type="hidden" value="1234567890">
<input name="response_url" type="hidden" value="http://www.test.com/response">
<input name="Submit" type="submit" value="Enviar">
</form>
PARÁMETROS MÍNIMOS A ENVIAR EN EL FORMULARIO:
CAMPO | TIPO | DESCRIPCION | OBLIGATORIO |
---|---|---|---|
additional_data | Alfa numérico | Información adicional del pago | No |
amount | Numérico | Es el monto total de la transacción. | Si |
client_doctype | Alfa numérico | Es el tipo de documento del cliente. | Si |
client_email | Alfa numérico | Es el correo electrónico del cliente. | Si |
client_firstname | Alfa numérico | Es el primer nombre del cliente. | Si |
client_lastname | Alfa numérico | Son los apellidos del cliente. | Si |
client_numdoc | Numérico | Es el numéro de documento del cliente. | Si |
client_phone | Numérico | Es el número de celular de contacto del cliente. | Si |
currency | Alfa numérico | La moneda respectiva en la que se realiza el pago. El proceso de conciliación se hace en pesos a la tasa representativa del día. Ej. COP | Si |
form_id | Numérico | Es el número identificador del boton de pago que encontrara con el identificado "ID" en cada tarjeta de cada botón de pago. | Si |
merchant_id | Numérico | Es el número identificador del comercio en el sistema , este número lo encontrarás en la sección "Mis credenciale". | Si |
order_description | Alfa numérico | Es la descripción de la venta. | Si |
order_number | Alfa numérico | Es la referencia de la venta o pedido. Deber ser único por cada transacción que se envía al sistema. | Si |
plan_id | Numérico | Plan al cual sera asociado el pago, usado para cobros recurrentes. | No |
response_url | Alfa numérico | Url de respuesta para el cliente. | No |
terminal_id | Numérico | Id de la terminal | Si |
TIPO DE DOCUMENTO DEL CLIENTE
Este campo se debe generar con su id correspondiente dependiedo de la descripción para el tipo de documento de la siguiente manera:
- id=»1″: Pasaporte.
- id=»4″: Cédula de ciudadanía.
- id=»5″: Cédula de extranjería.
- id=»6″: NIT.
CURRENCY
Este campo se debe generar con su value correspondiente dependiedo de la descripción del tipo de moneda de la siguiente manera:
- value=»COP»: Pesos colombianos.
- value=»USD»: Dolares americanos.
- value=»EUR»: Euros.
MODO DE USO
Una vez copiado el código en su pagina web o E-commerce usted podrá visualizar el siguiente botón: ((Recuerde que el botón tendrá los estilos que usted desee implementar en su pagina Web o E-commerce).)
Modificando el atributo <name=”currency”> dentro
< /form>
usted podrá cambiar la moneda con la cual se efectuará su pago.
- Hará Clic en el botón enviar, el cual lo re direccionará a la pasarela de pagos, donde procederá a elegir el método de pago (Tarjeta, Pse o Efectivo) y finalmente realizar su pago.

BOTÓN DE PAGOS ABIERTOS
<form method="post " action="https://merchant.coltefinanciera.com.co/cartaspago/redirect">
<input name="merchant_id" type="hidden" value="0" >
<input name="form_id" type="hidden" value="0" >
<input name="terminal_id" type="hidden" value="0" >
<input name="order_number" type="hidden" value="1254>"
<input name="amount" type="hidden" value="0" >
<input name="currency" type="hidden" value="cop" >
<input name="type_method" type="hidden" value="0" >
<input name="amount_1" type="hidden" value="10000" >
<input name="amount_2" type="hidden" value="20000" >
<input name="amount_3" type="hidden" value="30000" >
<input name="amount_4" type="hidden" value="40000" >
<input name="min_amount" type="hidden" value="10000" >
<input name="max_amount" type="hidden" value="40000" >
<input name="client_email" type="hidden" value="user@example.com" >
<input name="client_phone" type="hidden" value="3000000000" >
<input name="client_firstname" type="hidden" value="pepito perez" >
<input name="client_lastname" type="hidden" value="ramirez ramirez" >
<input name="client_doctype" type="hidden" value="4" >
<input name="client_numdoc" type="hidden" value="1234567890" >
<input name="response_url" type="hidden" value="http://www.test.com/response" >
<input name="Submit" type="submit" value="Enviar" >
</form>
PARÁMETROS MÍNIMOS A ENVIAR EN EL FORMULARIO:
CAMPO | TIPO | DESCRIPCION | OBLIGATORIO |
---|---|---|---|
additional_data | Alfa numérico | Url de respuesta para el cliente. | Si |
amount | Numérico | Es el monto total de la transacción. | Si |
amount_1 | Numérico | Es el primer valor a sugerir dentro del botón de pago abierto (Opcional). | Si |
amount_2 | Numérico | Es el segundo valor a sugerir dentro del botón de pago abierto (Opcional). | Si |
amount_3 | Numérico | Es el tercer valor a sugerir dentro del botón de pago abierto (Opcional). | Si |
amount_4 | Numérico | Es el cuarto valor a sugerir dentro del botón de pago abierto (Opcional). | Si |
client_doctype | Alfa numérico | Es el tipo de documento del cliente. | Si |
client_email | Alfa numérico | Es el correo electrónico del cliente. | Si |
client_firstname | Alfa numérico | Es el primer nombre del cliente. | Si |
client_lastname | Alfa numérico | Son los apellidos del cliente. | Si |
client_numdoc | Numérico | Es el numéro de documento del cliente. | Si |
client_phone | Numérico | Es el número de celular de contacto del cliente. | Si |
currency | Alfa numérico | En el tipo de botón abierto solo se podrán realizar pagos en COP. | Si |
form_id | Numérico | Es el número identificador del boton de pago que encontrara con el identificado "ID" en cada tarjeta de cada botón de pago. | Si |
max_amount | Numérico | Es el valor máximo por el cual se podrá realizar el pago. | Si |
merchant_id | Numérico | Es el número identificador del comercio en el sistema , este número lo encontrarás en la sección "Mis credenciale". | Si |
min_amount | Numérico | Es el valor mínimo por el cual se podrá realizar el pago. | Si |
order_description | Alfa numérico | Es la descripción de la venta. | Si |
order_number | Alfa numérico | Es la referencia de la venta o pedido. Deber ser único por cada transacción que se envía al sistema. | Si |
response_url | Alfa numérico | Url de respuesta para el cliente. | No |
type_method | Numérico | Es el número que identifica al botón de pago como "abierto" (Siempre su valor debe ser 2). | Si |
TIPO DE DOCUMENTO DEL CLIENTE
Este campo se debe generar con su id correspondiente dependiedo de la descripción para el tipo de documento de la siguiente manera:
- id=»1″: Pasaporte.
- id=»4″: Cédula de ciudadanía.
- id=»5″: Cédula de extranjería.
- id=»6″: NIT.
CURRENCY
Este campo se debe generar con su value correspondiente dependiedo de la descripción del tipo de moneda de la siguiente manera:
- value=»COP»: Pesos colombianos.
- value=»USD»: Dolares americanos.
- value=»EUR»: Euros.
MODO DE USO
Una vez copiado el código en su pagina web o E-commerce usted podrá visualizar el siguiente botón: (Recuerde que el botón tendrá los estilos que usted desee implementar en su pagina Web o E-commerce).
Haciendo clic en el botón enviar, usted será re direccionado a la pasarela de pagos abiertos, la cual se visualizará de la siguiente manera:

Para escoger los montos a pagar usted encontrará dos maneras de hacerlo:
- La primera será seleccionando alguna de las cuatro opciones que se muestran en pantalla.

Con el botón de pago, su cliente tendrá la opción de elegir el monto con el cual desea realizar el pago. Estos valores podrán ser modificados de manera manual cambiando los parámetros del amount.
<input name=" amount_1" type="hidden" value="10000" >
<input name=" amount_2" type="hidden" value="20000" >
<input name=" amount_3" type="hidden" value="30000" >
<input name=" amount_4" type="hidden" value="40000" >
- En nuestra segunda opción su cliente podrá elegir de manera manual un monto en un intervalo mínimo y máximo, este valor se le ira indicado con una barra medidora la cual ira mostrando los montos elegidos en la parte superior.

Para modificar el rango mínimo y máximo del monto con el cual desea realizar el pago usted debería cambiar de manera manual los parámetros del amount.
<input name="min_amount" type="hidden" value="10000">
<input name="max_amount" type="hidden" value="40000">
- Una vez elegido el monto para realizar el pago, su cliente podrá elegir la opción de “Realizar pagos recurrentes” donde también podrá elegir el intervalo de tiempo por el cual se efectuarán esos pagos (Mensual, Trimestral, Semestral o Anual).
- Una vez elegido el monto para realizar el pago, su cliente podrá elegir la opción de “Realizar pagos recurrentes” donde también podrá elegir el intervalo de tiempo por el cual se efectuarán esos pagos (Mensual, Trimestral, Semestral o Anual).

- Para finalizar, su cliente deberá elegir el método de pago que mas cómodo le quede (Tarjeta crédito/debito, Pse o Efectivo).

WIDGET
NOTA:
Para el correcto uso del widget se tiene que dejar primeramente el script que haga el llamado a los recursos y luego el llamado del checkout
Acepte pagos en su sitio web en minutos, utilizando nuestra opción de Checkout; Permita que sus clientes completen un pago sin salir de su sitio web, simplemente incluyendo una etiqueta < script> dentro su página web. Para el uso del widget, inicialmente agregue en su documento lo siguiente:
1. En la parte del < head> agregaremos el siguiente css
<link rel="stylesheet" href="https://merchant.coltefinanciera.com.co/assetsWidget/css/index.css " />
2. Agregamos el siguiente script hasta el final del < body> , para que pueda cargar correctamente el script
<script src="https://merchant.coltefinanciera.com.co/assetsWidget/js/index.js"> </script>
3. Una vez agregados los hipervinculos y definido el espacio donde se visualizará nuestro widget, usted deberá anexar el siguiente código:
<div id="payment-widget" > </div>
4. Creara en su proyecto un < script> en el < body> . Es importante que se haga el llamado .Una vez creada la etiqueta, pondra la implementación del widget con el siguiente codigo
const checkout = new widgetCheckout({
merchant_id : 'su Merchant id' ,
form_id : 'su form id',
terminal_id : 'su terminal id',
order_number : 'su order number',
amount : 'finalPrice',
currency : 'COP',
order_description : 'Test de compra',
apikey : Apikey,
ip : '192.158.1.38',
additionalData : {...},
});
PARÁMETROS A ENVIAR EN EL WIDGET:
CAMPO | TIPO | DESCRIPCION | OBLIGATORIO |
---|---|---|---|
merchant_id | Alfa numérico | Es el número identificador del comercio en el sistema , este número lo encontrarás en la sección "Mis credenciale". | Si |
form_id | Alfa numérico | Es la referencia de la venta o pedido. Deber ser único por cada transacción que se envía al sistema. | Si |
order_number | Alfa numérico | Codigo de aletorio. | Si |
amount | Alfa numérico | Este campo se debe generar con su value correspondiente dependiedo de la descripción del tipo de moneda. | Si |
order_description | Alfa numérico | Descripción de la compra. | Si |
apikey | Alfa numérico | La llave de seguridad aparece en el dashboard de la consola. | Si |
additionalData | Objeto | Este campo te permite enviar cualquier información adicional, este es opcional. | Si |
redirect | String | Este campo te permite enviar una URL de respuesta, cuando el usuario realice el pago pueda ir a una URL configurada en este parámetro, este es opcional. | Si |
person | Object | Este objeto te permite enviar la información del cliente. const checkout = new widgetCheckout({ ...InformacionDelComercio, name : 'Nombre del cliente' , lastName : 'Apellido del cliente', email : 'Correo electrónico del cliente', identification : 'Identificación del cliente', identificationType : Tipo de identificación, sameData : 'Booleano que identifica si la información del usuario es la misma, haciendo que sea mas rapido el proceso de compra', }); | No |
TIPOS DE IDENTIFICACIÓN QUE SE PUEDEN ENVIAR EN EL WIDGET
NOMBRE DE LA IDENTIFICACIÓN | VALOR |
---|---|
Cédula de ciudadanía | 4 |
Cédula de extranjería | 5 |
Pasaporte | 1 |
METODOS
Actualizar monto de la transacción
const checkout = new widgetCheckout({
...InformacionDelComercio,
name : 'Nombre del cliente' ,
lastName : 'Apellido del cliente',
email : 'Correo electrónico del cliente',
identification : 'Identificación del cliente',
identificationType : Tipo de identificación,
});
al definir la variable que inicializa el widget, vas a poder tener un metodo para actualizar. En este caso llamamos la variable checkout
checkout.updateAmount(10000)
¿COMO OBTENER LOS DATOS PARA LA IMPLEMENTACIÓN DEL WIDGET?
1. Para obtener los datos, tendremos que ingresar a la consola de Coltefinanciera, usted deber ingresar con su usuario y contraseña.

2. Estando en la consola, usted dará click en el botón «Botones de pago»

3. Seleccionara el botón de pago que haga referencia a su comercio y a la función que desea cumplir

4. Una vez seleccionado el botón de pago de su comercio, al instante se abrirá una ventana en la cual usted podrá encontrar la información completa de su botón.
- Ubicaremos en el código el espacio <merchant_id> y copiaremos lo que esta dentro de las comillas del <value=»70″> (El número a copiar será el cual le indique la información de su botón de pago ya creado) a nuestro script y lo pegaremos en <merchant_id>

- Ubicaremos en el código el espacio <form_id> y copiaremos lo que esta dentro de las comillas del <value=»123″> (El número a copiar será el cual le indique la información de su botón de pago ya creado) a nuestro script y lo pegaremos en <form_id>

- Ubicaremos en el código el espacio <terminal_id> y copiaremos lo que esta dentro de las comillas del <value=»103″> (El número a copiar será el cual le indique la información de su botón de pago ya creado) a nuestro script y lo pegaremos en <terminal_id>

- Para el <order_number> recomendamos implementar un algoritmo para crear el mismo, esto debido a que no puede haber dos order_number con el mismo nombre
generateRandomString = (num) => {
const characters =
'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
let result1 = Math.random().toString(36).substring(num);
return result1;
};
- Para el amount se pondra el monto a pagar segun requiera su comercio. (Tenga en cuenta que puede ser cambiado de acuerdo a su necesidad)
- currency Este hará referencia al tipo de moneda con la cual usted recibira el dinero de su comercio («COP», «USD», «EUR»).
- En order_description usted podra poner la descripción correspondiente a su comercio.
- Para obtener la información de su apikey usted se redireccionara a la parte del inicio de la consola, en donde encontrara un espacio unico con la información del apikey.


MODO DE USO
Una vez implementado el WIDGET a su comercio, usted lo podrá visualizar con un botón de la siguiente manera:

A continuación, le explicaremos el paso a paso de lo que vera al realizar pagos.
- Elegirá el método de pago por el cual se realizará la transacción.




NOTA:
Solo las personas que tengan una URL autorizada pueden insertar la carta de pago, en llegado caso que necesites insertarla en tu sitio comunícate con:
¿Cómo crear una carta de pago?
Inicialmente, tienes que crear una terminal seguido de esto tienes que dirigirte a nuestro menú en donde buscaras un apartado llamado «Botones de pago». Una vez estés en la página. Selecciona el botón «Crear Botón de pago»

seleccionas después la opción «carta de pago» y podras crear tu carta de pago

¿Cómo usar una carta de pago?
Una vez creada la carta de pago, tendrás el listado de todas las cartas de pago y botones de pago que se hayan creado, podrás identificar que es una carta de pago de un botón de pago con el atributo de la tarjeta «Carta de pago». Podrás dar clic a la tarjeta y se abrirá un modal en el que puedes editar la carta de pago, adicional a esto hay dos botones
- Copiar embebido: con este botón se copiará un código HTML para que puedas insertarlo en tu HTML.
- Copiar URL: Te copiará solamente la URL.
Introducción
A continuación, usted encontrará una guía con el paso a paso de como Incluir el plugin Coltefinanciera con WooCommerce y lograr una integración satisfactoria con su Ecommerce. Ofrezca a sus clientes la posibilidad de generar pagos en línea de manera segura y confiable mediante la pasarela de pago Coltefinanciera. Para mas información puede consultar: Coltefinanciera
MONEDA
Para el correcto uso del plugin, usted debe utilizar una de las siguientes monedas: COP, USD y EUR.
REQUISITOS
- Acceso a cuenta Coltefinanciera
- Acceso a administrador wordpress
1. Para el correcto ACCESO a la consola de Coltefinanciera, usted deber ingresar con su usuario y contraseña.
2. Acceso a administrador wordpress


3. Suba el plugin, Instale y active.

4. Diríjase al apartado de wordpress y seleccione ajustes.

5. Accedemos al apartado de pagos

6. Activamos Coltefinanciera como pasarela de transacciones y guardamos cambios, una vez guardados los cambios Acedemos al apartado de configuración.

7. Ubique en configuración el campo obligatorio ID MERCHANT

- Ubique en la pasarela el campo obligatorio ID MERCHANT

8. Ubique en configuración el campo obligatorio ID TERMINAL

- Ubique en la pasarela el campo obligatorio ID TERMINAL

9. Ubique en configuración el campo obligatorio ID BOTON DE PAGO

- Ubique en la pasarela ID BOTON DE PAGO

10. Ubique en configuración el campo obligatorio APIKEY

- Ubique en la pasarela APIKEY

11. Ubique en configuración el campo obligatorio URL de retorno al ecommerce

12. Diríjase a su respectiva página de tienda.

13. Nos fijamos en la Url de nuestra tienda, tendran que copiar la URL completa de la página de destino

14. Por último, guardamos los cambios desde el administrador de wordpress

Introducción
A continuación, usted encontrará una guía con el paso a paso de como Incluir el plugin Coltefinanciera con PrestaShop y lograr una integración satisfactoria con su Ecommerce. Ofrezca a sus clientes la posibilidad de generar pagos en línea de manera segura y confiable mediante la pasarela de pago Coltefinanciera. Para mas información puede consultar: Coltefinanciera
MONEDA
Para el correcto uso del plugin, usted debe utilizar una de las siguientes monedas: COP, USD y EUR.
REQUISITOS
- Acceso a cuenta
- Acceso a administrador PrestaShop.
INSTALACIÓN
PASO 1: SUBIR EL PLUGIN
1. Navega hasta la sección «Módulos» y selecciona «Administrador de Módulos» en tu panel de Prestashop.

2. Haz clic en «Subir un módulo» y elige el archivo .zip del plugin Payments Way.
3. Una vez cargado el archivo, espera a que el proceso de instalación se complete automáticamente.
PASO 2: CONFIGURACIÓN DE LA PASARELA DE PAGOS
1. En el mismo panel de Módulos, localiza el plugin Payments Way y selecciona «Configurar».

2. Ingresa las claves de acceso y demás información requerida para la pasarela de pagos en los campos correspondientes.

3. Verifica que todos los datos sean correctos y, a continuación, haz clic en «Guardar» para aplicar los cambios.
PASO 3: AJUSTE DE PREFERENCIAS DE PAGO
1. Dirígete a «Pagos» y luego a «Preferencias» en el menú principal de Prestashop

2. Dentro de Preferencias, ajusta todas las opciones relacionadas con los pagos, incluyendo restricciones por moneda, grupos de usuarios, países y transportadoras.

3. Después de configurar cada opción, asegúrate de guardar los cambios para que se apliquen correctamente.
Introducción
INSTALACIÓN
1. Ingresamos a nuestro panel de control con el usuario y contraseña de cPanel.

2. Dentro de cPanel nos dirigimos al administrador de archivos.

3. Dentro del administrador de archivos, buscamos nuestra carpeta raíz donde está instalado Magento.
4. En la carpeta raíz de Magento, ingresamos a la carpeta «app». Luego, subimos el archivo .zip del plugin «plugin-magento-paymentsway» y lo descomprimimos. Esto creará una nueva carpeta llamada «code», completando la instalación del plugin.
CONFIGURACIÓN
1. Ingresamos al administrador de nuestro ambiente de Magento.

2. Dentro del administrador de Magento, nos dirigimos a stores/configuration.

3. En el menú lateral izquierdo, vamos a la sección sales/Payments Way Configuration.


4. En la sección de Payments Way Configuration, agregamos los datos correspondientes a nuestra terminal, formulario, merchant, apikey y response url de nuestro comercio de Payments Way.

INTEGRACIONES
Con Coltefinanciera tienes tres formas diferentes de integrar nuestra pasarela a su E-commerce o pagina web. A continuación encontrarás un resumen de cómo funciona cada uno:
WIDGET

Con solo unas pocas líneas de código, integre nuestro widget de pagos, permitiendo que sus clientes paguen sin salir de su sitio Web.
COMPLEMENTOS PARA CMS

La consola de Coltefinanciera te permite También utilizar un formulario HTML normal para redirigir a sus clientes a nuestro Web Checkout seguro.
COMPLEMENTOS DE COMERCIO
Acepte pagos en su tienda online en segundos.
Ahora puede aceptar pagos en su tienda en línea, utilizando nuestros complementos de comercio electrónico.
GET Obtener Tipos Identificación
https://serviceregister.coltefinanciera.com.co/ClientAPI/ObtenerTiposIdentificacion
HEADERS
Para consumir el servicio «obtener tipos identificación» necesitaremos en el header de la petición su Api_key
EJEMPLO DE LA PETICIÓN
var myHeaders = new Headers();
myHeaders.append ("Authorization", "Api_key");
var requestOptions = {
method: 'GET',
headers: myHeaders,
redirect: 'follow'
};
fetch("https://serviceregister.coltefinanciera.com.co/ClientAPI/ObtenerTiposIdentificacion", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));
GET Obtener Tipos de estados
https://serviceregister.coltefinanciera.com.co/ClientAPI/GetAllTransactionStatuses
HEADERS
Para consumir el servicio «obtener tipos de respuestas» necesitaremos en el header de la petición su Api_key
EJEMPLO DE LA PETICIÓN
var myHeaders = new Headers();
myHeaders.append ("Authorization", "Api_key");
var requestOptions = {
method: 'GET',
headers: myHeaders,
redirect: 'follow'
};
fetch("https://serviceregister.coltefinanciera.com.co/ClientAPI/GetAllTransactionStatuses", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));
POST Crear persona
https://serviceregister.coltefinanciera.com.co/ClientAPI/CrearPersona
PARAMETRIZACIÓN
Para consumir el servicio «obtener transacción» necesitaremos en el header de la petición su Api_key
CAMPO | TIPO | DESCRIPCION | REQUERIDO |
---|---|---|---|
address | string | Dirección del cliente. | No |
city | string | Ciudad del cliente. | No |
string | Email del cliente | Si | |
firstname | string | Nombre del cliente. | Si |
identification | string | Identificación del cliente | Si |
ididentificationtype | string | Tipo de identificación del cliente se obtiene del endpoint (Obtener Tipos Identificación). | Si |
lastname | string | Apellidos del cliente | Si |
phone | string | Celular del cliente. | Si |
zipcode | string | Código postal del cliente | No |
EJEMPLO DE LA PETICIÓN
var myHeaders = new Headers();
myHeaders.append ("x-api-key", "Api_key");
var cuerpo = {
{
"firstname" : "Nombre",
"lastname" : "Apellidos",
"ididentificationtype" : "4",
"identification" : "10000000",
"email" : "correo@Prueba.com",
"phone" : "30900000",
"state" : "",
"city" : "",
"address" : "",
"zipcode" : "",
}
}
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: cuerpo
redirect: 'follow'
};
fetch("https://serviceregister.coltefinanciera.com.co/ClientAPI/CrearPersona", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));
POSIBLES ESTADOS
200 || 500
GET Obtener Transacción
https://serviceregister.coltefinanciera.com.co/ClientAPI/ObtenerTransaccionByExternalOrder?external_order=asdasda-a26f-4153-9c6e-ff242d752b02
HEADERS
Para consumir el servicio «obtener transacción» necesitaremos en el header de la petición su Api_key
EJEMPLO DE LA PETICIÓN
var myHeaders = new Headers();
myHeaders.append ("Authorization", "Api_key");
var requestOptions = {
method: 'GET',
headers: myHeaders,
redirect: 'follow'
};
fetch("https://serviceregister.coltefinanciera.com.co/ClientAPI/ObtenerTransaccionByExternalOrder?external_order=(external order)", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));
POST Obtener Persona Por Documento
https://serviceregister.coltefinanciera.com.co/ClientAPI/ObtenerPersonaPorDocumento
HEADERS
Para consumir el servicio de «obtener persona por documento» necesitaremos en el header de la petición su Api_key
PARAMETRIZACIÓN
CAMPO | TIPO | DESCRIPCION | REQUERIDO |
---|---|---|---|
nroDocumento | integer | Documento de la persona | Si |
CUERPO DE LA PETICION
Para consumir el servicio «obtener persona por documento» en el body de la petición colocara los siguientes datos:
{
"nroDocumento" : 1012427594,
}
EJEMPLO DE LA PETICIÓN
var myHeaders = new Headers();
myHeaders.append ("x-api-key", "Api_key");
var cuerpo = {
"nroDocumento" : 1012427594,
}
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: cuerpo
redirect: 'follow'
};
fetch("https://serviceregister.coltefinanciera.com.co/ClientAPI/ObtenerPersonaPorDocumento", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));
POST Reversar Transaccion
https://serviceregister.coltefinanciera.com.co/ClientAPI/ReversarTransaccion
idTransaction, Identificador de la transaccion de Coltefinanciera, se obtiene al recibir la respuesta de «Crear Transaccion tarjeta de credito»
HEADERS
Para consumir el servicio de «reversar transacción» necesitaremos en el header de la petición su Api_key
PARAMETRIZACIÓN
CUERPO DE LA PETICION
Para consumir el servicio «reversar transacción» en el body de la petición colocara el siguiente dato
{
"idTransaction" : 1360,
}
EJEMPLO DE LA PETICIÓN
var myHeaders = new Headers();
myHeaders.append ("Authorization", "Api_key");
var cuerpo = {
"idTransaction" : 1360,
}
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: cuerpo
redirect: 'follow'
};
fetch("https://serviceregister.coltefinanciera.com.co/ClientAPI/ReversarTransaccion", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));
Para poder tokenizar una tarjeta de crédito primero debes crear una persona, al crear la persona te retorna un ID este deberás pasarlo al siguiente endpoint.
POST Tokenizar Persona
https://serviceregister.coltefinanciera.com.co/ClientAPI/TokenizarDatosPersona
HEADERS
Para consumir el servicio necesitaremos en el header de la petición su Api_key
PARAMETRIZACIÓN
CUERPO DE LA PETICION
{
"documento" : 0000000000,
"identification_type" : 4,
"idperson" : 0,
"url" : "URL DEL COMERCIO",
}
EJEMPLO DE LA PETICIÓN
var myHeaders = new Headers();
myHeaders.append ("Authorization", "Api_key");
var cuerpo = {
"documento" : 0000000000,
"identification_type" : 4,
"idperson" : 0,
"url" : "URL DEL COMERCIO"
}
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: cuerpo
redirect: 'follow'
};
fetch("https://serviceregister.coltefinanciera.com.co/ClientAPI/TokenizarDatosPersona", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));
Integracion del emebed
NOTA:
Tienes que aprobar la url para poder utilizar el embed, si no llegas a hacerlo esto no te aparecerá el embed. Para contactarte y aprobar la url puedes hacerlo a este correo: tecnologia@paymentsway.co
Una vez enviada la petición te retornará un objeto que tiene dentro un «data», tendrás que copiar el token generado en donde tendrás que concatenar la variable en la siguiente URL: «https://merchant.coltefinanciera.com.co/tokenizacion/?p=» un código de ejemplo de como podrías hacerlo:
<body >
<embed id="embed" type="" width="500px" height="320px" >
</body >
<script defer>
const token = 'El token generado'
document.getElementById('embed').src = `https://merchant.coltefinanciera.com.co/tokenizacion/?p=${token}`
</script>
Realizar transacción
POST Crear Transacción
https://serviceregister.coltefinanciera.com.co/ClientAPI/CrearTransaccion
Una vez el ususario ingrese la tarjeta de credito en el embed, tendras que crear una transacción
CUERPO DE LA PETICION
{
"form_id" : "",
"terminal_id" : "",
"idperson" : "",
"amount" : "",
"external_order" : "Indicador por comercio",
"ip" : "",
"additionalData" : "",
"currencycode" : "COP",
}
EJEMPLO DE LA PETICIÓN
var myHeaders = new Headers();
myHeaders.append ("Authorization", "Api_key");
var cuerpo = {
"form_id" : "",
"terminal_id" : "",
"idperson" : "",
"amount" : "",
"external_order" : "Indicador por comercio",
"ip" : "",
"additionalData" : "",
"currencycode" : "COP",
}
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: cuerpo
redirect: 'follow'
};
fetch("https://serviceregister.coltefinanciera.com.co/ClientAPI/CrearTransaccion", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));
POST Crear Orden
Cuando creamos una transacción nos devuelve un id, este id lo tenemos que enviar en este endpoint
https://serviceregister.coltefinanciera.com.co/ClientAPI/CrearOrdenTransaccionTC
CUERPO DE LA PETICION
{
"description" : "",
"tran_id" : 100,
}
EJEMPLO DE LA PETICIÓN
var myHeaders = new Headers();
myHeaders.append ("Authorization", "Api_key");
var cuerpo = {
"description" : "",
"tran_id" : 100,
}
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: cuerpo
redirect: 'follow'
};
fetch("https://serviceregister.coltefinanciera.com.co/ClientAPI/CrearOrdenTransaccionTC", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));
GET Traer Token Tarjeta
Traemos el token de la tarjeta del cliente
https://serviceregister.coltefinanciera.com.co/ClientAPI/GetTarjetabiente
CUERPO DE LA PETICION
{
"documento" : 1000,
}
EJEMPLO DE LA PETICIÓN
var myHeaders = new Headers();
myHeaders.append ("Authorization", "Api_key");
var cuerpo = {
"documento" : 1000,
}
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: cuerpo
redirect: 'follow'
};
fetch("https://serviceregister.coltefinanciera.com.co/ClientAPI/GetTarjetabiente", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));
POST Ejecutar Orden
Ejecutamos la transaccion con el siguiente endpoint
https://serviceregister.coltefinanciera.com.co/ClientAPI/EjecutarOrdenTransaccionTC
CUERPO DE LA PETICION
{
"orden" : "Obtenido del endpoint Crear Orden",
"hash" : "Obtenido del endpoint Tokenizar Persona",
"tran_id" : 1000 (Obtenido del endpoint Crear Transacción),
}
EJEMPLO DE LA PETICIÓN
var myHeaders = new Headers();
myHeaders.append ("Authorization", "Api_key");
var cuerpo = {
"orden" : "Obtenido del endpoint Crear Orden",
"hash" : "Obtenido del endpoint Tokenizar Persona",
"tran_id" : 1000 (Obtenido del endpoint Crear Transacción),
}
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: cuerpo
redirect: 'follow'
};
fetch("https://serviceregister.coltefinanciera.com.co/ClientAPI/EjecutarOrdenTransaccionTC", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));
Transacciones aprobadas
CAMPO | DESCRIPCIÓN |
---|---|
00 | Aprobada |
08 | Aprobada, solicitar más información |
11 | Aprobada, vip |
76 | Aprobada, (Privado) |
77 | Aprobada, pendiente identificación (firma del comp) |
78 | Aprobada a ciegas |
79 | Aprobada, transacción administrativa |
80 | Aprobada por boletín de seguridad |
81 | Aprobada por el establecimiento |
Transacciones declinadas
Cuando una transacción es declinada podrá identificarla con los siguientes códigos o con las siguientes descripciones
CAMPO | DESCRIPCIÓN |
---|---|
01 | Negada, comuniquese con su entidad |
02 | Negada, comuniquese con su entidad |
03 | Negada, comercio inválido |
04 | Negada, retener tarjeta |
05 | Negada, puede ser tarjeta bloqueada o timeout |
06 | Negada, no se pudo procesar la transacción |
07 | Negada, retener tarjeta |
09 | Negada, transacción duplicada |
12 | Negada, transacción inválida |
13 | Negada, monto inválido |
14 | Negada, estado de la tarjeta inválido |
15 | Negada, la institución no está en el IDF |
16 | Negada, Numero cuotas invalidas |
17 | Negada IAC inválido |
30 | Negada, error en edición de mensaje |
31 | Negada, el emisor no es soportado por el Sistema |
33 | Negada, tarjeta vencida con orden de retención |
34 | Negada, retener/capturar |
35 | Negada, retener/capturar |
36 | Negada, retener tarjeta |
37 | Negada, tarjeta bloqueada retener/capturar |
38 | Negada, tarjeta bloqueada retener/capturar |
39 | Negada, puede ser tarjeta bloqueada o timeout |
41 | Negada, estado en archivo de tarjetahabientes (CAF |
51 | Negada, no hay fondos suficientes |
54 | Negada, tarjeta vencida |
55 | Negada, PIN inválido |
56 | Negada, no se encontro CAF |
57 | Negada, transacción no permitida a esta tarjeta |
58 | Negada, transacción Inválida |
61 | Negada, excede el monto máximo |
62 | Negada, tarjeta restringida |
65 | Negada, límite de usos por período excedido |
68 | Negada, TIMEOUT |
70 | Negada, tarjeta vencida |
71 | Negada, tarjeta vencida |
71 | Negada, El tipo de cuenta no corresponde |
75 | Negada, número de intentos de PIN excedidos |
82 | Negada, no hay módulo de seguridad |
83 | Negada, no hay cuenta para la tarjeta |
84 | Negada, no existe el archivo de saldos PBF |
85 | Negada, error en actualización de archivo de saldo |
86 | Negada, tipo de autorización errado |
87 | Negada, track 2 errado |
88 | Negada, error en log de transacciones PTLF |
89 | Negada, inválida la ruta de servicio |
90 | Negada, no es posible autorizar |
91 | Negada, no es posible autorizar |
92 | Negada, puede ser tarjeta bloqueada o timeout |
93 | Negada, no es posible autorizar |
94 | Negada, transacción duplicada |
96 | Negada, no se pudo procesar la transacción |
97 | Negada, Número de documento inválido |
98 | Negada, CVV2 inválido |
N0 | Negada, no es posible autorizar |
N1 | Negada, longitud del número de la tarjeta PAN invá |
N2 | Negada, se llenó el archivo de preautorizaciones |
N3 | Negada, límite de retiros en línea excedido |
N4 | Negada, límite de retiros fuera de línea excedido |
N5 | Negada, límite de crédito por retiro excedido |
N6 | Negada, límite de retiros de crédito excedido |
N7 | Negada, customer selected negative file reason |
N8 | Negada, excede límite de piso |
N9 | Negada, maximum number of refund credit |
O0 | Negada, referral file full |
O1 | Negada, NEG file problem |
O2 | Negada, advances less than minimum |
O3 | Negada, delinquent |
O4 | Negada, over limit table |
O5 | Negada, PIN required |
O6 | Negada, mod 10 check |
O7 | Negada, force post |
O8 | Negada, bad PBF |
O9 | Negada, NEG file problem |
P0 | Negada, CAF problem |
P1 | Negada, over daily limit |
P2 | Negada, CAPF not found |
P3 | Negada, advance less than minimum |
P4 | Negada, number times used |
P5 | Negada, delinquent |
P6 | Negada, over limit table |
P7 | Negada, advance less than minimum |
P8 | Negada, administrative card needed |
P9 | Negada, enter lesser amount |
Q0 | Negada, invalid transaction date |
Q1 | Negada, Fecha de vencimiento invalida |
Q2 | Negada, invalid transaction code |
Q3 | Negada, valor del avance menor que el mínimo |
Q4 | Negada, excedido el número de usos por período |
Q5 | Negada, delinquent |
Q6 | Negada, tabla de límites excedida |
Q7 | Negada, el valor excede al máximo |
Q8 | Negada, no se encuentra la tarjeta administrativa |
Q9 | Negada, la tarjeta administrativa no está permitida |
R0 | Negada, transacción administrativa aprobada/en ven |
R1 | Negada, transacción administrativa aprobada / fuer |
R2 | Negada, transacción administrativa aprobada |
R3 | Negada, la transacción Chargeback es aprobada |
R4 | Negada, devolución/archivo de usuario actualizado |
R5 | Negada, devolución/número de prefijo incorrecto |
R6 | Negada, devolución/código de respuesta incorrecto |
R7 | Negada, transacción administrativa no soportada |
R8 | Negada, la tarjeta está en el archivo de negativos |
S4 | Negada, PTLF full |
S5 | Negada, devolución/aprobada, archivo del cliente n |
S6 | Negada, devolución aprobada, archivo del cliente n |
S7 | Negada, devolución aceptada, destino incorrecto |
S8 | Negada, ADMIN file problem |
S9 | Negada, unable to validate PIN; security module is |
T1 | Negada, tarjeta de crédito inválida |
T2 | Negada, fecha de transacción inválida |
T3 | Negada, card not supported |
T4 | Negada, amount over maximum |
T5 | Negada, CAF status = 0 or 9 |
T6 | Negada, Bad UAF |
T7 | Negada, límite diario excedido en el Cash back |
T8 | Negada, el enlace esta caido |
TO | Negada, time out |
GET Obtener Listado de Bancos
https://serviceregister.coltefinanciera.com.co/ClientAPI/GetTarjetabiente
EJEMPLO DE LA PETICIÓN
var myHeaders = new Headers();
myHeaders.append ("Authorization", );
var requestOptions = {
method: 'GET',
headers: myHeaders,
redirect: 'follow'
};
fetch("https://serviceregister.coltefinanciera.com.co/ClientAPI/ObtenerListadoBancos", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));
POST Crear Transacción PSE
https://serviceregister.coltefinanciera.com.co/ClientAPI/CrearTransaccionPSE
HEADERS
Para consumir el servicio de «crear transacción PSE» necesitaremos en el header de la petición su Api_key
PARAMETRIZACIÓN
CAMPO | TIPO | DESCRIPCION | REQUERIDO |
---|---|---|---|
additionalData | Object | Objeto con informacion adicional que se retornara en el webhook | No |
amount | integer | Valor del pago | Si |
Apellidos | string | Apellidos del pagador | Si |
Celular | string | Celular del pagador | Si |
CodigoBanco | string | Codigo del Banco, se obtienen del servicio Obtener listado bancos | Si |
Correo | string | Email del pagador | Si |
Direccion | string | Direccion del pagador | Si |
Documento | string | Identificacion del pagador | Si |
entityurl | string | Url de redireccion cuando el pago sea exitoso | Si |
external_order | string | Identificador unico del lado del comercio | Si |
form_id | integer | Id del formulario | Si |
identification_type | Integer | Tipo de identificacion del pagador | Si |
ip | string | Numero de IP del pagador | Si |
NombreBanco | string | Nombre del Banco, se obtienen del servicio Obtener listado bancos | Si |
Nombres | string | Nombres del pagador | Si |
PersonType | string | Enviar 0 para Persona Natural y 1 para Persona Juridica (En formato string) | Si |
terminal_id | integer | Id de la terminal | Si |
CUERPO DE LA PETICION
Para consumir el servicio «crear transacción PSE» en el body de la petición colocara los siguientes datos:
{
"amount" : 30000,
"PersonType" : "0",
"identification_type" : 4,
"Documento" : "",
"Correo" : "",
"Nombres" : "Ana",
"Apellidos" : "Perez",
"Celular" : 3167225855,
"Direccion" : "Calle 32 # 74 -31",
"external_order" : "26",
"CodigoBanco" : "10512",
"NombreBanco" : "BANCO DAVIVIENDA",
"entityurl" : "https://mysite.com/payment/success",
"terminal_id" : 34
"form_id" : 34
"ip" : "192.168.0.1"
"additionalData" : {
"CualquierCosa" : "CualquierCosa"
}
}
EJEMPLO DE LA PETICIÓN
var myHeaders = new Headers();
myHeaders.append ("x-api-key", "Api_key");
var cuerpo = {
"amount" : 30000,
"PersonType" : "0",
"identification_type" : 4,
"Documento" : "",
"Correo" : "",
"Nombres" : "Ana",
"Apellidos" : "Perez",
"Celular" : 3167225855,
"Direccion" : "Calle 32 # 74 -31",
"external_order" : "26",
"CodigoBanco" : "10512",
"NombreBanco" : "BANCO DAVIVIENDA",
"entityurl" : "https://mysite.com/payment/success",
"terminal_id" : 34
"form_id" : 34
"ip" : "192.168.0.1"
"additionalData" : {
"CualquierCosa" : "CualquierCosa"
}
}
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: cuerpo
redirect: 'follow'
};
fetch("https://serviceregister.coltefinanciera.com.co/ClientAPI/CrearTransaccionPSE", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));
GET Obtener Medios De Pago
https://serviceregister.coltefinanciera.com.co/ClientAPI/ObtenerMediosDePago
HEADERS
Para consumir el servicio «obtener los medios de pago» necesitaremos en el header de la petición su Api_key
EJEMPLO DE LA PETICIÓN
var myHeaders = new Headers();
myHeaders.append ("Authorization", "Api_key");
var requestOptions = {
method: 'GET',
headers: myHeaders,
redirect: 'follow'
};
fetch("https://serviceregister.coltefinanciera.com.co/ClientAPI/ObtenerMediosDePago", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));
POST Crear Transaccion Cash
https://serviceregister.coltefinanciera.com.co/ClientAPI/CrearTransaccionCash
HEADERS
Para consumir el servicio de «crear transacción PSE» necesitaremos en el header de la petición su Api_key
PARAMETRIZACIÓN
CAMPO | TIPO | DESCRIPCION | REQUERIDO |
---|---|---|---|
additionalData | Object | Objeto con informacion adicional que se retornara en el webhook | No |
amount | integer | Valor del pago | Si |
description | string | Descripción brebe de la orden | Si |
external_order | string | Identificador unico del lado del comercio | Si |
identification_type | String | Tipo de identificacion del pagador, los posibles datos son: - CC - CE - NIT - DNI | Si |
ip | string | Numero de IP del pagador | Si |
iva | integer | Iva sobre del pago (Si no aplica enviar 0) | Si |
method | string | Metodo de pago, se optiene del servcicio Obtener Medios De Pago | Si |
terminal_id | integer | Id de la terminal | Si |
CUERPO DE LA PETICION
Para consumir el servicio «crear transacción PSE» en el body de la petición colocara los siguientes datos:
{
"amount" : 30000,
"external_order" : 26,
"description" : "any description test",
"method" : "efecty",
"iva" : 0,
"user_identificatio" : "",
"identification_type" : "CC",
"user_name" : "Andres Camil",
"user_last_name" : "Perez",
"user_email" : "andres.ochoa0@gmail.com",
"user_phone" : "3227358312",
"user_address" : "cra 8b 17 15",
"terminal_id" : 34,
"form_id" : 34
"ip" : "192.168.0.1"
"additionalData" : {
"CualquierCosa" : "CualquierCosa"
}
}
EJEMPLO DE LA PETICIÓN
var myHeaders = new Headers();
myHeaders.append ("x-api-key", "Api_key");
var cuerpo = {
"amount" : 30000,
"external_order" : 26,
"description" : "any description test",
"method" : "efecty",
"iva" : 0,
"user_identificatio" : "",
"identification_type" : "CC",
"user_name" : "Andres Camil",
"user_last_name" : "Perez",
"user_email" : "andres.ochoa0@gmail.com",
"user_phone" : "3227358312",
"user_address" : "cra 8b 17 15",
"terminal_id" : 34,
"form_id" : 34
"ip" : "192.168.0.1"
"additionalData" : {
"CualquierCosa" : "CualquierCosa"
}
}
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: cuerpo
redirect: 'follow'
};
fetch("https://serviceregister.coltefinanciera.com.co/ClientAPI/CrearTransaccionCash", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));
POST WebHook
NOTA:
Recuerde que para el correcto funcionamiento el webhook debe estar ejecutandose sobre SSL , no esta permitido implementaciones sin el uso de SSL.
EL WEBHOOK de notificaciones es el entorno que permite recibir la información de la notificación de la transacción y su estado. Este es un método de llamado asincrónico de tipo REST que recibe como parámetro de entrada un JSON que contiene el estado de ejecución de la transacción. La página de notificación permite actualizar las bases de datos de tu sistema; por esto, no debe incluir código HTML ya que nunca será visible al comprador. Cuando una transacción finaliza, es decir cuando es aprobada ,rechazada, cancelada o en espera (efectivo), nuestra plataforma envía las variables por medio del método HTTP POST.
Los posibles valores de status son:
1 "Creada"
34 "Exitosa"
35 "Pendiente"
36 "Fallida"
38 "Cancelada"
39 "Reembolsada"
40 "Pendiente efectivo"
COMO RESPONDER AL WEBHOOK
Para el correcto uso del webhook tienes que enviar un status 200 únicamente cuando el estado de la transacción es exitosa (id 34) para el resto de estados debe ser respondido con un status 201
CAMPOS QUE SE ENVIAN EN EL WEBHOOK
CAMPO | TIPO | DESCRIPCION | REQUERIDO |
---|---|---|---|
additionalData | Object | Objeto con informacion adicional que se retornara en el webhook | No |

