{"info":{"_postman_id":"ddc03d6e-01dc-415d-ae9a-5b80017c306a","name":"Pagalo","description":"

Introducción

Pagalo es una pasarela de pagos para conectar metodos y procesadores en tu comercio.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Requisitos Previos
Tener una cuenta en Pagalo activa con usuario y contraseña, puedes registrarte en https://app.pagalo.co/country
Adquirir la herramienta Pasarela de pago para realizar procesamiento y la herramienta Integraciones para realizar acciones administrativas
Estar al dia de la suscripción de Pagalo para evitar bloqueos de credenciales
Cumplir con los requisitos de seguridad para realizar transacciones

Autenticación y Seguridad

Son aspectos fundamentales para garantizar la protección de la información y la integridad de las transacciones realizadas a través de la pasarela de pagos. En este sentido, es importante tener en cuenta los siguientes aspectos:

No compartir las credenciales otorgadas por el sistema
Para entregar credenciales LIVE es necesario una revisión de la pagina o sistema que utilizará la integración

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"19667181","collectionId":"ddc03d6e-01dc-415d-ae9a-5b80017c306a","publishedId":"2s93eVWZ4U","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2023-05-03T16:00:34.000Z"},"item":[{"name":"Pagalo V2","item":[{"name":"Pasarela de pago","item":[{"name":"Card","item":[{"name":"Get payment","id":"63887df1-778d-4305-8443-c0ff3dfde446","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"authorization","value":"credencial","description":"

Agregar aqui la credencial otorgada para el comercio

\n","type":"text"}],"url":"{{urlApiGateway}}/v1/getPayments","description":"

Obtener los metodos de pago, con los que se puede procesar
Se envia el authorization proporcionado, campo obligatorio
Json de ejemplo de respuesta del api

{\n    \"error\": false,\n    \"data\": [\n        {\n            \"business_uuid\": \"{{business_uuid}}\",\n            \"payment_code\": \"EPAY\",\n            \"code_currency\": \"GTQ\"\n        },\n        {\n            \"business_uuid\": \"{{business_uuid}}\",\n            \"payment_code\": \"CYBERSOURCE\",\n            \"code_currency\":  \"GTQ\"\n        }\n    ],\n    \"code\": 200\n}\n\n

\n","urlObject":{"path":["v1","getPayments"],"host":["{{urlApiGateway}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"63887df1-778d-4305-8443-c0ff3dfde446"},{"name":"Payment","id":"eff3d2e4-4d30-4b72-a1ed-6fbfecddbe99","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"authorization","value":"XplcXIEZEFQ0PjHw","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"method_payment\":\"EPAY\",\r\n \"type_detail\":\"product\",\r\n \"total_amount\": 150,\r\n \"currency\": \"GTQ\",\r\n \"deviceFinger\":\"\",\r\n \"client\": {\r\n \"first_name\":\"Bayron\",\r\n \"last_name\":\"Antonio\",\r\n \"phone\":\"5022435422\",\r\n \"email\":\"Bayron1121232123@gmail.com\",\r\n \"country\":\"GT\",\r\n \"city\":\"Guatemala\",\r\n \"state\":\"Guatemala\",\r\n \"postal_code\":\"401\",\r\n \"location\":\"zona 10\",\r\n \"ip_address\":\"192.168.10.10\"\r\n },\r\n \"detail\": [\r\n {\r\n \"uuid_product\": \"0\",\r\n \"name\": \"descri venta\",\r\n \"amount\": 150,\r\n \"quantity\": \"1\",\r\n \"Subtotal\": 150\r\n }\r\n ],\r\n \"card_payment\":{\r\n \"name_card\":\"Hector Xocop\",\r\n \"expiration_month\":\"12\",\r\n \"expiration_year\":\"22\",\r\n \"number_card\":\"4000000000000416\",\r\n \"cvv_card\":\"4567\",\r\n \"quota_active\":false,\r\n \"quota\":1\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{urlApiGateway}}/v1/payments/transactions","description":"

Api para procesar pago
Se envia el authorization proporcionado, campo obligatorio

Parametros a enviar

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Parámetro de objeto	Descripción	Tipo	Requerido
method_payment		Código del método de pago, obtenido del Api de consulta de procesamiento	String	SI
type_detail		Tipo del detalle product,services	String	SI
total_amount		Total de la transacción (Con 2 decimales 150.50)	Number	SI
currency		Código de la moneda (GTQ,USD)	String	SI
deviceFinger		Campo solo para Método Cybersource, enviar vacío de lo contrario	String	NO
client	first_name	Primer nombre	String	SI
	last_name	Primer apellido	String	SI
	phone	Teléfono	String	SI
	email	Email	String	Si
	country	Código de país (GT, MX por ejemplo) Obligatorio en CYBS	String	SI
	city	Nombre de la ciudad- Obligatorio en CYBS	String	No
	state	Nombre del estado- Obligatorio en CYBS	String	No
	postal_code	Código postal- Obligatorio en CYBS	String	No
	location	Código dirección- Obligatorio en CYBS	String	No
	ip_address	Ip del cliente	String	No
detail (objeto multiple)	uuid_product	ID único del producto interno	String	No
	name	Nombre del detalle	String	Si
	amount	Monto del detalle	Number	Si
	quantity	Cantidad	Number	Si
	subtotal	Subtotal (Monto * cantidad)	String	Si
card_payment	name_card	Nombre del tarjetahabiente	String	Si
	expiration_month	Mes de expiracion (01,10 por ejemplo, 2 digitos)	String	Si
	expiration_year	Año de expiracion(20,24 por ejemplo, 2 digitos)	String	Si
	number_card	Numero de la tarjeta (16 digitos)	String	Si
	cvv_card	Codigo de seguridad (3 o 4 digitos)	String	SI
	quota_active	Si el metodo es EPAY opcion para activar quota por default es false	String	Si
	quota	1 si es pago contado	Number	Si

Ejemplo de respuesta.

StartFragment

Transaccion Aceptada

EndFragment

{\n    \"code\": 200,\n    \"error\": false,\n    \"url_voucher\": \"https://pagalo-storage.obs.na-mexico-1.myhuaweicloud.com/business/9efcde82-e1f2-480d-98e1-fc9377ca1b2a/voucher/voucher-233408000050.pdf\",\n    \"data\": {\n        \"decision\": \"ACCEPT\",\n        \"reasonCode\": \"00\",\n        \"requestID\": \"233408000050\",\n        \"authorizationCode\": \"179059\",\n        \"uuid_transactions\": \"2f5dbddf-81c1-4095-95fc-07cb07d7bea9\"\n    }\n}\n\n

StartFragment

Transaccion Rechazada

EndFragment

{\n    \"error\": \"true\",\n    \"code\": 400,\n    \"data\": {\n        \"decision\": \"REJECT\",\n        \"reasonCode\": \"96\",\n        \"requestID\": \"000000000000\",\n        \"authorizationCode\": \"000000\",\n        \"error_code\": [\n            {\n                \"code\": \"96\",\n                \"code_payment\": \"EPAY\",\n                \"language\": \"ES\",\n                \"description\": \"Mal funcionamiento del sistema, intente mas tarde\",\n                \"message\": \"Error en sistema.\"\n            }\n        ],\n        \"uuid_transactions\": \"457a0fcf-9177-471d-80fa-0857e028c444\"\n    }\n}\n\n

StartFragment

No encuentra el metodo de pago

EndFragment

{\n    \"error\": true,\n    \"message\": \"Validar el codigo del metodo selecionado\",\n    \"code\": 400\n}\n\n

\n","urlObject":{"path":["v1","payments","transactions"],"host":["{{urlApiGateway}}"],"query":[],"variable":[]}},"response":[{"id":"57436534-fa5a-489d-bae4-f14312ec9448","name":"Payment","originalRequest":{"method":"POST","header":[{"key":"authorization","value":"XplcXIEZEFQ0PjHw","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"method_payment\":\"EPAY\",\r\n \"type_detail\":\"product\",\r\n \"total_amount\": 150,\r\n \"currency\": \"GTQ\",\r\n \"deviceFinger\":\"\",\r\n \"client\": {\r\n \"first_name\":\"Bayron\",\r\n \"last_name\":\"Antonio\",\r\n \"phone\":\"5022435422\",\r\n \"email\":\"Bayron1121232123@gmail.com\",\r\n \"country\":\"GT\",\r\n \"city\":\"Guatemala\",\r\n \"state\":\"Guatemala\",\r\n \"postal_code\":\"401\",\r\n \"location\":\"zona 10\"\r\n },\r\n \"detail\": [\r\n {\r\n \"uuid_product\": \"0\",\r\n \"name\": \"descri venta\",\r\n \"amount\": 150,\r\n \"quantity\": \"1\",\r\n \"Subtotal\": 150\r\n }\r\n ],\r\n \"card_payment\":{\r\n \"name_card\":\"Hector Xocop\",\r\n \"expiration_month\":12,\r\n \"expiration_year\":22,\r\n \"number_card\":\"4000000000000416\",\r\n \"cvv_card\":\"4567\",\r\n \"quota_active\":false,\r\n \"quota\":1\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{urlApiGateway}}/v1/payments/transactions"},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":null}],"_postman_id":"eff3d2e4-4d30-4b72-a1ed-6fbfecddbe99"},{"name":"Get payment by UUID","id":"a586dfc0-5d23-4108-bf01-34de505bcf2c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"authorization","value":"XplcXIEZEFQ0PjHw","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"transactions_uuid\":\"340d358c-808f-4794-808b-a5351593f00e\"\r\n //\"id_external\": \"5FFM8KOCDV9JTFQ504\" el campo es opcional, se puede filtrar por uuid de transaccion o por el id interno del comercio, aplica unicamente en creacion de link de pago\r\n}","options":{"raw":{"language":"json"}}},"url":"{{urlApiGateway}}/v1/payment/transaction/uuid","description":"

Solicitud de Transacción

Este endpoint permite realizar operaciones relacionadas con transacciones, como la creación de un link de pago. Solo debe enviarse uno de los dos campos: el transactions_uuid o el id_external.

Parámetros:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descripción	Obligatorio
`transactions_uuid`	String	UUID de la transacción generada. Es el identificador principal para la operación.	Condicional*
`id_external`	String	ID interno del comercio. Se usa como filtro alternativo en la creación de links de pago.	Condicional*

* Condicional: Se debe enviar uno de los dos campos. Nunca deben enviarse ambos al mismo tiempo.

Ejemplo de cuerpo de solicitud:

Filtro usando transactions_uuid:

{\n    \"transactions_uuid\": \"340d358c-808f-4794-808b-a5351593f00e01\"\n}\n\n

Filtro usando id_external (opcional):

{\n    \"id_external\": \"5FFM8KOCDV9JTFQ504\"\n}\n\n

Notas:

Solo uno de los dos parámetros (transactions_uuid o id_external) debe enviarse en la solicitud.
\n
Si se envían ambos, la solicitud será inválida.
\n
Utiliza transactions_uuid como identificador principal o id_external si prefieres identificar la transacción mediante el ID interno del comercio.
\n

Ejemplo de respuesta del api

{\n    \"error\": false,\n    \"code\": 200,\n    \"data\": {\n        \"uuid\": \"340d358c-808f-4794-808b-a5351593f00e01\",\n        \"request_id\": \"148600\",\n        \"request_auth\": \"977076\",\n        \"business_uuid\": \"dd831cb9-8e76-49db-6565-043396f57616000\",\n        \"name_operation\": \"Pruebas pagalo\",\n        \"client_name\": \"JohnTest\",\n        \"client_uuid\": \"b530c135-c26f-4a37-9600-51fc07eb2f1a-0251651\",\n        \"first_name\": \"John\",\n        \"last_name\": \"Doe Test\",\n        \"email\": \"test@example.com\",\n        \"state\": \"\",\n        \"location\": \"\",\n        \"country\": \"GT\",\n        \"city\": \"\",\n        \"ip_location\": \"181.174.102.236\",\n        \"postal_code\": \"\",\n        \"currency\": \"GTQ\",\n        \"total\": 150,\n        \"date_transaction\": \"2025-03-04 22:20:56\",\n        \"request_status\": \"ACCEPT\",\n        \"request_code\": \"00\",\n        \"status_transaction\": \"ACCEPT\",\n        \"type_payment\": \"CARDCREDIT\",\n        \"payment\": \"PAGALO\",\n        \"identifier_payment\": \"PAGALO\",\n        \"status_production\": \"live\",\n        \"module\": \"PP\",\n        \"value_payment\": \"0416\",\n        \"branch_uuid\": \"e23e7aac-bfe0-4bb2-654651-b48e8b4b1429\",\n        \"transaction_details\": [\n            {\n                \"transaction_uuid\": \"596ace03-aa18-4868-83a5-e6454791ca7a\",\n                \"type_detail\": \"services\",\n                \"product_uuid\": \"0\",\n                \"description\": \"Pago Único\",\n                \"quantity\": 1,\n                \"amount\": 150,\n                \"subtotal\": 150,\n                \"observations\": null\n            }\n        ]\n    }\n}\n\n

\n","urlObject":{"path":["v1","payment","transaction","uuid"],"host":["{{urlApiGateway}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"a586dfc0-5d23-4108-bf01-34de505bcf2c"},{"name":"Reverse payment","id":"fd4051b7-0a58-44d0-9c1c-356529624dc7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"authorization","value":"XplcXIEZEFQ0PjHw","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"transactions_uuid\":\"dd1e9d2a-5fd0-4465-9f45-3301978bf4d6\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{urlApiGateway}}/v1/payment/transaction/reverse","description":"

Api para anular una transaccion.

StartFragment

Una de las condiciones importantes que esta función solo aplica cuando la transacción no esta en proceso de liquidación, normalmente en el día de transacción se puede realizar

EndFragment

Ejemplo de espuesta.

StartFragment

Anulación aceptada

EndFragment

{\n    \"error\": false,\n    \"message\":\"Anulación realizada correctamente\"\n    \"code\": 200\n}\n\n

StartFragment

Anulación rechazada

EndFragment

{\n    \"error\": true,\n    \"message\":\"No se logro realizar la anulación, asegurar que la transacción no este en proceso de liquidación, normalmente las anulaciones son el mismo dia de transacción\"\n    \"code\": 400\n}\n\n

\n","urlObject":{"path":["v1","payment","transaction","reverse"],"host":["{{urlApiGateway}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"fd4051b7-0a58-44d0-9c1c-356529624dc7"}],"id":"326d7026-7ffe-40b7-9b0c-4ba1e2169d18","_postman_id":"326d7026-7ffe-40b7-9b0c-4ba1e2169d18","description":""},{"name":"Request","item":[{"name":"Create request","id":"db686cf6-1f7d-4947-a034-4ea1fc2351a7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"authorization","value":"tu credencial","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"uuid_branch\": \"99418543-b022-45c8-8ea3-ba999349fddd\", //opcional\r\n \"description\": \"monto fijo\",\r\n \"total_amount\": 925,\r\n \"type_request\": \"SP\",\r\n \"currency\": \"GTQ\",\r\n \"n_quotas\": false,\r\n \"expiration\": true,\r\n \"external_identifier\":\"5FFM8KOCDV9JTFQ503\",// campo opcional, interno del comercio\r\n \"client\": {\r\n \"first_name\": \"Bayron\",\r\n \"last_name\": \"Antonio\",\r\n \"phone\": \"5022435422\",\r\n \"email\": \"Bayron112123212s3@gmail.com\",\r\n \"country\": \"GT\",\r\n \"city\": \"Guatemala\",\r\n \"state\": \"Guatemala\",\r\n \"postal_code\": \"401\",\r\n \"location\": \"zona 10\"\r\n },\r\n \"products\": [\r\n {\r\n \"product_uuid\": 0,\r\n \"amount\": 125,\r\n \"quantity\": 1,\r\n \"subtotal\": 125,\r\n \"name\": \"monto fijo\",\r\n \"product_name\": \"monto fijosss\"\r\n },\r\n {\r\n \"product_uuid\": \"8f2bb4fd-f019-41fd-a355-4311a50699f8\",\r\n \"amount\": 800,\r\n \"quantity\": 1,\r\n \"subtotal\": 800,\r\n \"name\": \"teclados corsair\",\r\n \"product_name\": \"teclados corsair\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"{{urlApiGateway}}/v1/payment/request","description":"

Api para crear link de pago

Parametros a enviar

Parámetro	Parámetro de objeto	Descripción	Tipo	Requerido
description		Descripcion del link de pago	String	SI
uuid_branch		Identificador de la sucursal para asignar el pago	String	No
total_amount		Total de la transacción (Con 2 decimales 150.50)	Number	SI
type_request		Codigo del tipo de link (QR o SP)	String	SI
currency		Código de la moneda (GTQ,USD)	String	SI
n_quotas		Si el metodo de pago, acepta metodos de pago true, si no acepta false	String	SI
expiration		true o false, si el link expira o no expira	String	SI
external_identifier		Id unico interno del comercio	String	No
callback_reject		Url de respuesta si la transaccion es rechazada	String	No
callback_accept		Url de respuesta si la transaccion es aceptada	String	No
client	first_name	Nombres del cliente	String	Si
	last_name	Apellidos del cliente	String	Si
	phone	Telefono del cliente	String	Si
	email	Correo del cliente	String	Si
	country	Codigo del pais	String	Si
	city	Nombre de la ciudad	String	No
	state	Nombre del estado	String	No
	postal_code	Código postal	String	No
	location	Código dirección	String	No
products	product_uuid	Codigo interno del producto	String	No
	amount	Monto o precio del producto	String	SI
	quantity	Cantidad del producto	Number	Si
	subtotal	amount * quantity	String	SI
	name	Nombre del producto	String	SI
	product_name	Nombre del producto o descripcion del monto variable	String	SI

Json de ejemplo, esenario a considerar.

CREAR LINK PARA QUE EL CLIENTE INGRESE EL MONTO Y SU INFORMACIÓN

{\n    \"uuid_branch\": \"99418543-b022-45c8-8ea3-ba999349fddd\", //opcional\n    \"description\": \"Link de pago\",\n    \"total_amount\": 0,\n    \"type_request\": \"SP\",\n    \"currency\": \"GTQ\",\n    \"n_quotas\": false,\n    \"expiration\": false,\n    \"callback_reject\":\"\",\n    \"callback_accept\":\"\",\n    \"external_identifier\":\"5FFM8KOCDV9JTFQ503\",// campo opcional, interno del comercio\n    \"client\":{},\n    \"products\": []\n}\n\n

CREAR LINK CON MONTO FIJO Y EL CLIENTE SOLO LLENA SU INFORMACIÓN

{\n    \"uuid_branch\": \"99418543-b022-45c8-8ea3-ba999349fddd\", //opcional\n    \"description\": \"Entradas Torneo Fut\",\n    \"total_amount\": 100,\n    \"type_request\": \"SP\",\n    \"currency\": \"GTQ\",\n    \"n_quotas\": false,\n    \"expiration\": false,\n    \"callback_reject\":\"\",\n    \"callback_accept\":\"\",\n    \"external_identifier\":\"5FFM8KOCDV9JTFQ503\",// campo opcional, interno del comercio\n    \"client\":{},\n    \"products\": [\n        {\n            \"product_uuid\": 0,\n            \"amount\": 100,\n            \"quantity\": 1,\n            \"subtotal\": 100,\n            \"name\": \"Entradas Torneo Fut\"\n        }\n    ]\n}\n\n

CREAR LINK CON INFORMACIÓN DEL CLIENTE Y PRODUCTO CON MONTO FIJO (EL CLIENTE YA SOLO INGRESA SU TARJETA)

{\n    \"uuid_branch\": \"99418543-b022-45c8-8ea3-ba999349fddd\", //opcional\n    \"description\": \"Pago de Alquiler\",\n    \"total_amount\": 1000,\n    \"type_request\": \"SP\",\n    \"currency\": \"GTQ\",\n    \"n_quotas\": false,\n    \"expiration\": true,\n    \"external_identifier\":\"5FFM8KOCDV9JTFQ503\",// campo opcional, interno del comercio\n    \"callback_reject\":\"\",\n    \"callback_accept\":\"\",\n    \"client\": {\n            \"first_name\":\"Bayron\",\n            \"last_name\":\"Antonio\",\n            \"phone\":\"5022435422\",\n            \"email\":\"Bayron1121232123@gmail.com\",\n            \"country\":\"GT\",\n            \"city\":\"Guatemala\",\n            \"state\":\"Guatemala\",\n            \"postal_code\":\"401\",\n            \"location\":\"zona 10\"\n    },\n    \"products\": [\n        {\n            \"product_uuid\": 0,\n            \"amount\": 1000,\n            \"quantity\": 1,\n            \"subtotal\": 1000,\n            \"name\": \"Pago de Alquiler\"\n        }\n    ]\n}\n\n

\n","urlObject":{"path":["v1","payment","request"],"host":["{{urlApiGateway}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"db686cf6-1f7d-4947-a034-4ea1fc2351a7"},{"name":"get request by uuid","id":"cdba5eeb-a9e1-4d92-aa09-1b24ccae6754","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"authorization","value":"tu credencial","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"uuid\": \"3747bfd2-b5d8-4bdb-ae82-99cb076766f9\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{urlApiGateway}}/v1/payment/request/uuid","description":"

Api para obtener informacion de un link de pago de creado.

Status de un link de pago.

Estado 1 = Link creado y aun no ha sido usado
Estado 2 = Link ya ha sido pagado
Estado 3 = Link ha sido cancelado
Estado 4 = Link ha expirado

Posibles respuestas del api.

Si no se envia el parametro uuid.

{\n   \"message\": {\n      \"uuid\": [\n         \"The uuid field is required.\"\n      ]\n   },\n   \"code\": 400,\n   \"error\": true\n}\n\n

Si el header authorization no se envia.

{\n   \"error\": true,\n   \"message\": \"El token no es valido\",\n   \"code\": 400\n}\n\n

Si no se encuentra el registro uuid

{\n   \"error\": true,\n   \"message\": \"No se encontro el registro\",\n   \"code\": 400\n}\n\n

Si el registro si es encontrado.

{\n   \"error\": false,\n   \"code\": 200,\n   \"message\": {\n      \"id\": 380,\n      \"uuid\": \"3747bfd2-b5d8-4bdb-ae82-99cb076766f9\",\n      \"uuid_short\": \"w0N1Pg8uzM\",\n      \"business_uuid\": \"dd831cb9-8e76-49db-bede-043396f57616\",\n      \"branch_uuid\": \"e23e7aac-bfe0-4bb2-adad-b48e8b4b1429\",\n      \"currency\": \"GTQ\",\n      \"country\": \"GT\",\n      \"client_uuid\": null,\n      \"description\": \"monto fijo\",\n      \"amount\": \"925\",\n      \"type_request\": \"SP\",\n      \"n_quotas\": 0,\n      \"expiration\": 0,\n      \"date_request\": \"2023-05-03 09:44:22\",\n      \"datetz_request\": \"2023-05-03 09:44:22\",\n      \"date_expiration\": \"2023-05-05 09:44:22\",\n      \"datetz_expiration\": \"2023-05-05 09:44:22\",\n      \"status\": \"1\",\n      \"descrition_type_request\": \"null\",\n      \"user_uuid\": \"14281ac4-7768-43dd-ade8-15b339152364\",\n      \"description_reject\": null,\n      \"product\": [\n         {\n            \"request_uuid\": \"3747bfd2-b5d8-4bdb-ae82-99cb076766f9\",\n            \"uuid\": null,\n            \"name\": null,\n            \"description\": null,\n            \"url_image\": null,\n            \"quantity\": \"1\",\n            \"amount\": \"125\",\n            \"subtotal\": \"125\",\n            \"description_product\": \"monto fijosss\"\n         },\n         {\n            \"request_uuid\": \"3747bfd2-b5d8-4bdb-ae82-99cb076766f9\",\n            \"uuid\": \"8f2bb4fd-f019-41fd-a355-4311a50699f8\",\n            \"name\": \"teclados corsair\",\n            \"description\": \"un teclado pox\",\n            \"url_image\": null,\n            \"quantity\": \"1\",\n            \"amount\": \"800\",\n            \"subtotal\": \"800\",\n            \"description_product\": \"teclados corsair\"\n         }\n      ]\n   }\n}\n\n

\n","urlObject":{"path":["v1","payment","request","uuid"],"host":["{{urlApiGateway}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"cdba5eeb-a9e1-4d92-aa09-1b24ccae6754"},{"name":"Obtener Sucursales","id":"a44c3c9a-5170-4ba8-be52-3ebf2e996527","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"authorization","value":"tu credencial","type":"text"}],"url":"{{urlApiGateway}}/v1/getSucursal","description":"

Descripción General

Esta API permite obtener información sobre las sucursales asociadas a un business_uuid. El endpoint retorna una lista de sucursales con sus detalles respectivos, como el nombre, ubicación, código de licencia, entre otros.

\n","urlObject":{"path":["v1","getSucursal"],"host":["{{urlApiGateway}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"a44c3c9a-5170-4ba8-be52-3ebf2e996527"}],"id":"36694180-8c54-43e5-a140-176a1a553562","_postman_id":"36694180-8c54-43e5-a140-176a1a553562","description":""}],"id":"5d93cd62-5e3b-452b-b8a1-f597fb127817","description":"

El requisito es tener activa la herramienta Pasarela de Pago en el comercio.

Los metodos de pago que se podrán utilizar son

\n\n\n\n\n\n\n\n\n\n\n\n\n

Metodo de pago	Identificador
Tarjeta de crédito/débito	Card

Para autenticar una integración y realizar las acciones en la pasarela de pago se necesita una credencial que se puede generar en el area de Ajustes->Credenciales

Al usuario le permitira generar una credencial TEST, para iniciar con la integración con el dominio apitest.pagalo.co

La credencial se coloca en el header con el parametro

\n\n\n\n\n\n\n\n\n\n\n

Parametro Header
authorization

Ejemplo

--header 'authorization: XplcXIEZEFQ0PjHw'\n\n

\n","_postman_id":"5d93cd62-5e3b-452b-b8a1-f597fb127817"},{"name":"Integrations","item":[{"name":"Transactions","item":[{"name":"Listado de transacciones","id":"314ae1f7-b251-4f3b-b6ff-0d626c68c9fc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"business_uuid\": \"{{business_uuid}}\",\r\n \"branch\": \"\",\r\n \"page\": 1,\r\n \"total_items\": 15,\r\n \"all\": \"\",\r\n \"date_start\": \"\",\r\n \"date_end\": \"\",\r\n \"status_transaction\": \"ACCEPT\", // ACCEPT, REJECT\r\n \"currency\": \"GTQ\",\r\n \"filter_column\": {\r\n \"column\": \"id\", // identificador cliente , nombre cliente,correo, identificador de cuenta, fecha factura\r\n \"value\": \"DESC\" // ASC or DESC\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{urlApiGateway}}/v1/integration/transactions","description":"

Método de Solicitud: POST

Autenticación

Para utilizar esta API, el cliente debe iniciar sesión primero y obtener un Bearer Token para la autenticación. Este token es necesario para todas las solicitudes posteriores a la API.

Endpoint: {{urlApiGateway}}/v1/integration/transactions

Cuerpo de la Solicitud:

El cuerpo de la solicitud debe ser un objeto JSON con los siguientes campos:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descripción
`business_uuid`	String	(Requerido) Identificador único del negocio.
`branch`	String	Identificador de la sucursal. Dejar vacío para apuntar a todas las sucursales.
`page`	Integer	(Requerido) Número de página de la paginación.
`total_items`	Integer	(Requerido) Número total de elementos a recuperar por página.
`all`	String	Filtro opcional de búsqueda. Ejemplo: Nombre de un vendedor.
`date_start`	String	Fecha de inicio para filtrar las transacciones. Formato: `YYYY-MM-DD`.
`date_end`	String	Fecha de finalización para filtrar las transacciones. Formato: `YYYY-MM-DD`.
`status_transaction`	String	Estado de la transacción. Valores posibles: `ACCEPT`, `REJECT`.
`currency`	String	Código de moneda (formato ISO 4217). Ejemplo: `GTQ`.
`filter_column`	Objeto	(Opcional) Criterio de filtrado para ordenar los datos.
- `column`	String	Columna para filtrar. Valores posibles: `id`, `client_name`, `email`, `account_identifier`, `invoice_date`, etc.
- `value`	String	Orden de clasificación. Valores posibles: `ASC`, `DESC`.

Ejemplo de Cuerpo de la Solicitud:

{\n    \"business_uuid\": \"dd831cb9-8e76-49db-bede-043396f57616\",\n    \"branch\": \"\",\n    \"page\": 1,\n    \"total_items\": 15,\n    \"all\": \"Hector\",\n    \"date_start\": \"\",\n    \"date_end\": \"\",\n    \"status_transaction\": \"ACCEPT\",\n    \"currency\": \"GTQ\",\n    \"filter_column\": {\n        \"column\": \"id\",\n        \"value\": \"DESC\"\n    }\n}\n\n

Respuesta:

Respuesta Exitosa:

Al ejecutarse correctamente, la API devolverá una respuesta detallada que contiene los datos de las transacciones, junto con totales agregados e información de paginación.

Ejemplo de Cuerpo de la Respuesta:

{\n    \"error\": false,\n    \"total\": {\n        \"total_transactions\": 596,\n        \"total_amount\": 2589.32,\n        \"total_state\": {\n            \"accept\": 2589.32,\n            \"reject\": 0\n        }\n    },\n    \"data\": [\n        {\n            \"id\": 2265,\n            \"client_uuid\": \"XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXX\",\n            \"uuid\": \"XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXX\",\n            \"vendedor\": \"Hector\",\n            \"type_payment\": \"CARDCREDIT\",\n            \"request_id\": \"XXXXXXXXXXXXX\",\n            \"request_auth\": \"XXXXXX\",\n            \"client_name\": \"PREUSS STERKEL HANS\",\n            \"code_module\": \"CC\",\n            \"name_module\": \"Cuentas por cobrar\",\n            \"value_payment\": \"0002\",\n            \"type_brand\": \"visa\",\n            \"total\": 1294.66,\n            \"currency\": \"GTQ\",\n            \"datetz_transactions\": \"2024-09-04 17:26:40\",\n            \"status_transaction\": \"ACCEPT\",\n            \"voucher\": \"url.pdf\",\n            \"voucher_reverse\": null,\n            \"description_module\": \"{\\\"total\\\": 1294.66, \\\"cuotas\\\": 10, \\\"monto_cuotas\\\": 129.466}\",\n            \"invoice\": {\n                \"uuid\": \"XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXX\",\n                \"transaction_uuid\": \"XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXX\", \n                \"status\": 1,\n                \"url\": \"url\",\n                \"series\": \"**PRUEBAS**\",\n                \"number\": \"44444\",\n                \"error\": 0,\n                \"description\": null,\n                \"reverse\": null\n            },\n            \"liquidations\": {\n                \"uuid\": \"XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXX\",\n                \"transaction_uuid\": \"XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXX\",\n                \"status\": \"PENDING\",\n                \"amount\": 1294.66,\n                \"currency\": \"GTQ\",\n                \"total_liquidation\": 1158.96,\n                \"date_request\": \"2024-09-09 15:47:27\",\n                \"date_liquidation\": \"0000-00-00 00:00:00\",\n                \"request_id_liquidation\": \"XXXXXXXXX\",\n                \"code_auth_liquidation\": \"\"\n            }\n        }\n    ],\n    \"pagination\": {\n        \"total_items\": 596,\n        \"limit_page\": 2,\n        \"total_pages\": 298\n    },\n    \"code\": 200\n}\n\n

\n","urlObject":{"path":["v1","integration","transactions"],"host":["{{urlApiGateway}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"314ae1f7-b251-4f3b-b6ff-0d626c68c9fc"}],"id":"9e8dbd89-a40b-4ca6-b8c9-a627f75e02bc","_postman_id":"9e8dbd89-a40b-4ca6-b8c9-a627f75e02bc","description":""},{"name":"Login","id":"0df66857-c968-4456-ae85-f08d7a235e0e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n\t\"email\": \"email\",\r\n\t\"password\": \"pass\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{urlApiGateway}}/v1/login","description":"\n

URL Base: {{urlApiGateway}}/v1/login

Descripción

Esta API permite a los usuarios autenticarse en el sistema proporcionando sus credenciales (correo electrónico y contraseña). Al iniciar sesión con éxito, la API devolverá un Bearer Token que se debe utilizar para autenticar solicitudes a otras APIs. El token debe incluirse en el encabezado de autorización de todas las peticiones posteriores.

Método de Solicitud: POST

Cuerpo de la Solicitud:

El cuerpo de la solicitud debe contener las credenciales del usuario en el siguiente formato:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descripción
`email`	String	(Requerido) Correo electrónico del usuario registrado.
`password`	String	(Requerido) Contraseña del usuario.

Ejemplo de Cuerpo de la Solicitud:

{\n    \"email\": \"email\",\n    \"password\": \"password\"\n}\n\n

Respuesta:

Respuesta Exitosa:

Al iniciar sesión correctamente, se devolverá una respuesta JSON que contiene un Bearer Token y detalles del negocio asociado. Este token se deberá utilizar para autenticar todas las solicitudes a otras APIs, incluyendo el encabezado de la siguiente manera:

Ejemplo de Respuesta Exitosa:

{\n    \"error\": false,\n    \"code\": 200,\n    \"token\": \"token\",\n    \"business\": {\n        \"business_uuid\": \"xxxxxx-xxxxx-xxxx-xxxx-xxxxxxxx\",\n        \"name\": \"nombre\"\n    }\n}\n\n

Campos de la Respuesta:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descripción
`error`	Boolean	Indica si hubo algún error en la solicitud.
`code`	Integer	Código de estado HTTP. En caso de éxito, será `200`.
`token`	String	El Bearer Token que se debe usar en el encabezado de autorización para otras APIs.
`business`	Object	Información sobre el negocio asociado al usuario autenticado.
- `business_uuid`	String	Identificador único del negocio.
- `name`	String	Nombre del negocio asociado.

Notas Importantes:

El Bearer Token devuelto tiene un tiempo de expiración y debe ser renovado tras su vencimiento.
\n
El token debe ser enviado en todas las solicitudes posteriores utilizando el siguiente formato en el encabezado:
\n

\n","urlObject":{"path":["v1","login"],"host":["{{urlApiGateway}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"0df66857-c968-4456-ae85-f08d7a235e0e"}],"id":"592bb7d7-4f83-44a9-a241-9f47a54028f5","_postman_id":"592bb7d7-4f83-44a9-a241-9f47a54028f5","description":""}],"id":"76ce9259-c1da-4491-896d-c71d17ea52df","description":"

Para iniciar a conectar con Pagalo 2.0 con el dominio pagalo.co, tener en cuenta lo siguiente

Todas las pruebas de integraciones utilizar el subdominio

\n
apitest.pagalo.co/v1
\n

Al realizar integraciones exitosas, y cumplir con requisitos de seguridad, el subdominio para producción es

\n
api.pagalo.co/v1
\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Requisitos de seguridad
Poseer Software de Comercio Electrónico
Su sitio web debe de tener un certificado de seguridad SSL
Deben de utilizar el Algoritmo Luhn
Deben de verifica si la fecha de expiración de la tarjeta es válida
Verificar en el reporte de transacciones si todo la información que envia esta correcto
No guarda ningún dato sensible de la tarjeta (CVV, fecha de expiración)
Deben de cumplir con las 10 de reglas de OWASP

","_postman_id":"76ce9259-c1da-4491-896d-c71d17ea52df"},{"name":"Pagalo V1","item":[{"name":"Payments","item":[{"name":"Credit Card","item":[{"name":"Payment Cybersource","id":"8363a013-c7fa-48ed-968d-582dd388ee81","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"empresa\": \"{\\\"key_secret\\\":\\\"secret\\\",\\\"key_public\\\":\\\"public\\\",\\\"idenEmpresa\\\":\\\"empresa\\\"}\",\r\n \r\n \"cliente\": \"{\\\"nit\\\":\\\"55205801\\\",\\\"codigo\\\":\\\"3\\\",\\\"firstName\\\":\\\"Pagalo\\\",\\\"lastName\\\":\\\"CON\\\",\\\"street1\\\":\\\"12 Avenida Zona 15\\\",\\\"country\\\":\\\"GT\\\",\\\"city\\\":\\\"Guatemala\\\",\\\"state\\\":\\\"GT\\\",\\\"postalCode\\\":\\\"04001\\\",\\\"email\\\":\\\"pagalotest2@gmail.com\\\",\\\"ipAddress\\\":\\\"190.104.119.240\\\",\\\"phone\\\":\\\"40404040\\\",\\\"Total\\\":1.5,\\\"deviceFingerprintID\\\":\\\"\\\",\\\"currency\\\":\\\"GTQ\\\",\\\"fecha_transaccion\\\":\\\"2021-05-13 14:37:13\\\"}\",\r\n \r\n \"detalle\": \"[{\\\"nombre\\\":\\\"Servicio Virtual\\\",\\\"precio\\\":1.5,\\\"cantidad\\\":1,\\\"tipo\\\":\\\"producto\\\",\\\"id_producto\\\":\\\"777\\\",\\\"Subtotal\\\":1.5}]\",\r\n \r\n \"tarjetaPagalo\": \"{\\\"nameCard\\\":\\\"Pagalo Test\\\",\\\"accountNumber\\\":\\\"4000000000000416\\\",\\\"expirationMonth\\\":\\\"12\\\",\\\"expirationYear\\\":\\\"2021\\\",\\\"CVVCard\\\":\\\"123\\\"}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://app.pagalocard.com/api/v1/integracion/{token}","description":"

Empresa Parameter

The company parameter must include the credentials so that the system can identify which business is making the transaction, the fields that form the parameter are:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Fields	Description	Type	Required
key_secret	Company's Secret Key	Text	Yes
key_public	Company's public key	Text	Yes
idenEmpresa	Company Identity	Text	Yes

Cliente Parameter

The customer parameter must include the necessary information of the customer so that the system can have record of the person who made the transaction, the fields that form the parameter are:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Fields	Description	Type	Required
firstName	Customer Name	Text	Yes
lastName	Customer's last name	Text	Yes
street1	Customer's address	Text	Yes
country	Country code according to ISO 3166-1	Text	Yes
city	City or department of the country	Text	Yes
state	State or Municipality of the city (For countries such as the United States and Canada the name of the State must be abbreviated)	Text	Yes
postalCode	Zip Code	Text	Yes
email	Customer's e-mail address	Text	Yes
currency	Currency code according to country by ISO 4217	Text	Yes
ipAddress	Customer IP	Text	Yes
phone	Customer's phone number	Text	Yes
Total	Total sales	Text	Yes
fecha_transaccion	Date of the transaction the format should be entered as follows: YYYYY-MM-DD HH:MM:SS, please do not send a date type object as the system returns a 500 error.	Text	Yes
deviceFingerprintID	Fingerprint requested by the CyberSource security filter	Text	NO

Producto Parameter

The product parameter must include the information of the items that the customer is buying so that the system can register it in the transaction, the fields that form the parameter are:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Description	Type	Required
id_producto	SKU or unique ID to identify the product, this identifier is specific to the retailer so you can keep track of your inventory on your website	Text	Yes
nombre	Product name	Text	Yes
precio	Product price	Text	Yes
cantidad	Product Quantity	Number	Yes
tipo	Type of Product (product or service)	Text	Yes
subtotal	Price x quantity of product	Text	Yes

The parameter tarjetaPagalo is necessary to include the information of the customer's card so that the system can make the charge and register it in the transaction, the fields that form the parameter are:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Fields	Description	Type	Required
nameCard	Name of the cardholder	Text	Yes
accountNumber	Card number	Text	Yes
expirationMonth	Month of expiration date (2 digits)	Text	Yes
expirationYear	Year of expiration date (4 digits)	Text	Yes
CVVcard	Security CVV or card security code (3 to 4 digits) digitos)	Text	Yes

","urlObject":{"protocol":"https","path":["api","v1","integracion","{token}"],"host":["app","pagalocard","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"8363a013-c7fa-48ed-968d-582dd388ee81"},{"name":"Payment Epay","id":"b72b632c-bb70-408f-9bb4-471b34e3479a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"empresa\": \"{\\\"key_secret\\\":\\\"secret\\\",\\\"key_public\\\":\\\"public\\\",\\\"idenEmpresa\\\":\\\"empresa\\\"}\",\r\n \r\n \"cliente\": \"{\\\"nit\\\":\\\"55205801\\\",\\\"codigo\\\":\\\"3\\\",\\\"firstName\\\":\\\"Pagalo\\\",\\\"lastName\\\":\\\"CON\\\",\\\"street1\\\":\\\"12 Avenida Zona 15\\\",\\\"country\\\":\\\"GT\\\",\\\"city\\\":\\\"Guatemala\\\",\\\"state\\\":\\\"GT\\\",\\\"postalCode\\\":\\\"04001\\\",\\\"email\\\":\\\"pagalotest2@gmail.com\\\",\\\"ipAddress\\\":\\\"190.104.119.240\\\",\\\"phone\\\":\\\"40404040\\\",\\\"Total\\\":1.5,\\\"deviceFingerprintID\\\":\\\"\\\",\\\"currency\\\":\\\"GTQ\\\",\\\"fecha_transaccion\\\":\\\"2021-05-13 14:37:13\\\"}\",\r\n \r\n \"detalle\": \"[{\\\"nombre\\\":\\\"Servicio Virtual\\\",\\\"precio\\\":1.5,\\\"cantidad\\\":1,\\\"tipo\\\":\\\"producto\\\",\\\"id_producto\\\":\\\"777\\\",\\\"Subtotal\\\":1.5}]\",\r\n \r\n \"tarjetaPagalo\": \"{\\\"nameCard\\\":\\\"Pagalo Test\\\",\\\"accountNumber\\\":\\\"4000000000000416\\\",\\\"expirationMonth\\\":\\\"12\\\",\\\"expirationYear\\\":\\\"2021\\\",\\\"CVVCard\\\":123}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://app.pagalocard.com/api/v1/integracionpg/{token}","description":"

Empresa Parameter

The company parameter must include the credentials so that the system can identify which business is making the transaction, the fields that form the parameter are:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Fields	Description	Type	Required
key_secret	Company's Secret Key	Text	Yes
key_public	Company's public key	Text	Yes
idenEmpresa	Company Identity	Text	Yes

Cliente Parameter

The customer parameter must include the necessary information of the customer so that the system can have record of the person who made the transaction, the fields that form the parameter are:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Fields	Description	Type	Required
firstName	Customer Name	Text	Yes
lastName	Customer's last name	Text	Yes
street1	Customer's address	Text	Yes
country	Country code according to ISO 3166-1	Text	Yes
city	City or department of the country	Text	Yes
state	State or Municipality of the city (For countries such as the United States and Canada the name of the State must be abbreviated)	Text	Yes
postalCode	Zip Code	Text	Yes
email	Customer's e-mail address	Text	Yes
currency	Currency code according to country by ISO 4217	Text	Yes
ipAddress	Customer IP	Text	Yes
phone	Customer's phone number	Text	Yes
Total	Total sales	Number float	Yes
fecha_transaccion	Date of the transaction the format should be entered as follows: YYYYY-MM-DD HH:MM:SS, please do not send a date type object as the system returns a 500 error.	Text	Yes

Producto Parameter

The product parameter must include the information of the items that the customer is buying so that the system can register it in the transaction, the fields that form the parameter are:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Description	Type	Required
id_producto	SKU or unique ID to identify the product, this identifier is specific to the retailer so you can keep track of your inventory on your website	Text	Yes
nombre	Product name	Text	Yes
precio	Product price	Text	Yes
cantidad	Product Quantity	Number	Yes
tipo	Type of Product (product or service)	Text	Yes
Subtotal	Price x quantity of product	Number float	Yes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Fields	Description	Type	Required
nameCard	Name of the cardholder	Text	Yes
accountNumber	Card number	Text	Yes
expirationMonth	Month of expiration date (2 digits)	Text	Yes
expirationYear	Year of expiration date (4 digits)	Text	Yes
CVVcard	Security CVV or card security code (3 to 4 digits) digitos)	Text	Yes

","urlObject":{"protocol":"https","path":["api","v1","integracionpg","{token}"],"host":["app","pagalocard","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"b72b632c-bb70-408f-9bb4-471b34e3479a"},{"name":"Payment Epay Quota","id":"6d4d5d08-7441-4a70-8fae-3936380c4da8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"empresa\": \"{\\\"key_secret\\\":\\\"secret\\\",\\\"key_public\\\":\\\"public\\\",\\\"idenEmpresa\\\":\\\"idempresa\\\"}\",\r\n \r\n \"cliente\": \"{\\\"nit\\\":\\\"55205801\\\",\\\"codigo\\\":\\\"3\\\",\\\"firstName\\\":\\\"Pagalo\\\",\\\"lastName\\\":\\\"CON\\\",\\\"street1\\\":\\\"12 Avenida Zona 15\\\",\\\"country\\\":\\\"GT\\\",\\\"city\\\":\\\"Guatemala\\\",\\\"state\\\":\\\"GT\\\",\\\"postalCode\\\":\\\"04001\\\",\\\"email\\\":\\\"pagalotest2@gmail.com\\\",\\\"ipAddress\\\":\\\"190.104.119.240\\\",\\\"phone\\\":\\\"40404040\\\",\\\"Total\\\":1.5,\\\"deviceFingerprintID\\\":\\\"\\\",\\\"currency\\\":\\\"GTQ\\\",\\\"fecha_transaccion\\\":\\\"2021-05-13 14:37:13\\\"}\",\r\n \r\n \"detalle\": \"[{\\\"nombre\\\":\\\"Servicio Virtual\\\",\\\"precio\\\":1.5,\\\"cantidad\\\":1,\\\"tipo\\\":\\\"producto\\\",\\\"id_producto\\\":\\\"777\\\",\\\"Subtotal\\\":1.5}]\",\r\n \r\n \"tarjetaPagalo\": \"{\\\"nCuotas\\\":\\\"3\\\",\\\"nameCard\\\":\\\"Pagalo Test\\\",\\\"accountNumber\\\":\\\"4000000000000416\\\",\\\"expirationMonth\\\":\\\"12\\\",\\\"expirationYear\\\":\\\"2021\\\",\\\"CVVCard\\\":\\\"123\\\"}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://app.pagalocard.com/api/v1/integracionpg/{token}","description":"

Empresa Parameter

The company parameter must include the credentials so that the system can identify which business is making the transaction, the fields that form the parameter are:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Fields	Description	Type	Required
key_secret	Company's Secret Key	Text	Yes
key_public	Company's public key	Text	Yes
idenEmpresa	Company Identity	Text	Yes

Cliente Parameter

The customer parameter must include the necessary information of the customer so that the system can have record of the person who made the transaction, the fields that form the parameter are:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Fields	Description	Type	Required
firstName	Customer Name	Text	Yes
lastName	Customer's last name	Text	Yes
street1	Customer's address	Text	Yes
country	Country code according to ISO 3166-1	Text	Yes
city	City or department of the country	Text	Yes
state	State or Municipality of the city (For countries such as the United States and Canada the name of the State must be abbreviated)	Text	Yes
postalCode	Zip Code	Text	Yes
email	Customer's e-mail address	Text	Yes
currency	Currency code according to country by ISO 4217	Text	Yes
ipAddress	Customer IP	Text	Yes
phone	Customer's phone number	Text	Yes
Total	Total sales	Number float	Yes
fecha_transaccion	Date of the transaction the format should be entered as follows: YYYYY-MM-DD HH:MM:SS, please do not send a date type object as the system returns a 500 error.	Text	Yes

Producto Parameter

The product parameter must include the information of the items that the customer is buying so that the system can register it in the transaction, the fields that form the parameter are:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Description	Type	Required
id_producto	SKU or unique ID to identify the product, this identifier is specific to the retailer so you can keep track of your inventory on your website	Text	Yes
nombre	Product name	Text	Yes
precio	Product price	Text	Yes
cantidad	Product Quantity	Number	Yes
tipo	Type of Product (product or service)	Text	Yes
Subtotal	Price x quantity of product	Number float	Yes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Fields	Description	Type	Required
nameCard	Name of the cardholder	Text	Yes
accountNumber	Card number	Text	Yes
expirationMonth	Month of expiration date (2 digits)	Text	Yes
expirationYear	Year of expiration date (4 digits)	Text	Yes
CVVcard	Security CVV or card security code (3 to 4 digits) digitos)	Text	Yes
nCuotas	Adding the parameter detects the installment charge and the amount to split the payment.	Text	No

","urlObject":{"protocol":"https","path":["api","v1","integracionpg","{token}"],"host":["app","pagalocard","com"],"query":[],"variable":[]}},"response":[{"id":"ff820006-d6a2-41ab-bccc-18cca4c7ceb6","name":"Payment Epay Quota","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"empresa\": \"{\\\"key_secret\\\":\\\"secret\\\",\\\"key_public\\\":\\\"public\\\",\\\"idenEmpresa\\\":\\\"idempresa\\\"}\",\r\n \r\n \"cliente\": \"{\\\"nit\\\":\\\"55205801\\\",\\\"codigo\\\":\\\"3\\\",\\\"firstName\\\":\\\"Pagalo\\\",\\\"lastName\\\":\\\"CON\\\",\\\"street1\\\":\\\"12 Avenida Zona 15\\\",\\\"country\\\":\\\"GT\\\",\\\"city\\\":\\\"Guatemala\\\",\\\"state\\\":\\\"GT\\\",\\\"postalCode\\\":\\\"04001\\\",\\\"email\\\":\\\"pagalotest2@gmail.com\\\",\\\"ipAddress\\\":\\\"190.104.119.240\\\",\\\"phone\\\":\\\"40404040\\\",\\\"Total\\\":1.5,\\\"deviceFingerprintID\\\":\\\"\\\",\\\"currency\\\":\\\"GTQ\\\",\\\"fecha_transaccion\\\":\\\"2021-05-13 14:37:13\\\"}\",\r\n \r\n \"detalle\": \"[{\\\"nombre\\\":\\\"Servicio Virtual\\\",\\\"precio\\\":1.5,\\\"cantidad\\\":1,\\\"tipo\\\":\\\"producto\\\",\\\"id_producto\\\":\\\"777\\\",\\\"Subtotal\\\":1.5}]\",\r\n \r\n \"tarjetaPagalo\": \"{\\\"nCuotas\\\":\\\"3\\\",\\\"nameCard\\\":\\\"Pagalo Test\\\",\\\"accountNumber\\\":\\\"4000000000000416\\\",\\\"expirationMonth\\\":\\\"12\\\",\\\"expirationYear\\\":\\\"2021\\\",\\\"CVVCard\\\":\\\"123\\\"}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://app.pagalocard.com/api/v1/integracionpg/{token}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"decision\": \"ACCEPT\",\n \"reasonCode\": \"00\",\n \"requestID\": \"032210027920\",\n \"infotran\": {\n \"auditNumber\": \"027920\",\n \"referenceNumber\": \"032210027920\",\n \"authorizationNumber\": \"001876\",\n \"responseCode\": \"00\",\n \"messageType\": \"0210\"\n },\n \"metadata\":{\n \"version\":\"1.0\",\n \"created_at\":\"2020-05-10 06:00:05\",\n \"udpated_at\":\"2021-05-12 08:02:45\",\n \"created_by\":\"developer-pagalo\",\n \"domain\":\"app.pagalocard.com\",\n \"description\":\"Pagos con pasarela Epay y cuotas\"\n },\n \"estado\": 1\n}"}],"_postman_id":"6d4d5d08-7441-4a70-8fae-3936380c4da8"}],"id":"3dcad7f7-25cc-4a81-af8e-07b9cb028c30","_postman_id":"3dcad7f7-25cc-4a81-af8e-07b9cb028c30","description":""},{"name":"Cash","item":[{"name":"Create Sale","id":"d0671828-00c4-4668-850c-de5630ae0cc2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"IDENEMPRESA\":\"M32344233\", \r\n \"API_PUBLIC\":\"hk3h2j23j4\",\r\n \"API_SECRET\":\"32330uedes34hk2\",\r\n \"producto\": \"Suscripcion de masajes\",\r\n \"monto\":250.00, //Monto enviarlo en formato decimal\r\n \"cliente\":\"Carlos Perez\",\r\n \"telefono\":\"40404040\",\r\n \"email\":\"cliente@gmail.com\",\r\n \"dpi\": \"26365645454\",\r\n \"direccion\": \"15 calle Zona 10 Guatemala\",\r\n \"punto\":\"pronet\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://test.pagalocard.com/api/v1/pagalocash/crearventa/{token}","description":"

The following information is required to make a sale

\n\n\n\n\n\n\n\n\n\n\n

Español
Para realizar una venta es necesario los siguientes datos

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Params	Description
producto	Product description
monto	Amount receivable
cliente	Customer's name
telefono	Client's phone number
email	Customer's email address
dpi	DPI Number
direccion	Shipping Address

","urlObject":{"protocol":"https","path":["api","v1","pagalocash","crearventa","{token}"],"host":["test","pagalocard","com"],"query":[],"variable":[]}},"response":[{"id":"c5fa0e85-e5d8-4b77-a60f-6432de5c3ef0","name":"Create Sale","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"IDENEMPRESA\":\"M32344233\",\r\n \"API_PUBLIC\":\"hk3h2j23j4\",\r\n \"API_SECRET\":\"32330uedes34hk2\",\r\n \"producto\": \"Suscripcion de masajes\",\r\n \"monto\":\"250.00\",\r\n \"cliente\":\"Carlos Perez\",\r\n \"telefono\":\"40404040\",\r\n \"email\":\"cliente@gmail.com\",\r\n \"dpi\": \"26365645454\",\r\n \"direccion\": \"15 calle Zona 10 Guatemala\",\r\n \"punto\":\"pronet\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://test.pagalocard.com/api/v1/pagalocash/crearventa/{token}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"codMensaje\":\"00\",\r\n \"idpago\": \"r4w34e\",\r\n \"datoEncontrado\":true,\r\n \"producto\": \"Suscripcion de masajes\",\r\n \"monto\":250.00,\r\n \"cliente\":\"Carlos Perez\",\r\n \"fecha_expiracion\":\"2021-02-15 00:00:00\",\r\n \"metadata\":{\r\n \"version\":\"1.0\",\r\n \"created_at\":\"2020-05-10 06:00:05\",\r\n \"udpated_at\":\"2021-05-12 08:02:45\",\r\n \"created_by\":\"developer-pagalo\",\r\n \"domain\":\"app.pagalocard.com\",\r\n \"description\":\"Crear una venta con PagaloCash\"\r\n}\r\n}"}],"_postman_id":"d0671828-00c4-4668-850c-de5630ae0cc2"},{"name":"Consult Points","id":"c6fe8fa3-200a-44f6-8b42-db1df74c4e0d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n \"IDENEMPRESA\":\"M32344233\",\r\n \"API_PUBLIC\":\"hk3h2j23j4\",\r\n \"API_SECRET\":\"32330uedes34hk2\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://test.pagalocard.com/api/v1/pagalocash/consultarpunto/{token}","description":"

A cash point is the supplier that will receive the funds for the sale and settlement process.

\n\n\n\n\n\n\n\n\n\n\n

Español
Un punto de cash es el proveedor que recibira los fondos para luego realizar el proceso de venta y liquidacion

Pronet (Pronet, Akisi, Intermex, Banco de Antigua)
Airpak
BAM

\n","urlObject":{"protocol":"https","path":["api","v1","pagalocash","consultarpunto","{token}"],"host":["test","pagalocard","com"],"query":[],"variable":[]}},"response":[{"id":"c9c8fa5c-e53a-4b93-a7e4-0ff8eb810c97","name":"Consult Points","originalRequest":{"method":"GET","header":[],"url":"https://test.pagalocard.com/api/v1/pagalocash/consultarpunto/{token}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"codMensaje\":\"00\",\r\n \"puntos\":[\r\n {\r\n \"nombre\":\"pronet\"\r\n },\r\n {\r\n \"nombre\":\"bam\"\r\n },\r\n {\r\n \"nombre\":\"airpak\"\r\n }\r\n ],\r\n \"metadata\":{\r\n \"version\":\"1.0\",\r\n \"created_at\":\"2020-05-10 06:00:05\",\r\n \"udpated_at\":\"2021-05-12 08:02:45\",\r\n \"created_by\":\"developer-pagalo\",\r\n \"domain\":\"app.pagalocard.com\",\r\n \"description\":\"Consultar puntos de PagaloCash\"\r\n }\r\n } "}],"_postman_id":"c6fe8fa3-200a-44f6-8b42-db1df74c4e0d"},{"name":"Consult Branch","id":"1e00eb9d-ea91-4395-b3e3-120aca5540ee","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n \"IDENEMPRESA\":\"M32344233\",\r\n \"API_PUBLIC\":\"hk3h2j23j4\",\r\n \"API_SECRET\":\"32330uedes34hk2\",\r\n \"punto\":\"pronet\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://test.pagalocard.com/api/v1/pagalocash/sucursales/{token}","description":"

The branches are obtained on the basis of the consulted point.

\n","urlObject":{"protocol":"https","path":["api","v1","pagalocash","sucursales","{token}"],"host":["test","pagalocard","com"],"query":[],"variable":[]}},"response":[{"id":"7783f403-487f-4091-8311-251ce8032a6a","name":"Consult Branch","originalRequest":{"method":"GET","header":[],"url":"https://test.pagalocard.com/api/v1/pagalocash/sucursales/{token}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"codMensaje\": \"00\",\n \"puntos\": [\n {\n \"cadena\": \"Cajas de Desarrollo\",\n \"nombre\": \"TIENDA VILLA SAN ANDRES\",\n \"departamento\": \"Quetzaltenango\",\n \"municipio\": \"Quetzaltenango\",\n \"direccion\": \"Final de la 9 avenida 14-96 Zona 1 del Municipio de Quetzaltenango del Departamento de Quetzaltenango\",\n \"latitud\": \"14.8207518\",\n \"longitud\": \"-98.7923\"\n }\n ],\n \"metadata\":{\n \"version\":\"1.0\",\n \"created_at\":\"2020-05-10 06:00:05\",\n \"udpated_at\":\"2021-05-12 08:02:45\",\n \"created_by\":\"developer-pagalo\",\n \"domain\":\"app.pagalocard.com\",\n \"description\":\"Consultar sucursales\"\n }\n}"}],"_postman_id":"1e00eb9d-ea91-4395-b3e3-120aca5540ee"},{"name":"Transaction Status","id":"363d2973-12c4-416d-a884-e0241c492e9f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n \"IDENEMPRESA\":\"M32344233\",\r\n \"API_PUBLIC\":\"hk3h2j23j4\",\r\n \"API_SECRET\":\"32330uedes34hk2\",\r\n \"idpago\":\"1234\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://test.pagalocard.com/api/v1/pagalocash/estadotransaccion/{token}","description":"

When a sale is made it remains in Pending status and until the customer takes the money to a payment point it changes its status to Paid.

\n","urlObject":{"protocol":"https","path":["api","v1","pagalocash","estadotransaccion","{token}"],"host":["test","pagalocard","com"],"query":[],"variable":[]}},"response":[{"id":"af289abd-9278-4f5e-a499-34ad32b0bd03","name":"Transaction Status","originalRequest":{"method":"GET","header":[],"url":"https://test.pagalocard.com/api/v1/pagalocash/estadotransaccion/{token}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"codMensaje\": \"00\",\n \"idpago\": \"1234\",\n \"estado\": \"Anulado\",\n \"metadata\":{\n \"version\":\"1.0\",\n \"created_at\":\"2020-05-10 06:00:05\",\n \"udpated_at\":\"2021-05-12 08:02:45\",\n \"created_by\":\"developer-pagalo\",\n \"domain\":\"app.pagalocard.com\",\n \"description\":\"Status de la transaccion\"\n }\n}"}],"_postman_id":"363d2973-12c4-416d-a884-e0241c492e9f"},{"name":"Cancel Transaction","id":"f48fdff5-5817-4dc7-8c7f-d05d357a8c1e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n \"IDENEMPRESA\":\"M32344233\",\r\n \"API_PUBLIC\":\"hk3h2j23j4\",\r\n \"API_SECRET\":\"32330uedes34hk2\",\r\n \"idpago\":\"1234\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://test.pagalocard.com/api/v1/pagalocash/anulartransaccion/{token}","description":"

If the customer does not pay or the service or product is not delivered, it can be cancelled.

\n","urlObject":{"protocol":"https","path":["api","v1","pagalocash","anulartransaccion","{token}"],"host":["test","pagalocard","com"],"query":[],"variable":[]}},"response":[{"id":"67c46284-6085-4dbb-91fa-446773c37ecb","name":"Cancel Transaction","originalRequest":{"method":"GET","header":[],"url":"https://test.pagalocard.com/api/v1/pagalocash/anulartransaccion/{token}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"codMensaje\": \"00\",\n \"idpago\": \"1234\",\n \"estado\": \"Anulado\",\n \"metadata\":{\n \"version\":\"1.0\",\n \"created_at\":\"2020-05-10 06:00:05\",\n \"udpated_at\":\"2021-05-12 08:02:45\",\n \"created_by\":\"developer-pagalo\",\n \"domain\":\"app.pagalocard.com\",\n \"description\":\"Cancelar la transaccion\"\n }\n}"}],"_postman_id":"f48fdff5-5817-4dc7-8c7f-d05d357a8c1e"}],"id":"eba490ea-39de-46dd-93e7-b3943da76a29","description":"

OBJECTIVE

Every transaction made by PagaloCash generates a unique code or token to make a cash payment.

Transaction process

Merchant shares link or online store with PagaloCash enabled option.
Customer selects the product and accepts the transaction
A unique 6-digit token is generated This payment code lasts for 48 hours
The transaction remains in pending status Customer goes to Cash points and displays the payment code
The payment code is queried from the system
Proceeds to make the payment in cash and changes the status to Paid
Merchant receives confirmation to proceed to deliver the product or service

API URL\n*Token is provided in credentials

https://test.pagalocard.com/api/v1/pagalocash/{token}

Fields for authorization

The fields will be provided in the credentials for the connection data

- IDENEMPRESA: M32344233\n- API_PUBLIC: hk3h2j23j4\n- API_SECRET: 32330uedes34hk2\n

RESTUL connection methods

Create a sale with POST
Consult cash point by GET
Consult cash point branches with GET
Consult transaction status via POST
Cancel transaction by POST

\n","_postman_id":"eba490ea-39de-46dd-93e7-b3943da76a29"}],"id":"36f6cac6-b548-4c87-9a4f-10499e6c4ae7","_postman_id":"36f6cac6-b548-4c87-9a4f-10499e6c4ae7","description":""},{"name":"Integrations","item":[{"name":"Products","item":[{"name":"Create Product","id":"5266e51f-0c2c-4fc0-a8a6-b1706763a426","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\t\r\n \"empresa\": \"{\\\"key_secret\\\":\\\"VoDF1URodAWOZszsBCh6FN4JlVZ5jltZl8IvhnyB\\\",\\\"key_public\\\":\\\"KpWRvCTpTdZB0kqiWKfbvSQ5LLZvJQL73mg2oVPL\\\",\\\"idenEmpresa\\\":\\\"B490690943\\\"}\",\r\n\t\"sku\" :\"Prueba.14.may.2021\",\t\r\n\t\"precio_usd\" :\"\",\r\n\t\"precio\" :\"199.99\",\r\n\t\"ac_stock\" :\"0\",\r\n\t\"categoria\" :\"30\",\r\n\t\"subcategoria\":null,\r\n\t\"stock\" :\"0\",\r\n\t\"nombre\" :\"Aretes Modelo abc\",\r\n\t\"descripcion\" :\"Aretes de oro 14K\",\r\n\t\"peso\" :\"1\",\r\n\t\"altura\" :\"0\",\r\n\t\"anchura\" :\"0\",\r\n\t\"largo\" :\"0\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://app.pagalocard.com/integration/products/createProduct/{token}","description":"

Description

This api is used for create products

Main Parameters

Token parameters added in url

{token}

Body parameters json string

empresa, json element
key_public, value: string
key_secret, value: string
idenEmpresa, value: string
sku,
- ( internal product code )
\n
precio_usd
- ( dollar price )
\n
precio
- ( price )
\n
ac_stock
- ( value 1 for check inventory, value \"0\" deactivate validation )
\n
categoria
- ( product category )
\n
subcategoria
- ( producto sub-category )
\n
stock
nombre
- ( product name )
\n
descripcion
- ( product description )
\n
peso
- ( product weight )
\n
altura
- ( prodct heigth )
\n
anchura
- ( product width )
\n
largo
- ( prodcut long )
\n

Remark

The json has to be formed like this:

\"empresa\":\"{\"key_secret\":\"V.....lVZ5jltZl8IvhnyB\", \"key_public\":\"KpWR.....5LLZvJQL73mg2oVPL\", \"idenEmpresa\":\"B4....43\"}\"

Optional Parameters

none

\n","urlObject":{"protocol":"https","path":["integration","products","createProduct","{token}"],"host":["app","pagalocard","com"],"query":[],"variable":[]}},"response":[{"id":"ad20aa26-6bd7-4cba-8c02-5deee05b964e","name":"Create Product","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\t\r\n \"empresa\": \"{\\\"key_secret\\\":\\\"VoDF1URodAWOZszsBCh6FN4JlVZ5jltZl8IvhnyB\\\",\\\"key_public\\\":\\\"KpWRvCTpTdZB0kqiWKfbvSQ5LLZvJQL73mg2oVPL\\\",\\\"idenEmpresa\\\":\\\"B490690943\\\"}\",\r\n\t\"sku\" :\"Prueba.14.may.2021\",\t\r\n\t\"precio_usd\" :\"\",\r\n\t\"precio\" :\"199.99\",\r\n\t\"ac_stock\" :\"0\",\r\n\t\"categoria\" :\"30\",\r\n\t\"subcategoria\":null,\r\n\t\"stock\" :\"0\",\r\n\t\"nombre\" :\"Aretes Modelo abc\",\r\n\t\"descripcion\" :\"Aretes de oro 14K\",\r\n\t\"peso\" :\"1\",\r\n\t\"altura\" :\"0\",\r\n\t\"anchura\" :\"0\",\r\n\t\"largo\" :\"0\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://app.pagalocard.com/integration/products/createProduct/{token}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"id_producto\": 7038,\n \"metadata\":{\n \"version\":\"1.0\",\n \"created_at\":\"2020-05-10 06:00:05\",\n \"udpated_at\":\"2021-05-12 08:02:45\",\n \"created_by\":\"developer-pagalo\",\n \"domain\":\"app.pagalocard.com\",\n \"description\":\"Crear un producto\"\n }\n}"}],"_postman_id":"5266e51f-0c2c-4fc0-a8a6-b1706763a426"},{"name":"Update Product","id":"459b1ddb-31ed-4503-9ade-c9f7b18cb532","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\t\r\n \"empresa\": \"{\\\"key_secret\\\":\\\"VoDF1URodAWOZszsBCh6FN4JlVZ5jltZl8IvhnyB\\\",\\\"key_public\\\":\\\"KpWRvCTpTdZB0kqiWKfbvSQ5LLZvJQL73mg2oVPL\\\",\\\"idenEmpresa\\\":\\\"B490690943\\\"}\",\r\n \"id\" :6631,\r\n\t\"sku\" :\"Prueba.14.may.2021\",\t\r\n \t\"precio_usd\" :\"\",\r\n\t\"precio\" :\"199.99\",\r\n\t\"ac_stock\" :\"0\",\r\n\t\"categoria\" :\"30\",\r\n\t\"subcategoria\":null,\r\n\t\"stock\" :\"0\",\r\n\t\"nombre\" :\"Aretes Modelo abc\",\r\n\t\"descripcion\" :\"Aretes de oro 14K\",\r\n\t\"peso\" :\"1\",\r\n\t\"altura\" :\"0\",\r\n\t\"anchura\" :\"0\",\r\n\t\"largo\" :\"0\"\r\n\r\n}","options":{"raw":{"language":"json"}}},"url":"https://app.pagalocard.com/integration/products/updateProduct/{token}","description":"

Description

This api is used for update products

Main Parameters

Token parameters added in url

{token}

Body parameters json string

empresa, json element
key_public, value: string
key_secret, value: string
idenEmpresa, value: string
id
- ( primary key product identification )
\n
sku,
- ( internal product code )
\n
precio_usd
- ( dollar price )
\n
precio
- ( price )
\n
ac_stock
- ( value 1 for check inventory, value \"0\" deactivate validation )
\n
categoria
- ( product category )
\n
subcategoria
- ( producto sub-category )
\n
stock
nombre
- ( product name )
\n
descripcion
- ( product description )
\n
peso
- ( product weight )
\n
altura
- ( prodct heigth )
\n
anchura
- ( product width )
\n
largo
- ( prodcut long )
\n

Remark

The json has to be formed like this:

\"empresa\":\"{\"key_secret\":\"V.....lVZ5jltZl8IvhnyB\", \"key_public\":\"KpWR.....5LLZvJQL73mg2oVPL\", \"idenEmpresa\":\"B4....43\"}\"

Optional Parameters

none

\n","urlObject":{"protocol":"https","path":["integration","products","updateProduct","{token}"],"host":["app","pagalocard","com"],"query":[],"variable":[]}},"response":[{"id":"f247b006-be25-401f-8fd6-bbd1d6b62e40","name":"Update Product","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\t\r\n \"empresa\": \"{\\\"key_secret\\\":\\\"VoDF1URodAWOZszsBCh6FN4JlVZ5jltZl8IvhnyB\\\",\\\"key_public\\\":\\\"KpWRvCTpTdZB0kqiWKfbvSQ5LLZvJQL73mg2oVPL\\\",\\\"idenEmpresa\\\":\\\"B490690943\\\"}\",\r\n \"id\" :6631,\r\n\t\"sku\" :\"Prueba.14.may.2021\",\t\r\n \t\"precio_usd\" :\"\",\r\n\t\"precio\" :\"199.99\",\r\n\t\"ac_stock\" :\"0\",\r\n\t\"categoria\" :\"30\",\r\n\t\"subcategoria\":null,\r\n\t\"stock\" :\"0\",\r\n\t\"nombre\" :\"Aretes Modelo abc\",\r\n\t\"descripcion\" :\"Aretes de oro 14K\",\r\n\t\"peso\" :\"1\",\r\n\t\"altura\" :\"0\",\r\n\t\"anchura\" :\"0\",\r\n\t\"largo\" :\"0\"\r\n\r\n}","options":{"raw":{"language":"json"}}},"url":"https://app.pagalocard.com/integration/products/updateProduct/{token}"},"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"id_producto\": 7038,\n \"metadata\": {\n \"version\": \"1.0\",\n \"created_at\": \"2020-05-10 06:00:05\",\n \"udpated_at\": \"2021-05-12 08:02:45\",\n \"created_by\": \"developer-pagalo\",\n \"domain\": \"app.pagalocard.com\",\n \"description\": \"Editar productos\"\n }\n}"}],"_postman_id":"459b1ddb-31ed-4503-9ade-c9f7b18cb532"},{"name":"Disable Product","id":"ebb984d1-bf32-424b-8146-e0aedd891453","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\t\r\n \"empresa\": \"{\\\"key_secret\\\":\\\"VoDF1URodAWOZszsBCh6FN4JlVZ5jltZl8IvhnyB\\\",\\\"key_public\\\":\\\"KpWRvCTpTdZB0kqiWKfbvSQ5LLZvJQL73mg2oVPL\\\",\\\"idenEmpresa\\\":\\\"B490690943\\\"}\",\r\n \"id\":6631\r\n}","options":{"raw":{"language":"json"}}},"url":"https://app.pagalocard.com/integration/products/disableProduct/{token}","description":"

Description

This api is used for deactivate product

Main Parameters

Token parameters added in url

{token}

Body parameters json string

empresa, json element
key_public, value: string
key_secret, value: string
idenEmpresa, value: string
id
- ( primary key prodcut identification )
\n

Remark

The json has to be formed like this:

\"empresa\":\"{\"key_secret\":\"V.....lVZ5jltZl8IvhnyB\", \"key_public\":\"KpWR.....5LLZvJQL73mg2oVPL\", \"idenEmpresa\":\"B4....43\"}\"

Optional Parameters

none

\n","urlObject":{"protocol":"https","path":["integration","products","disableProduct","{token}"],"host":["app","pagalocard","com"],"query":[],"variable":[]}},"response":[{"id":"5e9da037-bc72-4168-ba6c-0db3ee8d6d53","name":"Disable Product","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\t\r\n \"empresa\": \"{\\\"key_secret\\\":\\\"VoDF1URodAWOZszsBCh6FN4JlVZ5jltZl8IvhnyB\\\",\\\"key_public\\\":\\\"KpWRvCTpTdZB0kqiWKfbvSQ5LLZvJQL73mg2oVPL\\\",\\\"idenEmpresa\\\":\\\"B490690943\\\"}\",\r\n \"id\":6631\r\n}","options":{"raw":{"language":"json"}}},"url":"https://app.pagalocard.com/integration/products/disableProduct/{token}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"id\": 7038,\n \"metadata\":{\n \"version\":\"1.0\",\n \"created_at\":\"2020-05-10 06:00:05\",\n \"udpated_at\":\"2021-05-12 08:02:45\",\n \"created_by\":\"developer-pagalo\",\n \"domain\":\"app.pagalocard.com\",\n \"description\":\"Deshabilitar productos\"\n }\n}"}],"_postman_id":"ebb984d1-bf32-424b-8146-e0aedd891453"}],"id":"8ea9790a-e840-4cd3-8028-6e35166eb4f1","description":"

Objetive

This guide explain how consume RestFul services for products.

It is necessary to obtain the credentials to authenticate in test or live environment.

RESTFUL Methods

Product list GET method
Create product POST method
Update product POST method
Disable product POST method

\n","_postman_id":"8ea9790a-e840-4cd3-8028-6e35166eb4f1"},{"name":"Clients","item":[{"name":"Create Client","id":"ed89e6ed-3281-4b33-a52e-fc18e490c56f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\t\r\n \"empresa\" : \"{\\\"key_secret\\\":\\\"VoDF1URodAWOZszsBCh6FN4JlVZ5jltZl8IvhnyB\\\",\\\"key_public\\\":\\\"KpWRvCTpTdZB0kqiWKfbvSQ5LLZvJQL73mg2oVPL\\\",\\\"idenEmpresa\\\":\\\"B490690943\\\"}\",\r\n\t\"email\" :\"clientenuevo@dominio.com.gt\",\t\r\n\t\"telefono\" :\"1111-2222\",\r\n\t\"nombre\" :\"Nombre Cliente Nuevo 14.may.2021\",\r\n\t\"apellido\" :\"Apellido Cliente Nuevo Nuevo 14.may.2021\",\r\n\t\"direccion\" :\"zona 10\",\r\n\t\"pais\" :\"GT\",\r\n\t\"ciudad\" :\"Guatemala\",\r\n\t\"nit\" :\"123456-7\",\r\n\t\"state\" :\"CA\",\r\n\t\"postalcode\" :\"01010\",\r\n\t\"tipocliente\" :\"CY\",\r\n\t\"estado\" :\"1\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://app.pagalocard.com/integration/clients/createClient/{token}","description":"

Description

This api is used for create products

Main Parameters

Token parameters added in url

{token}

Body parameters json string

empresa, json element
key_public, value: string
key_secret, value: string
idenEmpresa, value: string
email,
telefono
( phone )
nombre
( name )
apellido
( lastname )
direccion
( address )
pais
( country )
ciudad
( city )
nit
( tax identification number )
state
postalcode
tipocliente
( client type )
estado
( status by default 1 )

Remark

The json has to be formed like this:

\"empresa\":\"{\"key_secret\":\"V.....lVZ5jltZl8IvhnyB\", \"key_public\":\"KpWR.....5LLZvJQL73mg2oVPL\", \"idenEmpresa\":\"B4....43\"}\"

Optional Parameters

none

\n","urlObject":{"protocol":"https","path":["integration","clients","createClient","{token}"],"host":["app","pagalocard","com"],"query":[],"variable":[]}},"response":[{"id":"d6a32af5-a608-4308-93af-3ca46dbd9036","name":"Create Client","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\t\r\n \"empresa\" : \"{\\\"key_secret\\\":\\\"VoDF1URodAWOZszsBCh6FN4JlVZ5jltZl8IvhnyB\\\",\\\"key_public\\\":\\\"KpWRvCTpTdZB0kqiWKfbvSQ5LLZvJQL73mg2oVPL\\\",\\\"idenEmpresa\\\":\\\"B490690943\\\"}\",\r\n\t\"email\" :\"clientenuevo@dominio.com.gt\",\t\r\n\t\"telefono\" :\"1111-2222\",\r\n\t\"nombre\" :\"Nombre Cliente Nuevo 14.may.2021\",\r\n\t\"apellido\" :\"Apellido Cliente Nuevo Nuevo 14.may.2021\",\r\n\t\"direccion\" :\"zona 10\",\r\n\t\"pais\" :\"GT\",\r\n\t\"ciudad\" :\"Guatemala\",\r\n\t\"nit\" :\"123456-7\",\r\n\t\"state\" :\"CA\",\r\n\t\"postalcode\" :\"01010\",\r\n\t\"tipocliente\" :\"CY\",\r\n\t\"estado\" :\"1\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://app.pagalocard.com/integration/clients/createClient/{token}"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"id\": 482\r\n}"}],"_postman_id":"ed89e6ed-3281-4b33-a52e-fc18e490c56f"},{"name":"Update Client","id":"9d538f74-af07-45e2-8385-85f2744d6ccb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\t\r\n \"empresa\" :\"{\\\"key_secret\\\":\\\"VoDF1URodAWOZszsBCh6FN4JlVZ5jltZl8IvhnyB\\\",\\\"key_public\\\":\\\"KpWRvCTpTdZB0kqiWKfbvSQ5LLZvJQL73mg2oVPL\\\",\\\"idenEmpresa\\\":\\\"B490690943\\\"}\",\r\n \"id\" :273,\r\n \"email\" :\"clientenuevo@dominio.com.gt\",\t\r\n\t\"telefono\" :\"1111-2222\",\r\n\t\"nombre\" :\"Nombre Cliente Nuevo 14.may.2021\",\r\n\t\"apellido\" :\"Apellido Cliente Nuevo Nuevo 14.may.2021\",\r\n\t\"direccion\" :\"zona 10\",\r\n\t\"pais\" :\"GT\",\r\n\t\"ciudad\" :\"Guatemala\",\r\n\t\"nit\" :\"123456-7\",\r\n\t\"state\" :\"CA\",\r\n\t\"postalcode\" :\"01010\",\r\n\t\"tipocliente\" :\"CY\",\r\n\t\"estado\" :\"1\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://app.pagalocard.com/integration/clients/updateClient/{token}","description":"

Description

This api is used for create products

Main Parameters

Token parameters added in url

{token}

Body parameters json string

empresa, json element
key_public, value: string
key_secret, value: string
idenEmpresa, value: string
id
- ( primary key client identification )
\n
email,
telefono
( phone )
nombre
( name )
apellido
( lastname )
direccion
( address )
pais
( country )
ciudad
( city )
nit
( tax identification number )
state
postalcode
tipocliente
( client type )
estado
( status by default 1 )

Remark

The json has to be formed like this:

\"empresa\":\"{\"key_secret\":\"V.....lVZ5jltZl8IvhnyB\", \"key_public\":\"KpWR.....5LLZvJQL73mg2oVPL\", \"idenEmpresa\":\"B4....43\"}\"

Optional Parameters

none

\n","urlObject":{"protocol":"https","path":["integration","clients","updateClient","{token}"],"host":["app","pagalocard","com"],"query":[],"variable":[]}},"response":[{"id":"2ac37e9b-3205-4b5f-ba6e-2962dfbc9cb1","name":"Update Client","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\t\r\n \"empresa\" :\"{\\\"key_secret\\\":\\\"VoDF1URodAWOZszsBCh6FN4JlVZ5jltZl8IvhnyB\\\",\\\"key_public\\\":\\\"KpWRvCTpTdZB0kqiWKfbvSQ5LLZvJQL73mg2oVPL\\\",\\\"idenEmpresa\\\":\\\"B490690943\\\"}\",\r\n \"id\" :273,\r\n \"email\" :\"clientenuevo@dominio.com.gt\",\t\r\n\t\"telefono\" :\"1111-2222\",\r\n\t\"nombre\" :\"Nombre Cliente Nuevo 14.may.2021\",\r\n\t\"apellido\" :\"Apellido Cliente Nuevo Nuevo 14.may.2021\",\r\n\t\"direccion\" :\"zona 10\",\r\n\t\"pais\" :\"GT\",\r\n\t\"ciudad\" :\"Guatemala\",\r\n\t\"nit\" :\"123456-7\",\r\n\t\"state\" :\"CA\",\r\n\t\"postalcode\" :\"01010\",\r\n\t\"tipocliente\" :\"CY\",\r\n\t\"estado\" :\"1\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://app.pagalocard.com/integration/clients/updateClient/{token}"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"id\": 482\r\n}"}],"_postman_id":"9d538f74-af07-45e2-8385-85f2744d6ccb"},{"name":"Disable Client","id":"23e882af-7f6f-4f3e-9a2f-ebb03b6ea0d6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\t\r\n \"empresa\": \"{\\\"key_secret\\\":\\\"VoDF1URodAWOZszsBCh6FN4JlVZ5jltZl8IvhnyB\\\",\\\"key_public\\\":\\\"KpWRvCTpTdZB0kqiWKfbvSQ5LLZvJQL73mg2oVPL\\\",\\\"idenEmpresa\\\":\\\"B490690943\\\"}\",\r\n \"id\":273\r\n}","options":{"raw":{"language":"json"}}},"url":"https://app.pagalocard.com/integration/clients/disableClient/{token}","description":"

Description

This api is used for deactivate client

Main Parameters

Token parameters added in url

{token}

Body parameters json string

empresa, json element
key_public, value: string
key_secret, value: string
idenEmpresa, value: string
id
- ( primary key client identification )
\n

Remark

The json has to be formed like this:

\"empresa\":\"{\"key_secret\":\"V.....lVZ5jltZl8IvhnyB\", \"key_public\":\"KpWR.....5LLZvJQL73mg2oVPL\", \"idenEmpresa\":\"B4....43\"}\"

Optional Parameters

none

\n","urlObject":{"protocol":"https","path":["integration","clients","disableClient","{token}"],"host":["app","pagalocard","com"],"query":[],"variable":[]}},"response":[{"id":"89c56e53-7f85-4d1d-bde4-01e0e7503810","name":"Disable Client","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\t\r\n \"empresa\": \"{\\\"key_secret\\\":\\\"VoDF1URodAWOZszsBCh6FN4JlVZ5jltZl8IvhnyB\\\",\\\"key_public\\\":\\\"KpWRvCTpTdZB0kqiWKfbvSQ5LLZvJQL73mg2oVPL\\\",\\\"idenEmpresa\\\":\\\"B490690943\\\"}\",\r\n \"id\":273\r\n}","options":{"raw":{"language":"json"}}},"url":"https://app.pagalocard.com/integration/clients/disableClient/{token}"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"id\": 482\r\n}"}],"_postman_id":"23e882af-7f6f-4f3e-9a2f-ebb03b6ea0d6"}],"id":"d81a6c14-04e4-4169-bc4a-ddb691b4109b","_postman_id":"d81a6c14-04e4-4169-bc4a-ddb691b4109b","description":""},{"name":"Transactions","item":[{"name":"View Transaction","id":"60644b1b-3991-4e62-8f78-973b96568647","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n \"empresa\": \"{\\\"key_secret\\\":\\\"VoDF1URodAWOZszsBCh6FN4JlVZ5jltZl8IvhnyB\\\",\\\"key_public\\\":\\\"KpWRvCTpTdZB0kqiWKfbvSQ5LLZvJQL73mg2oVPL\\\",\\\"idenEmpresa\\\":\\\"B490690943\\\"}\",\r\n \"requestId\":\"6137626330956047104011\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://app.pagalocard.com/integration/transactions/viewTransaction/{token}","description":"

Description

This api obtain a transaction by number

Main Parameters

Token parameters added in url

{token}

Body parameters json string

empresa, json element
key_public, value: string
key_secret, value: string
idenEmpresa, value: string
requestId
- ( transaction number )
\n

Remark

The json has to be formed like this:

\"empresa\":\"{\"key_secret\":\"V.....lVZ5jltZl8IvhnyB\", \"key_public\":\"KpWR.....5LLZvJQL73mg2oVPL\", \"idenEmpresa\":\"B4....43\"}\"

Optional Parameters

none

\n","urlObject":{"protocol":"https","path":["integration","transactions","viewTransaction","{token}"],"host":["app","pagalocard","com"],"query":[],"variable":[]}},"response":[{"id":"5c64eaff-6774-434d-bcb1-481bf6e79953","name":"View Transaction","originalRequest":{"method":"GET","header":[],"url":"https://app.pagalocard.com/integration/transactions/viewTransaction/{token}"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"code\": \"00\",\r\n \"data\": {\r\n \"requestID\": \"MF0WH5\",\r\n \"date\": \"2021-05-24 12:35:40\",\r\n \"name\": \"miguel\",\r\n \"lastName\": \"\",\r\n \"email\": \"usuario@dominio.co\",\r\n \"street\": \"zona 10\",\r\n \"city\": \"Guatemala\",\r\n \"lastDigit\": \"\",\r\n \"status\": 2,\r\n \"reasonCode\": \"\",\r\n \"type\": \"SFCASH\",\r\n \"ipAddress\": \"192.168.10.1\"\r\n },\r\n \"requestId\": \"MF0WH5\"\r\n}\r\n"}],"_postman_id":"60644b1b-3991-4e62-8f78-973b96568647"},{"name":"Reverse Transaction","id":"53a04e68-ffb5-4847-9dc8-8ba72e4d06ba","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"empresa\": \"{\\\"key_secret\\\":\\\"VoDF1URodAWOZszsBCh6FN4JlVZ5jltZl8IvhnyB\\\",\\\"key_public\\\":\\\"KpWRvCTpTdZB0kqiWKfbvSQ5LLZvJQL73mg2oVPL\\\",\\\"idenEmpresa\\\":\\\"B490690943\\\"}\",\r\n \"requestId\":\"6137626330956047104011\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://app.pagalocard.com/integration/transactions/reverseTransaction/{token}","description":"

Description

This api obtain a transaction by number

Important: Transaction reversals can be made on the day of the transaction, before 11:30 pm, otherwise you will receive a response message that the reversal was not made on the day of the transaction.

Main Parameters

Token parameters added in url

{token}

Body parameters json string

empresa, json element
key_public, value: string
key_secret, value: string
idenEmpresa, value: string
requestId
- ( transaction number Cybersource, EPAY, EPAY Quota)
\n

Remark

The json has to be formed like this:

\"empresa\":\"{\"key_secret\":\"V.....lVZ5jltZl8IvhnyB\", \"key_public\":\"KpWR.....5LLZvJQL73mg2oVPL\", \"idenEmpresa\":\"B4....43\"}\"

Optional Parameters

none

\n","urlObject":{"protocol":"https","path":["integration","transactions","reverseTransaction","{token}"],"host":["app","pagalocard","com"],"query":[],"variable":[]}},"response":[{"id":"a2333ae3-c379-47cd-9f2b-969d0301c3bd","name":"Reverse Transaction","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"empresa\": \"{\\\"key_secret\\\":\\\"VoDF1URodAWOZszsBCh6FN4JlVZ5jltZl8IvhnyB\\\",\\\"key_public\\\":\\\"KpWRvCTpTdZB0kqiWKfbvSQ5LLZvJQL73mg2oVPL\\\",\\\"idenEmpresa\\\":\\\"B490690943\\\"}\",\r\n \"requestId\":\"6137626330956047104011\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://app.pagalocard.com/integration/transactions/reverseTransaction/{token}"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\n \"decision\": \"ACCEPT\",\n \"reasonCode\": \"00\",\n \"requestID\": \"032210027920\",\n \"estado\": 1\n}"}],"_postman_id":"53a04e68-ffb5-4847-9dc8-8ba72e4d06ba"}],"id":"bab868b4-9b60-4033-bc40-012fd28c7a90","_postman_id":"bab868b4-9b60-4033-bc40-012fd28c7a90","description":""},{"name":"Users","item":[{"name":"Create User","id":"683e910b-e066-4fd8-9a02-2a28d275e975","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\t\r\n \"empresa\": \"{\\\"key_secret\\\":\\\"VoDF1URodAWOZszsBCh6FN4JlVZ5jltZl8IvhnyB\\\",\\\"key_public\\\":\\\"KpWRvCTpTdZB0kqiWKfbvSQ5LLZvJQL73mg2oVPL\\\",\\\"idenEmpresa\\\":\\\"B490690943\\\"}\",\r\n\t\"firstName\" :\"Carlos\",\t\r\n\t\"lastName\" :\"Perez\",\r\n\t\"email\" :\"carlosperez@gmail.com\",\r\n\t\"password\" :\"Carlos2020_\",\r\n\t\"rol\" :\"Operativo\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://app.pagalocard.com/integration/users/create/{token}","description":"

To create a user it is mandatory to use Email as the user's unique ID.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameters	Description	Required
empresa	Necessary trade credentials	Yes
email	Email user	Yes
firstName	First name user	Yes
lastName	Last name user	Yes
password	Minimum 8 characters with capital letters, text and numbers.	Yes
Rol	Adding the role based on the documentation	Yes

","urlObject":{"protocol":"https","path":["integration","users","create","{token}"],"host":["app","pagalocard","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"683e910b-e066-4fd8-9a02-2a28d275e975"},{"name":"Update User","id":"7eb8d2f8-6fcf-482a-80aa-27f45ac60c29","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\t\r\n \"empresa\": \"{\\\"key_secret\\\":\\\"VoDF1URodAWOZszsBCh6FN4JlVZ5jltZl8IvhnyB\\\",\\\"key_public\\\":\\\"KpWRvCTpTdZB0kqiWKfbvSQ5LLZvJQL73mg2oVPL\\\",\\\"idenEmpresa\\\":\\\"B490690943\\\"}\",\r\n \"email\" :\"carlosperez@gmail.com\",\r\n\t\"firstName\" :\"Carlos\",\t\r\n\t\"lastName\" :\"Perez\",\r\n\t\"password\" :\"Carlos2020_\",\r\n\t\"rol\" :\"Operativo\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://app.pagalocard.com/integration/users/update/{token}","urlObject":{"protocol":"https","path":["integration","users","update","{token}"],"host":["app","pagalocard","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"7eb8d2f8-6fcf-482a-80aa-27f45ac60c29"},{"name":"Delete User","id":"f5e4203a-4361-4410-9798-0d84717c9503","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\t\r\n \"empresa\": \"{\\\"key_secret\\\":\\\"VoDF1URodAWOZszsBCh6FN4JlVZ5jltZl8IvhnyB\\\",\\\"key_public\\\":\\\"KpWRvCTpTdZB0kqiWKfbvSQ5LLZvJQL73mg2oVPL\\\",\\\"idenEmpresa\\\":\\\"B490690943\\\"}\",\r\n \"email\" :\"carlosperez@gmail.com\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://app.pagalocard.com/integration/users/delete/{token}","urlObject":{"protocol":"https","path":["integration","users","delete","{token}"],"host":["app","pagalocard","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"f5e4203a-4361-4410-9798-0d84717c9503"}],"id":"433e54e7-85bd-4954-bd15-44a70978a9f8","description":"

For Business and Enterprise businesses, you can create users, edit users, delete users and get the list.

For a merchant connection it is necessary to obtain LIVE credentials.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameters	Description
IdEmpresa	Unique company ID
token	Token to identify API and action for connection
key_public	Key Public
key_secret	Key Secret

The user roles to be used are

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameters	Description
Supervisor	Access to all modules, but not to configurations
Operativo	Access only to make sales with the modules and to the corresponding group.
Financiero	Access to transaction reporting and settlements only.
Developer	Access to obtain credentials and test transaction reviews

","_postman_id":"433e54e7-85bd-4954-bd15-44a70978a9f8"},{"name":"Reports and analytics","item":[{"name":"Transaction List","id":"72320aea-7786-4ac9-9d92-d3a3d05935f3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n \"empresa\": \"{\\\"key_secret\\\":\\\"VoDF1URodAWOZszsBCh6FN4JlVZ5jltZl8IvhnyB\\\",\\\"key_public\\\":\\\"KpWRvCTpTdZB0kqiWKfbvSQ5LLZvJQL73mg2oVPL\\\",\\\"idenEmpresa\\\":\\\"B490690943\\\"}\",\r\n \"filters\": \"{\\\"startDate\\\":\\\"2018-06-28\\\",\\\"endDate\\\":\\\"2018-06-28\\\",\\\"firstName\\\":\\\"Osman\\\", \\\"email\\\":\\\"ocruz@jupi.tech\\\", \\\"lastDigit\\\":\\\"\\\", \\\"status\\\":\\\"3\\\", \\\"limitPage\\\":\\\"15\\\", \\\"page\\\":\\\"1\\\"}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://app.pagalocard.com/integration/transactions/listTransactions/{token}","description":"

Description

This api return a transaction list

Main Parameters

Token parameters added in url

{token}

Body parameters json string

empresa, value: string
key_public, value: string
key_secret, value: string
idenEmpresa, value: string
startDate, value: string
endDate, value: string
firstName, value: string
email, value: string
lastDigit, value: string
- ( credit card last four number )
\n
status, value: string
limitePage, value: string
- ( used for pagination data view )
\n
page value: string
- ( page number for pagination view )
\n

Remark

The json has to be formed like this:

\"empresa\":\"{\"key_secret\":\"V.....lVZ5jltZl8IvhnyB\", \"key_public\":\"KpWR.....5LLZvJQL73mg2oVPL\", \"idenEmpresa\":\"B4....43\"}\"

Optional Parameters

none

\n","urlObject":{"protocol":"https","path":["integration","transactions","listTransactions","{token}"],"host":["app","pagalocard","com"],"query":[],"variable":[]}},"response":[{"id":"f8f2d6e1-5ac4-49a2-bf14-1e730dc69dc2","name":"Transaction List","originalRequest":{"method":"GET","header":[],"url":"https://app.pagalocard.com/integration/transactions/listTransactions/{token}"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"code\": \"00\",\r\n \"data\": [\r\n {\r\n \"requestID\": \"El comercio no esta activo o no existe\",\r\n \"transactionDate\": \"2021-05-24 12:57:07\",\r\n \"name\": \"miguel\",\r\n \"lastName\": \"\",\r\n \"email\": \"mperez@pagalo.co\",\r\n \"street\": \"zona 10\",\r\n \"city\": \"Guatemala\",\r\n \"lastDigit\": \"\",\r\n \"status\": 2,\r\n \"reasonCode\": \"\",\r\n \"transactionType\": \"SFCASH\",\r\n \"ipAddress\": \"192.168.10.1\"\r\n },\r\n {\r\n \"requestID\": \"MF0JH5\",\r\n \"transactionDate\": \"2021-05-24 12:35:40\",\r\n \"name\": \"miguel\",\r\n \"lastName\": \"\",\r\n \"email\": \"mperez@pagalo.co\",\r\n \"street\": \"zona 10\",\r\n \"city\": \"Guatemala\",\r\n \"lastDigit\": \"\",\r\n \"status\": 2,\r\n \"reasonCode\": \"\",\r\n \"transactionType\": \"SFCASH\",\r\n \"ipAddress\": \"192.168.10.1\"\r\n }\r\n ],\r\n \"pagination\": {\r\n \"total_items\": 2,\r\n \"limit_page\": \"15\",\r\n \"total_pages\": 1,\r\n \"actual_page\": 1\r\n }\r\n}"}],"_postman_id":"72320aea-7786-4ac9-9d92-d3a3d05935f3"},{"name":"Client List","id":"642a6fe4-de6e-4dc1-b1ca-bc1bb7f93de3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n\t\"empresa\": \"{\\\"key_secret\\\":\\\"VoDF1URodAWOZszsBCh6FN4JlVZ5jltZl8IvhnyB\\\",\\\"key_public\\\":\\\"KpWRvCTpTdZB0kqiWKfbvSQ5LLZvJQL73mg2oVPL\\\",\\\"idenEmpresa\\\":\\\"B490690943\\\"}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://app.pagalocard.com/integration/clients/listClients/{token}","description":"

Description

This api return a list clients

Main Parameters

Token parameters added in url

{token}

Body parameters json string

\"empresa\", value: string
\"key_public\", value: string
\"key_secret\", value: string
\"idenEmpresa\", value: string

Remark

The json has to be formed like this:

\"empresa\":\"{\"key_secret\":\"V.....lVZ5jltZl8IvhnyB\", \"key_public\":\"KpWR.....5LLZvJQL73mg2oVPL\", \"idenEmpresa\":\"B4....43\"}\"

Optional Parameters

none

\n","urlObject":{"protocol":"https","path":["integration","clients","listClients","{token}"],"host":["app","pagalocard","com"],"query":[],"variable":[]}},"response":[{"id":"9b90a7fb-f51d-4c88-bd16-46c25ec6050e","name":"Client List","originalRequest":{"method":"GET","header":[],"url":"https://app.pagalocard.com/integration/clients/listClients/{token}"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"data\": [\r\n {\r\n \"id\": 1,\r\n \"id_empresa\": 70,\r\n \"nombre\": \"Osman\",\r\n \"apellido\": \"Cruz\",\r\n \"email\": \"ocruz@jupi.tech\",\r\n \"direccion\": \"11av 5-31 zona 12\",\r\n \"direccion_random\": \"\",\r\n \"pais\": \"GT\",\r\n \"ciudad\": \"Guatemala\",\r\n \"estado\": 1,\r\n \"created_at\": \"2017-12-11 14:19:22\",\r\n \"telefono\": \"57173629\",\r\n \"idenEmpresa\": \"C865926861\",\r\n \"state\": \"0\",\r\n \"postalcode\": \"0\",\r\n \"tipoCliente\": \"CY\",\r\n \"nit\": \"0\",\r\n \"codigo_cliente\": null,\r\n \"empresa\": {\r\n \"id\": 70,\r\n \"id_user\": 145,\r\n \"nombre\": \"IGLESIA CASA DE DIOS\",\r\n \"id_categoria\": 3,\r\n \"ubicacion\": \"KILOMETRO 15.5 CARRETERA AL SALVADOR EDIFICIO CONDADO NIVEL 3 DEPTO. C Zona: 7\",\r\n \"pais\": \"GT\",\r\n \"web\": \"www.google.com\",\r\n \"ticket\": 0,\r\n \"ventames\": 5466,\r\n \"id_plataforma\": \"1\",\r\n \"id_plan\": 10,\r\n \"fecha_suscripcion\": null,\r\n \"estado\": 1,\r\n \"created_at\": \"2020-01-16 17:00:37\",\r\n \"id_lenguaje\": 0,\r\n \"pos\": 0,\r\n \"id_tipo\": 1,\r\n \"trans_min\": 213213,\r\n \"trans_max\": 999999.99,\r\n \"telefono_empresa\": \"51231313\",\r\n \"identidad_empresa\": \"C865926861\",\r\n \"moneda\": \"GTQ\",\r\n \"estado_produccion\": \"test\",\r\n \"logo\": \"\",\r\n \"llave\": \"PA\",\r\n \"url_short\": \"http://pagalo.test/t/PatitoSA\",\r\n \"slug\": \"ComicPatitoSA\",\r\n \"email_emisor\": null,\r\n \"pcuo\": \"0\",\r\n \"max_cuota\": \"12\",\r\n \"monto_min_pcuo\": 200,\r\n \"mod_monto_pcuo\": 0,\r\n \"nit\": \"87335565\",\r\n \"direccionValida\": \"KILOMETRO 15.5 CARRETERA AL SALVADOR EDIFICIO CONDADO NIVEL 3 DEPTO. C Zona: 7\",\r\n \"nombreValido\": \"Pegamorteros de Guatemala\",\r\n \"id_user_exter\": 0,\r\n \"firma\": \"iVBORw0KGgoAAAA...ErkJggg==\",\r\n \"cod_referido\": null,\r\n \"id_distribuidor\": 0,\r\n \"codigo_distribuidor\": \"REGEXPRESS\",\r\n \"abastecedor\": 0,\r\n \"id_pd\": 0,\r\n \"meta_ventas_gtq\": 0,\r\n \"meta_ventas_usd\": 0,\r\n \"meta_clientes\": 0,\r\n \"id_asesor\": null,\r\n \"id_usuario_activador\": null,\r\n \"act_facturacion\": 0,\r\n \"act_voucher\": 1,\r\n \"acept_terminos\": 0,\r\n \"activo\": 1\r\n }\r\n },\r\n {\r\n \"id\": 10,\r\n \"id_empresa\": 70,\r\n \"nombre\": \"GUSTAVO ALVARADO\",\r\n \"apellido\": \"GUSTAVO ALVARADO\",\r\n \"email\": \"\",\r\n \"direccion\": \"6A. AVE. 9-18 ZONA 10 EDIFICIO SIXTINO II 7MO. NIVEL 702 ALA II\",\r\n \"direccion_random\": \" \",\r\n \"pais\": \"GT\",\r\n \"ciudad\": \"Guatemala\",\r\n \"estado\": 1,\r\n \"created_at\": \"2017-12-21 14:34:12\",\r\n \"telefono\": \"47680247\",\r\n \"idenEmpresa\": \"C865926861\",\r\n \"state\": \"\",\r\n \"postalcode\": \"\",\r\n \"tipoCliente\": \"CY\",\r\n \"nit\": \"1635988-7\",\r\n \"codigo_cliente\": \"5498\",\r\n \"empresa\": {\r\n \"id\": 70,\r\n \"id_user\": 145,\r\n \"nombre\": \"IGLESIA CASA DE DIOS\",\r\n \"id_categoria\": 3,\r\n \"ubicacion\": \"KILOMETRO 15.5 CARRETERA AL SALVADOR EDIFICIO CONDADO NIVEL 3 DEPTO. C Zona: 7\",\r\n \"pais\": \"GT\",\r\n \"web\": \"www.google.com\",\r\n \"ticket\": 0,\r\n \"ventames\": 5466,\r\n \"id_plataforma\": \"1\",\r\n \"id_plan\": 10,\r\n \"fecha_suscripcion\": null,\r\n \"estado\": 1,\r\n \"created_at\": \"2020-01-16 17:00:37\",\r\n \"id_lenguaje\": 0,\r\n \"pos\": 0,\r\n \"id_tipo\": 1,\r\n \"trans_min\": 213213,\r\n \"trans_max\": 999999.99,\r\n \"telefono_empresa\": \"51231313\",\r\n \"identidad_empresa\": \"C865926861\",\r\n \"moneda\": \"GTQ\",\r\n \"estado_produccion\": \"test\",\r\n \"logo\": \"\",\r\n \"llave\": \"PA\",\r\n \"url_short\": \"http://pagalo.test/t/PatitoSA\",\r\n \"slug\": \"ComicPatitoSA\",\r\n \"email_emisor\": null,\r\n \"pcuo\": \"0\",\r\n \"max_cuota\": \"12\",\r\n \"monto_min_pcuo\": 200,\r\n \"mod_monto_pcuo\": 0,\r\n \"nit\": \"87335565\",\r\n \"direccionValida\": \"KILOMETRO 15.5 CARRETERA AL SALVADOR EDIFICIO CONDADO NIVEL 3 DEPTO. C Zona: 7\",\r\n \"nombreValido\": \"Pegamorteros de Guatemala\",\r\n \"id_user_exter\": 0,\r\n \"firma\": \"iVBORw...ErkJggg==\",\r\n \"cod_referido\": null,\r\n \"id_distribuidor\": 0,\r\n \"codigo_distribuidor\": \"REGEXPRESS\",\r\n \"abastecedor\": 0,\r\n \"id_pd\": 0,\r\n \"meta_ventas_gtq\": 0,\r\n \"meta_ventas_usd\": 0,\r\n \"meta_clientes\": 0,\r\n \"id_asesor\": null,\r\n \"id_usuario_activador\": null,\r\n \"act_facturacion\": 0,\r\n \"act_voucher\": 1,\r\n \"acept_terminos\": 0,\r\n \"activo\": 1\r\n }\r\n },\r\n ]\r\n} "}],"_postman_id":"642a6fe4-de6e-4dc1-b1ca-bc1bb7f93de3"},{"name":"Product List","id":"65251787-e06b-403f-a596-9857245f772b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n\t\"empresa\": \"{\\\"key_secret\\\":\\\"VoDF1URodAWOZszsBCh6FN4JlVZ5jltZl8IvhnyB\\\",\\\"key_public\\\":\\\"KpWRvCTpTdZB0kqiWKfbvSQ5LLZvJQL73mg2oVPL\\\",\\\"idenEmpresa\\\":\\\"B490690943\\\"}\",\r\n \"filters\": \"{\\\"startDate\\\":\\\"2018-06-28\\\",\\\"endDate\\\":\\\"2018-06-28\\\",\\\"limitPage\\\":\\\"15\\\", \\\"page\\\":\\\"1\\\"}\"\r\n}\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"https://app.pagalocard.com/integration/products/listProducts/{token}","description":"

Description

This api return a list product

Main Parameters

Token parameters added in url

{token}

Body parameters json string

\"empresa\", value: string
\"key_public\", value: string
\"key_secret\", value: string
\"idenEmpresa\", value: string

Remark

The json has to be formed like this:

\"empresa\":\"{\"key_secret\":\"V.....lVZ5jltZl8IvhnyB\", \"key_public\":\"KpWR.....5LLZvJQL73mg2oVPL\", \"idenEmpresa\":\"B4....43\"}\"

Optional Parameters

none

\n","urlObject":{"protocol":"https","path":["integration","products","listProducts","{token}"],"host":["app","pagalocard","com"],"query":[],"variable":[]}},"response":[{"id":"4ef2ee43-d15f-4967-ae22-e41928c704c1","name":"Product List","originalRequest":{"method":"GET","header":[],"url":"https://app.pagalocard.com/integration/products/listProducts/{token}"},"code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"id\": 7037,\n \"id_empresa\": 70,\n \"nombre\": \"Yuquitas 150 g\",\n \"descripcion\": \"Yuquitas 150 g Dianas para sobear\",\n \"categoria\": 1508,\n \"precio\": 12,\n \"estado\": 1,\n \"precio_usd\": 0,\n \"stock\": 119,\n \"sku\": \"PTAJ00011\",\n \"imagen\": \"\",\n \"ac_stock\": 1,\n \"url_short\": \"https://pagaloshop.com/ComicPatitoSA?producto=7037\",\n \"hora_inicio\": null,\n \"hora_fin\": null,\n \"observaciones\": null,\n \"peso\": 0,\n \"altura\": 0,\n \"anchura\": 0,\n \"largo\": 0,\n \"imag_baner\": null,\n \"descripcion_corta\": null,\n \"imag_detalle\": null,\n \"posicion_producto\": 165,\n \"variantes\": []\n },\n {\n \"id\": 7036,\n \"id_empresa\": 70,\n \"nombre\": \"Salsa para pizza 908 g\",\n \"descripcion\": \"Salsa para pizza 908 g\",\n \"categoria\": 1508,\n \"precio\": 42,\n \"estado\": 1,\n \"precio_usd\": 0,\n \"stock\": 119,\n \"sku\": \"PTAJ00045\",\n \"imagen\": \"https://pagalocard.s3.amazonaws.com/productos/imagenes/C865926861correoMontoFijo.PNG\",\n \"ac_stock\": 1,\n \"url_short\": \"\",\n \"hora_inicio\": null,\n \"hora_fin\": null,\n \"observaciones\": null,\n \"peso\": 0,\n \"altura\": 0,\n \"anchura\": 0,\n \"largo\": 0,\n \"imag_baner\": null,\n \"descripcion_corta\": null,\n \"imag_detalle\": null,\n \"posicion_producto\": 164,\n \"variantes\": []\n }\n ]\n}"}],"_postman_id":"65251787-e06b-403f-a596-9857245f772b"}],"id":"66916041-9b86-4d4f-8b8e-378c04138d62","_postman_id":"66916041-9b86-4d4f-8b8e-378c04138d62","description":""}],"id":"f17b02b8-0416-49a0-9400-b054382ca722","description":"

Integration with third-party systems

Api Catalog

Products
\n
- List products
- New product
- Edit product
- Disable product
\n
Clients
\n
- List clients
- New client
- Edit client
- Disable client
\n
Transactions
\n
- List Transactions
- Get Transaction
\n

\n","_postman_id":"f17b02b8-0416-49a0-9400-b054382ca722"},{"name":"Response Codes","item":[],"id":"fd0f0740-3f48-419d-829d-610653ff181a","description":"

Response Codes

General information/ description of the fields

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

CODE	DESCRIPTION
Description	Description of the card
reasonCode	Error code when card is declined
requestID	Transaction ID
response_code	Approval code or REJECT
response	Description of the response
transaction_id	Validation code for the transaction
Sku_products	Arrays of the ids of the products that received the payment
time_transaction	Time of the transaction sent from the server Pagalo
Status	Description

CyberSource

CODE	DESCRIPTION
100	Approved transaction
101	Transaction rejected, one or two fields are missing in the application
102	Invalid application data
104	Transaction rejected, try again
110	Transaction not approved, try again
150	Invalid transaction, contact support
151	Time out
152	Time out. Contact support
200	Transaction rejected, contact support
201	Transaction rejected, contact support
202	Card expired or invalid card date
203	Transaction declined, tell your bank
204	Insufficient funding
205	Card reported as stolen or lost
207	Transaction declined, contact your bank
208	Card or inactive card is not authorized for transactions that are not present on the card
209	CVV not valid
210	Insufficient funds
211	CVV not valid
220	Transaction declined, try again if it persists contact support
221	Invalid transaction. Contact support
222	Transaction rejected. Contact your bank
230	Try again, system did not recognize CVV
231	Invalid card number
232	Card type not valid, try another card or contact support for details
233	Invalid transaction. Try again
234	Invalid credentials, contact support
235	Insufficient funds
236	Invalid transaction, contact support
237	Invalid transaction, contact support
238	Invalid transaction, contact support
240	Card invalid
250	Time out
251	Insufficient customer/address information
254	Invalid transaction, contact support
461	Invalid data, contact support
481	Transaction rejected possibly by several attempts, contact support for more details

EPAY

CODE	DESCRIPTION
00	Transaction approved
01	Contact your issuing bank
02	Contact your issuing bank
03	Invalid credentials, contact support
04	Contact your issuing bank
05	Contact your issuing bank. Possible visa quota without permissions from issuing bank
07	Transaction declined, hold card
12	Invalid transaction, try again
13	Insufficient funds
14	Invalid card number
15	Invalid credentials, contact support
19	Try again
25	Invalid credentials, contact support
30	Missing mandatory data to send, contact support
31	Error validating card fields
35	Card invalid
36	Invalid transaction, try again
41	Card reported as lost or stolen
43	Card reported as lost or stolen
51	Insufficient funds
54	Card expired
58	Transaction declined, please try again
61	Insufficient funds
62	Card without permissions, contact your issuing bank
65	Transaction invalid, contact support. Membership amount
78	Invalid credentials, contact support
85	Invalid transaction, try again
89	Invalid credentials, contact support
91	Issuer NOT Available - TIME OUT
96	Transaction declined, contact support

","_postman_id":"fd0f0740-3f48-419d-829d-610653ff181a"}],"id":"01d0b741-3e94-4f03-8ac3-4885e12eec80","description":"

Object

To provide detailed and concrete information in order to the affiliated business can connect and interact with all
the functions of the Pagalocard system.

\n\n\n\n\n\n\n\n\n\n\n

Español
Pagalo está formado por un webservice central y web App. El webservice central controla todo los movimientos y transacciones con métodos seguros para la empresa y los usuarios.

\n
EndPoint o URL: https://app.pagalocard.com/
\n

INTEGRATION CREDENTIALS

IdenBusiness Data sent by the PagaloCard Administrators by validating their user. To identify the IdenBusiness:
Letter+9 numbers. (e. g. c564852135).
Business Token Data sent by the PagaloCard Administrators by validating their user. To identify the Token: Letters and numbers of 20 characters.
Public and Secret Key Data sent by the PagaloCard Administrators by validating their user.

\n
(Español)
\n

IdenBusiness Data sent by the PagaloCard Administrators by validating their user. To identify the IdenBusiness:
Letter+9 numbers. (e. g. c564852135).
Business Token Data sent by the PagaloCard Administrators by validating their user. To identify the Token: Letters and numbers of 20 characters.
Public and Secret Key Data sent by the PagaloCard Administrators by validating their user.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Requisitos obligatorios
Poseer Software de Comercio Electrónico
Su sitio web debe de tener un certificado de seguridad SSL
Deben de utilizar el Algoritmo Luhn
Deben de verifica si la fecha de expiración de la tarjeta es válida
Verificar en el reporte de transacciones si todo la informacion que envia esta correcto
No guarda ningún dato sensible de la tarjeta (CVV, fecha de expiración)
El sitio web por obligacion debe tener Captcha o ReCaptcha V3 en el formulario de la tarjeta
Deben de cumplir con las 10 de reglas de OWASP

","_postman_id":"01d0b741-3e94-4f03-8ac3-4885e12eec80"}]}

Introducción

Autenticación y Seguridad

Solicitud de Transacción

Parámetros:

Ejemplo de cuerpo de solicitud:

Notas:

Descripción General

Ejemplo

Método de Solicitud: POST

Autenticación

Endpoint: {{urlApiGateway}}/v1/integration/transactions

Cuerpo de la Solicitud:

Ejemplo de Cuerpo de la Solicitud:

Respuesta:

Respuesta Exitosa:

Documentación de la API: Login API

URL Base: {{urlApiGateway}}/v1/login

Descripción

Cuerpo de la Solicitud:

Ejemplo de Cuerpo de la Solicitud:

Respuesta:

Respuesta Exitosa:

Campos de la Respuesta:

Notas Importantes:

OBJECTIVE

Description

Main Parameters

Token parameters added in url

Body parameters json string

Optional Parameters

Description

Main Parameters

Token parameters added in url

Body parameters json string

Optional Parameters

Description

Main Parameters

Token parameters added in url

Body parameters json string

Optional Parameters

Objetive

RESTFUL Methods

Description

Main Parameters

Token parameters added in url

Body parameters json string

Optional Parameters

Description

Main Parameters

Token parameters added in url

Body parameters json string

Optional Parameters

Description

Main Parameters

Token parameters added in url

Body parameters json string

Optional Parameters

Description

Main Parameters

Token parameters added in url

Body parameters json string

Optional Parameters

Description

Main Parameters

Token parameters added in url

Body parameters json string

Optional Parameters

Description

Main Parameters

Token parameters added in url

Body parameters json string

Optional Parameters

Description

Main Parameters

Token parameters added in url

Body parameters json string

Optional Parameters

Description

Main Parameters

Token parameters added in url