Karlo pay es una plataforma de pagos en línea diseñada para facilitar transacciones en distintas industrias. Permite a los clientes pagar servicios, productos, apartados y anticipos de forma digital desde sus dispositivos móviles, sin filas ni contacto físico en caja. Los clientes pueden diferir sus pagos hasta a 12 meses con cualquier tarjeta de crédito, agilizando la compra y mejorando la experiencia de usuario.
\nLa plataforma se integra con sistemas de gestión de negocio (DMS), simplificando los procesos de cobranza y mejorando la eficiencia operativa. Karlo pay también ofrece cobro domiciliado y pago en kiosco. Entre sus funciones están la validación de pago inmediata, la conciliación bancaria ágil, los certificados de seguridad y las notificaciones automáticas por WhatsApp y correo electrónico.
\nMás información en karlo.io.
\nKarlo pay is an online payment platform designed to facilitate transactions across a range of industries. It lets customers pay for services, products, layaways and advance payments digitally from their mobile devices, with no lines or physical contact at the register. Customers can defer payments for up to 12 months with any credit card, streamlining the purchase and improving the user experience.
\nThe platform integrates with dealer/business management systems (DMS), simplifying collections and improving operational efficiency. Karlo pay also offers direct-debit and kiosk payment options. Its features include immediate payment validation, fast bank reconciliation, security certificates, and automatic notifications via WhatsApp and email.
\nFor more information, visit karlo.io.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"36819201","collectionId":"7a54c1e5-c5f1-4244-98ee-2aeab2888443","publishedId":"2sBY4SNzfT","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-07-30T20:33:25.000Z"},"item":[{"name":"Auth","item":[{"name":"Login","id":"65256d1c-7527-44e8-b2d9-552e12364121","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"karlopay+ws@karlo.io\",\r\n \"password\": \"12345678\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://backend-staging.karlopay.com/api/auth/login","description":"Autentica al usuario en Karlo pay y devuelve el token necesario para el resto de las peticiones. La autenticación es de tipo Bearer.
\nParámetros
\nAuthenticates the user in Karlo pay and returns the token required for all other requests. Authentication is Bearer-type.
\nParameters
\n","urlObject":{"protocol":"https","path":["api","auth","login"],"host":["backend-staging","karlopay","com"],"query":[],"variable":[]}},"response":[{"id":"59361791-0b58-465b-946e-0df63559ff5b","name":"Login-succes","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"leonardo+ws@karlo.io\",\r\n \"password\": \"12345678\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api-stg.karlopay.com/api/auth/login"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-RateLimit-Limit","value":"500"},{"key":"X-RateLimit-Remaining","value":"493"},{"key":"Date","value":"Wed, 03 Jul 2024 19:48:28 GMT"},{"key":"X-RateLimit-Reset","value":"1720036150"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';img-src 'self' data:;object-src 'none';script-src 'self';script-src-attr 'none';style-src 'self' https: 'unsafe-inline';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"0"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"526"},{"key":"ETag","value":"W/\"20e-PBs0datyFRjwKxtWvnjkEorjTug\""},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"OK\",\n \"statusCode\": 200,\n \"description\": \"La solicitud tuvo éxito.\",\n \"outPut\": {\n \"session\": {\n \"access_token\": \"{{supabase_service_role_api_key_14cs}}\",\n \"expiresIn\": \"2024-07-04T13:48:29-06:00\"\n }\n }\n}"},{"id":"982a2841-de88-4a2d-90bf-3bdfce929144","name":"Login-wrong-password","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"leonardo+ws@karlo.io\",\r\n \"password\": \"wrong-password\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api-stg.karlopay.com/api/auth/login"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-RateLimit-Limit","value":"500"},{"key":"X-RateLimit-Remaining","value":"492"},{"key":"Date","value":"Wed, 03 Jul 2024 19:48:43 GMT"},{"key":"X-RateLimit-Reset","value":"1720036150"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';img-src 'self' data:;object-src 'none';script-src 'self';script-src-attr 'none';style-src 'self' https: 'unsafe-inline';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"0"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"166"},{"key":"ETag","value":"W/\"a6-Td49ZtLsujvWTPovA1zCG/pFZF4\""},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"OK\",\n \"statusCode\": 200,\n \"description\": \"La solicitud tuvo éxito.\",\n \"outPut\": {\n \"statusCode\": 401,\n \"message\": \"Credenciales incorrectas y/o usuario no verificado\"\n }\n}"},{"id":"d713bfdc-9126-44fe-9b59-c7a8f5bb29f7","name":"Login-wrong-email","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"leonardo+asdsadad@karlo.io\",\r\n \"password\": \"12345678\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api-stg.karlopay.com/api/auth/login"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-RateLimit-Limit","value":"500"},{"key":"X-RateLimit-Remaining","value":"499"},{"key":"Date","value":"Wed, 03 Jul 2024 19:51:41 GMT"},{"key":"X-RateLimit-Reset","value":"1720036902"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';img-src 'self' data:;object-src 'none';script-src 'self';script-src-attr 'none';style-src 'self' https: 'unsafe-inline';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"0"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"136"},{"key":"ETag","value":"W/\"88-Xx9eUTgKjCqMUtpZmtr+oV08BAQ\""},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"OK\",\n \"statusCode\": 200,\n \"description\": \"La solicitud tuvo éxito.\",\n \"outPut\": {\n \"statusCode\": 404,\n \"message\": \"No existe el usuario\"\n }\n}"},{"id":"674a13fc-5b97-46dc-bd4e-82a4321edb0e","name":"Login-bad-payload","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"password\": \"12345678\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api-stg.karlopay.com/api/auth/login"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"X-RateLimit-Limit","value":"500"},{"key":"X-RateLimit-Remaining","value":"496"},{"key":"Date","value":"Wed, 03 Jul 2024 19:56:05 GMT"},{"key":"X-RateLimit-Reset","value":"1720036902"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';img-src 'self' data:;object-src 'none';script-src 'self';script-src-attr 'none';style-src 'self' https: 'unsafe-inline';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"0"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"137"},{"key":"ETag","value":"W/\"89-GbwSMbfAzAPfWFpQi01iby7kxR4\""},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Internal Server Error\",\n \"statusCode\": 500,\n \"description\": \"Error de servidor interno\",\n \"details\": \"Bad Request\",\n \"customError\": null\n}"}],"_postman_id":"65256d1c-7527-44e8-b2d9-552e12364121"}],"id":"4fea851a-8ee7-4f81-baaa-7e602d14857d","description":"La mayoría de las peticiones a Karlo pay requieren autenticación mediante token Bearer. Este endpoint autentica al usuario con un correo y contraseña válidos y devuelve un token de acceso que deberás enviar en las peticiones posteriores.
\nMost requests to Karlo pay require authentication using a Bearer token. This endpoint authenticates the user with a valid email and password and returns an access token that must be sent on all subsequent requests.
\n","_postman_id":"4fea851a-8ee7-4f81-baaa-7e602d14857d"},{"name":"Core","item":[{"name":"Customers","item":[{"name":"Create Or Update - Complete","id":"b7a33c9e-8039-4c11-9aa5-2d8042e86c69","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_secret_0xeg}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"foreignId\": \"000000\",\r\n \"fullName\": \"Diego Madrigal\",\r\n \"phoneNumbers\": [\"9876543210\"],\r\n \"email\": \"diego+customer@karlo.io\",\r\n \"invoiceProfile\": {\r\n \"rfc\": \"XAXX010101000\",\r\n \"cfdi\": \"613\",\r\n \"taxRegime\": \"G10\",\r\n \"postalCode\": \"63915\",\r\n \"socialReason\": \"Diego Madrigal\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://backend-staging.karlopay.com/api/customer/","description":"Crea o actualiza un cliente con su perfil fiscal completo (invoiceProfile).
Parámetros
\nCreates or updates a customer with a complete tax profile (invoiceProfile).
Parameters
\n","urlObject":{"protocol":"https","path":["api","customer",""],"host":["backend-staging","karlopay","com"],"query":[],"variable":[]}},"response":[{"id":"8f88916e-31fc-4768-bb7f-a2fc8883189c","name":"Create Or Update","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"foreignId\": \"000000\",\r\n \"fullName\": \"Fulanito Perez\",\r\n \"phoneNumber\": \"9876543210\",\r\n \"email\": \"Fulanito+customer@karlo.io\",\r\n \"invoiceProfile\": {\r\n \"rfc\": \"XAXX010101000\",\r\n \"cfdi\": \"613\",\r\n \"taxRegime\": \"G10\",\r\n \"postalCode\": \"63915\",\r\n \"socialReason\": \"Luis Rangel\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{development}}/api/customer/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-RateLimit-Limit","value":"100"},{"key":"X-RateLimit-Remaining","value":"98"},{"key":"Date","value":"Mon, 04 Nov 2024 23:41:42 GMT"},{"key":"X-RateLimit-Reset","value":"1730763754"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';img-src 'self' data:;object-src 'none';script-src 'self';script-src-attr 'none';style-src 'self' https: 'unsafe-inline';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"0"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"182"},{"key":"ETag","value":"W/\"b6-2T2+m+xbh2y2e+namgtL3TfEkrI\""},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"OK\",\n \"statusCode\": 200,\n \"description\": \"La solicitud tuvo éxito.\",\n \"outPut\": {\n \"customerId\": 2033,\n \"foreignId\": \"000000\",\n \"fullName\": \"Fulanito Perez\",\n \"clabe\": \"646180294800120348\"\n }\n}"}],"_postman_id":"b7a33c9e-8039-4c11-9aa5-2d8042e86c69"},{"name":"Create Or Update - No tax data","id":"cafb15a1-7494-4b93-8ac6-77df40e11cee","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_secret_0xeg}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"foreignId\": \"000000\",\r\n \"fullName\": \"Diego Madrigal\",\r\n \"phoneNumbers\": [\"9876543210\"],\r\n \"email\": \"diego+customer@karlo.io\",\r\n \"invoiceProfile\": null\r\n}","options":{"raw":{"language":"json"}}},"url":"https://backend-staging.karlopay.com/api/customer/","description":"Crea o actualiza un cliente sin perfil fiscal: invoiceProfile se envía como null.
Parámetros
\nCreates or updates a customer without a tax profile: invoiceProfile is sent as null.
Parameters
\n","urlObject":{"protocol":"https","path":["api","customer",""],"host":["backend-staging","karlopay","com"],"query":[],"variable":[]}},"response":[{"id":"3829a5d9-1f92-4c74-889f-a83559f314ff","name":"Create Or Update - Sin datos fiscales","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"foreignId\": \"000000\",\r\n \"fullName\": \"Fulanito Perez\",\r\n \"phoneNumber\": \"9876543210\",\r\n \"email\": \"Fulanito+customer@karlo.io\",\r\n \"invoiceProfile\": null\r\n}","options":{"raw":{"language":"json"}}},"url":"{{development}}/api/customer/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-RateLimit-Limit","value":"100"},{"key":"X-RateLimit-Remaining","value":"99"},{"key":"Date","value":"Mon, 04 Nov 2024 23:42:39 GMT"},{"key":"X-RateLimit-Reset","value":"1730763820"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';img-src 'self' data:;object-src 'none';script-src 'self';script-src-attr 'none';style-src 'self' https: 'unsafe-inline';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"0"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"182"},{"key":"ETag","value":"W/\"b6-2T2+m+xbh2y2e+namgtL3TfEkrI\""},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"OK\",\n \"statusCode\": 200,\n \"description\": \"La solicitud tuvo éxito.\",\n \"outPut\": {\n \"customerId\": 2033,\n \"foreignId\": \"000000\",\n \"fullName\": \"Fulanito Perez\",\n \"clabe\": \"646180294800120348\"\n }\n}"}],"_postman_id":"cafb15a1-7494-4b93-8ac6-77df40e11cee"}],"id":"1487f694-efb6-4104-898b-0df43736e1ff","description":"El endpoint /api/customer/ de Karlo pay permite crear y actualizar clientes con la misma llamada: si el cliente ya existe, se actualizan sus datos; si no existe, se crea.
Como se mencionó, hay dos formas de registrar la información del cliente de manera independiente al alta tradicional que ocurre al crear la orden.
\nThe Karlo pay /api/customer/ endpoint lets you create and update customers with a single call: if the customer already exists, its data is updated; if not, it is created.
As noted above, there are two ways to register customer information independently of the traditional flow that happens when an order is created.
\n","_postman_id":"1487f694-efb6-4104-898b-0df43736e1ff"},{"name":"Orders","item":[{"name":"Create or Update - Sending only foreignId","id":"15f7a37f-698a-49e9-bf1e-429b2fbe2ff2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_secret_0xeg}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"businessArea\": \"servicio\",\r\n \"numberOfOrder\": \"test01\",\r\n \"status\": \"R\",\r\n \"total\": 5000,\r\n \"adviserName\": \"Asesor de pruebas\",\r\n \"adviserEmail\": \"asesor@karlo.io\",\r\n \"adviserPhoneNumber\": \"3312345678\",\r\n \"customer\": {\r\n \"foreignId\": \"950621\"\r\n },\r\n \"operations\": null,\r\n \"product\": null,\r\n \"redirectUrl\": null\r\n}","options":{"raw":{"language":"json"}}},"url":"https://backend-staging.karlopay.com/api/orders/create-or-update","description":"Crea o actualiza una orden enviando solo el identificador del cliente (customer.foreignId), que ya debe existir en Karlo pay. No incluye operaciones ni información de producto.
Parámetros
\nCreates or updates an order by sending only the customer identifier (customer.foreignId), which must already exist in Karlo pay. It includes neither operations nor product information.
Parameters
\n","urlObject":{"protocol":"https","path":["api","orders","create-or-update"],"host":["backend-staging","karlopay","com"],"query":[],"variable":[]}},"response":[{"id":"39a2555e-dc98-4a5c-81b0-b7a25b89b6a1","name":"Create or Update - Simple Order","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"businessArea\": \"servicio\",\r\n \"numberOfOrder\": \"test01\",\r\n \"status\": \"R\",\r\n \"total\": 5000,\r\n \"customer\": {\r\n \"foreignId\": \"950621\"\r\n },\r\n \"operations\": null,\r\n \"product\": null\r\n}","options":{"raw":{"language":"json"}}},"url":"{{developmentTwo}}/api/orders/create-or-update"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-RateLimit-Limit","value":"500"},{"key":"X-RateLimit-Remaining","value":"499"},{"key":"Date","value":"Mon, 04 Nov 2024 23:32:56 GMT"},{"key":"X-RateLimit-Reset","value":"1730763777"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';img-src 'self' data:;object-src 'none';script-src 'self';script-src-attr 'none';style-src 'self' https: 'unsafe-inline';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"0"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"165"},{"key":"ETag","value":"W/\"a5-BPkjxAKWwybvCGB4u9d9trmgw8U\""},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"numericalReference\": \"041124\",\n \"paymentConcept\": 5000,\n \"clabe\": \"646180294800104652\",\n \"total\": \"$5,000.00\",\n \"bank\": \"STP\",\n \"beneficiaryAccount\": \"Karlo Solutions SAPI DE CV\"\n}"}],"_postman_id":"15f7a37f-698a-49e9-bf1e-429b2fbe2ff2"},{"name":"Create or Update - With customer creation","id":"4b0e58e5-500b-44ea-995b-e86063a43101","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_secret_0ttl}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"businessArea\": \"ventas\",\r\n \"numberOfOrder\": \"p-20240627-02\",\r\n \"status\": \"C\",\r\n \"total\": 5000,\r\n \"adviserName\": \"Asesor de pruebas\",\r\n \"adviserEmail\": \"asesor@karlo.io\",\r\n \"adviserPhoneNumber\": \"3312345678\",\r\n \"customer\": {\r\n \"foreignId\": \"950621\",\r\n \"fullName\": \"Diego Madrigal\",\r\n \"phoneNumbers\": [\r\n \"9876543210\"\r\n ],\r\n \"email\": \"diego+customer@karlo.io\",\r\n \"invoiceProfile\": null\r\n },\r\n \"operations\": null,\r\n \"product\": null,\r\n \"redirectUrl\": null\r\n}","options":{"raw":{"language":"json"}}},"url":"https://backend-staging.karlopay.com/api/orders/create-or-update","description":"Crea o actualiza una orden incluyendo la información del cliente, pero sin datos fiscales, de operaciones ni de producto.
\nParámetros
\nCreates or updates an order including customer information, but without tax, operations or product data.
\nParameters
\n","urlObject":{"protocol":"https","path":["api","orders","create-or-update"],"host":["backend-staging","karlopay","com"],"query":[],"variable":[]}},"response":[{"id":"0adacfda-ab23-4730-9c4f-132f084c4e56","name":"Create or Update - Simple","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"businessArea\": \"servicio\",\r\n \"numberOfOrder\": \"p-20240704-02\",\r\n \"status\": \"R\",\r\n \"total\": 5000,\r\n \"customer\": {\r\n \"foreignId\": \"950621\",\r\n \"fullName\": \"Hector\",\r\n \"phoneNumber\": \"9876543210\",\r\n \"email\": \"hector+customer@karlo.io\",\r\n \"invoiceProfile\": null\r\n },\r\n \"operations\": null,\r\n \"product\": null\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api-stg.karlopay.com/api/orders/create-or-update"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-RateLimit-Limit","value":"500"},{"key":"X-RateLimit-Remaining","value":"498"},{"key":"Date","value":"Thu, 04 Jul 2024 22:55:41 GMT"},{"key":"X-RateLimit-Reset","value":"1720134158"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';img-src 'self' data:;object-src 'none';script-src 'self';script-src-attr 'none';style-src 'self' https: 'unsafe-inline';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"0"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"849"},{"key":"ETag","value":"W/\"351-QFhxZ4+XZJyDUO6kgOmefKMDlBU\""},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"OK\",\n \"statusCode\": 200,\n \"description\": \"La solicitud tuvo éxito.\",\n \"outPut\": {\n \"createdAt\": \"2024-07-04T16:55:44\",\n \"updatedAt\": \"2024-07-04T16:55:45\",\n \"id\": 3800,\n \"businessId\": 27,\n \"adviserId\": null,\n \"customerId\": 464,\n \"catalogBusinessAreaId\": null,\n \"adviserName\": null,\n \"adviserPhoneNumber\": null,\n \"adviserEmail\": null,\n \"numberOfOrder\": \"P-20240704-02\",\n \"status\": \"remission\",\n \"subTotal\": 4310.34,\n \"iva\": 689.65,\n \"total\": 5000,\n \"hasProvisionalPayment\": false,\n \"additional\": null,\n \"invoiceDate\": null,\n \"invoiceNumber\": null,\n \"urlPayment\": \"short.karlo.io/get?id=dde416e3-70e0-419c-9869-0c2023cdb53f\",\n \"redirectUrl\": null,\n \"createdDate\": \"2024-07-04T22:55:41.000Z\",\n \"fromCreated\": \"ws\",\n \"isClosedInDMS\": true,\n \"serialNumber\": \"\",\n \"product\": null,\n \"businessArea\": \"servicio\",\n \"fileName\": null,\n \"typeOrder\": null,\n \"urlFile\": null,\n \"paymentedAt\": null,\n \"deletedAt\": null,\n \"invoiceReason\": null,\n \"subStatus\": null\n }\n}"}],"_postman_id":"4b0e58e5-500b-44ea-995b-e86063a43101"},{"name":"Create or Update - With customer and tax information","id":"4b9da180-bf11-42ed-8047-bf133f57ca81","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_secret_0mal}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"businessArea\": \"servicio\",\r\n \"numberOfOrder\": \"p-20240627-04\",\r\n \"status\": \"R\",\r\n \"total\": 5000,\r\n \"adviserName\": \"Asesor de pruebas\",\r\n \"adviserEmail\": \"asesor@karlo.io\",\r\n \"adviserPhoneNumber\": \"3312345678\",\r\n \"customer\": {\r\n \"foreignId\": \"950621\",\r\n \"fullName\": \"Diego Madrigal\",\r\n \"phoneNumbers\": [\r\n \"9876543210\"\r\n ],\r\n \"email\": \"diego+customer@karlo.io\",\r\n \"invoiceProfile\": {\r\n \"rfc\": \"\",\r\n \"cfdi\": \"\",\r\n \"taxRegime\": \"\",\r\n \"postalCode\": \"\",\r\n \"socialReason\": \"\"\r\n }\r\n },\r\n \"operations\": null,\r\n \"product\": null,\r\n \"redirectUrl\": null\r\n}","options":{"raw":{"language":"json"}}},"url":"https://backend-staging.karlopay.com/api/orders/create-or-update","description":"Crea o actualiza una orden incluyendo la información del cliente y sus datos fiscales, pero sin operaciones ni información de producto.
\nParámetros
\nCreates or updates an order including customer information and tax data, but without operations or product information.
\nParameters
\n","urlObject":{"protocol":"https","path":["api","orders","create-or-update"],"host":["backend-staging","karlopay","com"],"query":[],"variable":[]}},"response":[{"id":"274d3ffd-d2ab-4ae7-b2b0-3d72b42c6e26","name":"Create or Update - With Invoice Profile","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"businessArea\": \"servicio\",\r\n \"numberOfOrder\": \"p-20240627-04\",\r\n \"status\": \"R\",\r\n \"total\": 5000,\r\n \"customer\": {\r\n \"foreignId\": \"950621\",\r\n \"fullName\": \"Leonardo\",\r\n \"phoneNumber\": \"9876543210\",\r\n \"email\": \"leonardo+customer@karlo.io\",\r\n \"invoiceProfile\": {\r\n \"rfc\": \"\",\r\n \"cfdi\": \"\",\r\n \"taxRegime\": \"\",\r\n \"postalCode\": \"\",\r\n \"socialReason\": \"\"\r\n }\r\n },\r\n \"operations\": null,\r\n \"product\": null\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api-stg.karlopay.com/api/orders/create-or-update"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-RateLimit-Limit","value":"500"},{"key":"X-RateLimit-Remaining","value":"495"},{"key":"Date","value":"Thu, 04 Jul 2024 22:57:00 GMT"},{"key":"X-RateLimit-Reset","value":"1720134158"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Security-Policy","value":"default-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';img-src 'self' data:;object-src 'none';script-src 'self';script-src-attr 'none';style-src 'self' https: 'unsafe-inline';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"0"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"851"},{"key":"ETag","value":"W/\"353-MfUBITGbPZsLLh9E4ObMHolzUTQ\""},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"OK\",\n \"statusCode\": 200,\n \"description\": \"La solicitud tuvo éxito.\",\n \"outPut\": {\n \"createdAt\": \"2024-06-27T10:23:38\",\n \"updatedAt\": \"2024-07-04T16:57:04\",\n \"id\": 3629,\n \"businessId\": 27,\n \"adviserId\": null,\n \"customerId\": 464,\n \"catalogBusinessAreaId\": null,\n \"adviserName\": null,\n \"adviserPhoneNumber\": null,\n \"adviserEmail\": null,\n \"numberOfOrder\": \"P-20240627-04\",\n \"typeOrder\": null,\n \"status\": \"remission\",\n \"subTotal\": 4310.34,\n \"iva\": 689.65,\n \"total\": 5000,\n \"hasProvisionalPayment\": false,\n \"additional\": null,\n \"invoiceDate\": null,\n \"invoiceNumber\": null,\n \"urlPayment\": \"short.karlo.io/get?id=37b8155e-4a6d-48d6-a5df-04e0964cd6d5\",\n \"urlFile\": null,\n \"redirectUrl\": null,\n \"createdDate\": \"2024-07-04T22:57:01.000Z\",\n \"paymentedAt\": null,\n \"deletedAt\": null,\n \"fromCreated\": \"ws\",\n \"invoiceReason\": null,\n \"isClosedInDMS\": true,\n \"product\": null,\n \"serialNumber\": null,\n \"businessArea\": \"servicio\",\n \"fileName\": null,\n \"subStatus\": null\n }\n}"}],"_postman_id":"4b9da180-bf11-42ed-8047-bf133f57ca81"},{"name":"Create or Update - Complete customer information including operations","id":"c423dafc-080c-414b-9a15-1da558074c9e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_secret_0mal}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"businessArea\": \"servicio\",\r\n \"numberOfOrder\": \"p-20240627-06\",\r\n \"status\": \"R\",\r\n \"total\": 5000,\r\n \"adviserName\": \"Asesor de pruebas\",\r\n \"adviserEmail\": \"asesor@karlo.io\",\r\n \"adviserPhoneNumber\": \"3312345678\",\r\n \"customer\": {\r\n \"foreignId\": \"950621\",\r\n \"fullName\": \"Diego Madrigal\",\r\n \"phoneNumbers\": [\r\n \"9876543210\"\r\n ],\r\n \"email\": \"diego+customer@karlo.io\",\r\n \"invoiceProfile\": {\r\n \"rfc\": \"\",\r\n \"cfdi\": \"\",\r\n \"taxRegime\": \"\",\r\n \"postalCode\": \"\",\r\n \"socialReason\": \"\"\r\n }\r\n },\r\n \"operations\": [\r\n {\r\n \"description\": \"Pago de membresia\",\r\n \"quantity\": 1.0,\r\n \"price\": 5000\r\n }\r\n ],\r\n \"product\": null\r\n}","options":{"raw":{"language":"json"}}},"url":"https://backend-staging.karlopay.com/api/orders/create-or-update","description":"Crea o actualiza una orden incluyendo los datos fiscales del cliente y las operaciones.
\nLas operaciones se reciben en un arreglo de n elementos, cada uno con este formato:
\n[\n {\n \"description\": \"Pago de membresía\", // Descripción breve de la operación\n \"quantity\": 3, // Cantidad de unidades\n \"price\": 5000 // Precio unitario\n }\n]\nCreates or updates an order including the customer's tax data and the operations.
\nOperations are received as an array of n elements, each with this format:
\n[\n {\n \"description\": \"Membership payment\", // Short description of the operation\n \"quantity\": 3, // Number of units\n \"price\": 5000 // Unit price\n }\n]\nCrea o actualiza una orden incluyendo los datos fiscales del cliente, las operaciones y los datos del producto.
\nEl objeto product es de llaves libres, por lo que se acepta cualquier llave (por ejemplo: model, brand, year, vin, etc.).
Creates or updates an order including the customer's tax data, the operations, and the product data.
\nThe product object uses free-form keys, so any key is accepted (for example: model, brand, year, vin, etc.).
Versión por lotes de la orden completa: el payload es un arreglo de órdenes, cada una con la misma estructura que Create or Update - Complete (datos fiscales del cliente, operaciones y producto).
\nEndpoint: /api/orders/create-or-update-bulk.
Bulk version of the complete order: the payload is an array of orders, each with the same structure as Create or Update - Complete (customer tax data, operations, and product).
\nEndpoint: /api/orders/create-or-update-bulk.
Karlo pay permite crear y actualizar órdenes con el mismo endpoint: si la orden ya existe, se actualiza; si no, se crea.
\nSegún el caso, el payload puede incluir o no:
\nEstados válidos de una orden (status)
Karlo pay lets you create and update orders through the same endpoint: if the order already exists, it is updated; if not, it is created.
\nDepending on the case, the payload may or may not include:
\nValid order states (status)
Envía a Karlo pay la factura correspondiente a una orden de servicio, una vez pagada y notificada al DMS.
\nParámetros
\nSends Karlo pay the invoice for a service order, once it has been paid and notified to the DMS.
\nParameters
\n","urlObject":{"protocol":"https","path":["api","web-service","send-invoice"],"host":["backend-staging","karlopay","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"bcfbd40a-fbfb-4cff-86a1-3ca026c9807c"},{"name":"Send error in invoices","id":"cbb12aa2-5c56-4220-8f96-5e0614e8af14","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"numberOfOrder\": \"5937\",\r\n \"invoiceNumber\": null,\r\n \"invoiceDate\": null,\r\n \"messageError\": \"Uso de CFDI no permitido, para este regimen fiscal\",\r\n \"pdfBase64\": null\r\n}","options":{"raw":{"language":"json"}}},"url":"https://backend-staging.karlopay.com/api/web-service/send-invoice","description":"Variante de error del envío de factura (mismo endpoint send-invoice). Cuando la facturación falla, el DMS envía messageError con la causa y deja en null los archivos y datos de la factura.
Parámetros
\nError variant of the invoice submission (same send-invoice endpoint). When invoicing fails, the DMS sends messageError with the reason and leaves the invoice files and data as null.
Parameters
\n","urlObject":{"protocol":"https","path":["api","web-service","send-invoice"],"host":["backend-staging","karlopay","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"cbb12aa2-5c56-4220-8f96-5e0614e8af14"}],"id":"9ae922b5-d90f-403d-b08f-6a3922a07ba3","description":"En esta carpeta están los web services del proceso de integración entre el DMS y Karlo pay.
\nFuncionalidad principal: permitir que el DMS envíe a Karlo pay la información de la factura correspondiente a una orden de servicio.
\nManejo de errores: si el proceso falla, el DMS debe enviar un mensaje de error estructurado para su registro y diagnóstico.
\nThis folder contains the web services for the integration process between the DMS and Karlo pay.
\nMain functionality: allow the DMS to send Karlo pay the invoice information for a given service order.
\nError handling: if the process fails, the DMS must send a structured error message for logging and diagnosis.
\n","_postman_id":"9ae922b5-d90f-403d-b08f-6a3922a07ba3"},{"name":"Webhook","item":[{"name":"Example of Webhook of notify payment","id":"c974b88e-da2f-476f-9853-a60cce55911a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"numberOfOrder\": \"20260391\", // Unique identifier of the service order in the DMS. -> (MANDATORY)\r\n \"cardType\": \"mastercard\", // Type of card used (visa, mastercard, amex). -> (OPTIONAL)\r\n \"paymentDate\": \"2019-07-29T18:49:49\", // Payment date and time in UTC format. -> (OPTIONAL)\r\n \"cardDC\": \"credit\", // Card category: \"debit\" or \"credit\". -> (OPTIONAL)\r\n \"bankCode\": \"012\", // Bank code according to the SAT catalog. -> (OPTIONAL)\r\n \"referenceNumber\": \"1231231231\", // Reference number of the transaction in the payment processor. -> (OPTIONAL)\r\n \"cardHolder\": \"Diego Madrigal\", // Name of the cardholder. -> (OPTIONAL)\r\n \"postalCode\": \"37129\", // Cardholder's postal code. Required only for AMEX payments. -> (OPTIONAL)\r\n \"meses\": 6, // Number of months deferred in the transaction (1 = Cash, 3, 6, 9, or 12). -> (OPTIONAL)\r\n \"paymentMethod\": \"PUE\", // Payment method, always \"PUE\" (single payment). -> (OPTIONAL)\r\n \"last4\": \"******7891\", // Visible digits of the card (BIN and/or last 4 digits). -> (OPTIONAL)\r\n \"paymentForm\": \"04\", // Payment form according to the SAT catalog: \r\n // 01 = Cash, 03 = Bank Transfer, 04 = Credit Card, 28 = Debit Card. -> (OPTIONAL)\r\n \"promotion\": true, // Indicates whether a promotion was applied to the transaction. -> (OPTIONAL)\r\n \"taxData\": { // Customer tax information (for invoicing). -> (OPTIONAL)\r\n \"socialReason\": \"\", // Customer’s legal business name. -> (OPTIONAL)\r\n \"postalCodeTax\": \"45070\", // Tax-related postal code. -> (OPTIONAL)\r\n \"rfc\": \"XAXX010101000\", // RFC (Mexican tax ID) of the customer. -> (OPTIONAL)\r\n \"taxRegimen\": \"\", // Customer’s tax regime. -> (OPTIONAL)\r\n \"cfdi\": \"S01\" // CFDI usage code (e.g., G01 = Expenses, S01 = Without tax effect). -> (OPTIONAL)\r\n },\r\n \"paymentInformation\": { // Detailed breakdown of the payment transaction. -> (OPTIONAL for card payments)\r\n \"percentageBaseComission\": 0.025, // Commission percentage for terminal usage. -> (OPTIONAL)\r\n \"percentageBaseSurcharge\": 0.0695, // Surcharge percentage for deferred payments. -> (OPTIONAL)\r\n \"commissions\": { // Detailed breakdown of the commission charged by the bank. -> (OPTIONAL)\r\n \"baseComission\": 123.42, // Base commission amount. -> (OPTIONAL)\r\n \"baseComissionIva\": 19.75, // VAT applied to the commission. -> (OPTIONAL)\r\n \"baseComissionTotal\": 143.17 // Total commission (base + VAT). -> (OPTIONAL)\r\n },\r\n \"surcharges\": { // Detailed breakdown of surcharges for deferred payments. -> (OPTIONAL)\r\n \"baseSurcharge\": 0, // Base surcharge amount. -> (OPTIONAL)\r\n \"baseSurchargeIva\": 0, // VAT applied to the surcharge. -> (OPTIONAL)\r\n \"baseSurchargeTotal\": 0 // Total surcharge (base + VAT). -> (OPTIONAL)\r\n },\r\n \"originalAmount\": 4936.88, // Original transaction amount before commissions. -> (MANDATORY)\r\n \"totalToDepositBusiness\": 4936.88, // Total amount deposited to the business. -> (MANDATORY)\r\n \"totalPayment\": 4936.88, // Total amount charged to the customer. -> (MANDATORY)\r\n \"totalCommissionForTerminalUse\": 0, // Total commission charged for using the payment terminal. -> (OPTIONAL)\r\n \"totalCommissionForDeferringToMonths\": 0, // Total commission charged for deferred payments. -> (OPTIONAL)\r\n \"totalCommissionToCustomer\": 0, // Total commission charged to the customer. -> (OPTIONAL)\r\n \"totalCommissionToBusiness\": 541.18, // Total commission charged to the business. -> (OPTIONAL)\r\n \"totalPaymentPerMonth\": 822.81 // Monthly installment amount charged to the customer (if deferred). -> (OPTIONAL)\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://your-webhook.com","description":"Ejemplo del payload que Karlo pay envía a la URL de webhook del sistema integrado al aprobarse un pago. El único campo obligatorio es numberOfOrder; el resto es opcional. Recuerda responder con HTTP 200.
\n\nNota de consistencia: este payload usa
\nmeses(español) ytaxRegimen, mientras que el resto de la API usa inglés ytaxRegime. Se documenta tal cual está en el contrato actual; no se modifica.
Campos principales
\nExample of the payload that Karlo pay sends to the integrated system's webhook URL when a payment is approved. The only mandatory field is numberOfOrder; the rest are optional. Remember to respond with HTTP 200.
\n\nConsistency note: this payload uses
\nmeses(Spanish) andtaxRegimen, whereas the rest of the API uses English andtaxRegime. It is documented exactly as it exists in the current contract; it is not modified.
Main fields
\n","urlObject":{"protocol":"https","host":["your-webhook","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"c974b88e-da2f-476f-9853-a60cce55911a"}],"id":"7b998d2e-457e-4473-b216-809f9510c4da","description":"Cuando Karlo pay recibe la aprobación de un pago por parte de la pasarela, notifica al sistema integrado mediante un webhook. El sistema integrado debe proporcionar a Karlo pay la URL del webhook, a la que se enviará la información de la transacción.
\n⚠️ Importante: el sistema integrado debe responder con HTTP 200 para confirmar la recepción. Si no se recibe un 200, Karlo pay considerará la entrega fallida y podría reintentarla.
\nWhen Karlo pay receives a payment approval from the gateway, it notifies the integrated system through a webhook. The integrated system must provide Karlo pay with the webhook URL, where the transaction information will be sent.
\n⚠️ Important: the integrated system must respond with HTTP 200 to confirm receipt. If a 200 is not returned, Karlo pay will treat the delivery as failed and may retry it.
\n","_postman_id":"7b998d2e-457e-4473-b216-809f9510c4da"}],"id":"8315f1a4-97da-42fd-9b82-0e4f1484d712","description":"En esta carpeta encontrarás los servicios necesarios para ejecutar el flujo de pago con la integración de Karlo pay: creación de clientes, órdenes de venta y el flujo de pago.
\nLa creación de clientes puede hacerse por separado o dentro del proceso de creación de la orden. Existen dos formas de crear un cliente en Karlo pay: con información fiscal y sin información fiscal.
\nAdemás, encontrarás varias formas de crear una orden de venta y el flujo de pago, para integrar la API y adaptarla por completo a tu sistema.
\nThis folder contains the services needed to run the payment flow with the Karlo pay integration: customer creation, sales orders, and the payment flow.
\nCustomers can be created separately or as part of the order-creation process. There are two ways to create a customer in Karlo pay: with tax information and without tax information.
\nYou will also find several ways to create a sales order and the payment flow, so you can integrate the API and fully adapt it to your system.
\n","_postman_id":"8315f1a4-97da-42fd-9b82-0e4f1484d712"}],"variable":[{"key":"supabase_service_role_api_key_0mal"},{"key":"auth_secret_03kx"},{"key":"auth_secret_0mal","secret":true},{"key":"auth_secret_0ttl","secret":true},{"key":"auth_secret_0xeg","secret":true},{"key":"supabase_service_role_api_key_14cs","secret":true}]}