DocumentaciónAPIDevToolsRecipesForoTarjetas de PruebasEstado del ServicioChangelog
Documentación
Iniciar Sesión

Debito Directo - Cargo bajo demanda

Suggest Edits

❗️

IMPORTANTE

Esta modalidad de Pago con Débito directo te permitirá almacenar una o varias cuentas Clabe (métodos de pago) y relacionarlas a un único cliente. Con ello podrás crear órdenes de pago cada que lo requiera tu negocio, sin necesidad de solicitar los datos del método de pago de nuevo.

Características

  • Es necesario registrar/almacenar un cliente en Conekta
  • Es necesario registrar/almacenar al menos un método de pago en Conekta (Débito directo)

Pasos para integrar

Generar autenticación de API

Para configurar los headers de tus peticiones, sigue las instrucciones de la sección “Primeros Pasos”.

Crear Cliente

Se solicita registrar la información mínima indispensable para una transacción, “nombre”, “email” , “teléfono”, "document_front" y "document_back" (para más detalle ver Referencia API). En el siguiente request se incluye un atributo extra tipo llave-valor llamado “Metadata” en el que puedes agregar información específica de tu negocio que requieras.

Request

-H "Accept: application/vnd.conekta-v2.2.0+json" \
-H "Content-type: application/json" \
-u key_YOUR_PRIVATE_API_KEY: \
-X POST -d '{
 "name": "Jorge Martínez",
 "email": "[email protected]",
 "phone": "+52181818181",
 "document_front": "JVBERi0xLjMKJZOMi54gUmVwb3J0TGFiIEdlbmVyYXRlZCBQREYgZG9jdW1lbnQgaHR0cDovL3d3dy5yZXBvcnRsYWIuY29tCjEgMCBvYmoKPDwKL0YxIDIgMCBSCj4+CmVuZG9iagoyIDAgb2JqCjw8Ci9CYXNlRm9udCAvSGVsdmV0aWNhIC9FbmNvZGluZyAvV2luQW5zaUVuY29kaW5nID4+CmVuZG9iagozIDAgb2JqCjw8Ci9UeXBlIC9QYWdlcyAvS2lkcyBbNCAwIFJdIC9Db3VudCAxCj4+CmVuZG9iago0IDAgb2JqCjw8Ci9UeXBlIC9QYWdlIC9QYXJlbnQgMyAwIFIgL01lZGlhQm94IFswIDAgNjEyIDc5Ml0gL0NvbnRlbnRzIDUgMCBSIC9SZXNvdXJjZXMgNiAwIFIgPj4KZW5kb2JqCjUgMCBvYmoKWy9QREYgL1RleHRdCmVuZG9iago2IDAgb2JqCjw8Ci9Qcm9jU2V0IFsvUERGIC9UZXh0XQovRm9udCA8PAovRjEgMiAwIFIKPj4KPj4KZW5kb2JqCjcgMCBvYmoKPDwvTGVuZ3RoIDEyMCA+PgpzdHJlYW0KQlQKL0YxIDEyIFRmCjEwMCA3OTIgVGQKSU5FIEZSRU5URSAtIEVKRU1QTE8gRklD VElDSU8KTm9tYnJlOiBKVUFOIFBFUkVaIExPUEVaCkNVUlA6IFBFUEo4MDAxMDFIREZSUk4wNApDbGF2ZSBFbGVjdG9yOiBQUkxKODAwMTAxSERGUlBOMDIKU2VjY2nDsyAxMjM0ClZpZ2VuY2lhOiAyMDMwCkVUCmVuZHN0cmVhbQplbmRvYmoKeHJlZgowIDgKMDAwMDAwMDAwMCA2NTUzNSBmIAowMDAwMDAwMDEwIDAwMDAwIG4gCjAwMDAwMDAwNjAgMDAwMDAgbiAKMDAwMDAwMDA5OSAwMDAwMCBuIAowMDAwMDAwMTk2IDAwMDAwIG4gCjAwMDAwMDAyNTYgMDAwMDAgbiAKMDAwMDAwMDM0OSAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9Sb290IDEgMCBSIC9TaXplIDggL0luZm8gOSAwIFIgPj4Kc3RhcnR4cmVmCjM2OQolJUVPRgo=",
    "document_back": "JVBERi0xLjMKJZOMi54gUmVwb3J0TGFiIEdlbmVyYXRlZCBQREYgZG9jdW1lbnQgaHR0cDovL3d3dy5yZXBvcnRsYWIuY29tCjEgMCBvYmoKPDwKL0YxIDIgMCBSCj4+CmVuZG9iagoyIDAgb2JqCjw8Ci9CYXNlRm9udCAvSGVsdmV0aWNhIC9FbmNvZGluZyAvV2luQW5zaUVuY29kaW5nID4+CmVuZG9iagozIDAgb2JqCjw8Ci9UeXBlIC9QYWdlcyAvS2lkcyBbNCAwIFJdIC9Db3VudCAxCj4+CmVuZG9iago0IDAgb2JqCjw8Ci9UeXBlIC9QYWdlIC9QYXJlbnQgMyAwIFIgL01lZGlhQm94IFswIDAgNjEyIDc5Ml0gL0NvbnRlbnRzIDUgMCBSIC9SZXNvdXJjZXMgNiAwIFIgPj4KZW5kb2JqCjUgMCBvYmoKWy9QREYgL1RleHRdCmVuZG9iago2IDAgb2JqCjw8Ci9Qcm9jU2V0IFsvUERGIC9UZXh0XQovRm9udCA8PAovRjEgMiAwIFIKPj4KPj4KZW5kb2JqCjcgMCBvYmoKPDwvTGVuZ3RoIDk0ID4+CnN0cmVhbQpCVAovRjEgMTIgVGYKMTAwIDc5MiBUZApJTkUgUkVWRVJTTyAtIEVKRU1QTE8gRklD VElDSU8KRGlyZWNjacOz bjogQ2FsbGUgRmFsc2EgMTIzLCBDb2xvbmlhIENlbnRybywgQ0RNWAplc3RhZG86IENpdWRhZCBkZSBNw61YSUNPCkNQOiAwNjAwMApFVAplbmRzdHJlYW0KZW5kb2JqCnhyZWYKMCA4CjAwMDAwMDAwMDAgNjU1MzUgZiAKMDAwMDAwMDAxMCAwMDAwMCBuIAowMDAwMDAwMDYwIDAwMDAwIG4gCjAwMDAwMDAwOTkgMDAwMDAgbiAKMDAwMDAwMDE5NiAwMDAwMCBuIAowMDAwMDAwMjU2IDAwMDAwIG4gCjAwMDAwMDAzNDkgMDAwMDAgbiAKdHJhaWxlcgo8PAovUm9vdCAxIDAgUiAvU2l6ZSA4IC9JbmZvIDkgMCBSID4+CnN0YXJ0eHJlZgowMzY5CiUlRU9GCg==",
 "metadata": {
   "business_ID": "1298-AZS",
   "random_key": "random value"
 }
}’https://api.conekta.io/customers

{
   "livemode": false,
   "name": "Jorge Martínez",
   "email": "[email protected]",
   "phone": "+52181818181",
   "id": "cus_2tTSkfScREpvaRJsE",
   "object": "customer",
   "created_at": 1677797262,
  "corporate": false,
  "document_front": "JVBERi0xLjMKJZOMi54gUmVwb3J0TGFiIEdlbmVyYXRlZCBQREYgZG9jdW1lbnQgaHR0cDovL3d3dy5yZXBvcnRsYWIuY29tCjEgMCBvYmoKPDwKL0YxIDIgMCBSCj4+CmVuZG9iagoyIDAgb2JqCjw8Ci9CYXNlRm9udCAvSGVsdmV0aWNhIC9FbmNvZGluZyAvV2luQW5zaUVuY29kaW5nID4+CmVuZG9iagozIDAgb2JqCjw8Ci9UeXBlIC9QYWdlcyAvS2lkcyBbNCAwIFJdIC9Db3VudCAxCj4+CmVuZG9iago0IDAgb2JqCjw8Ci9UeXBlIC9QYWdlIC9QYXJlbnQgMyAwIFIgL01lZGlhQm94IFswIDAgNjEyIDc5Ml0gL0NvbnRlbnRzIDUgMCBSIC9SZXNvdXJjZXMgNiAwIFIgPj4KZW5kb2JqCjUgMCBvYmoKWy9QREYgL1RleHRdCmVuZG9iago2IDAgb2JqCjw8Ci9Qcm9jU2V0IFsvUERGIC9UZXh0XQovRm9udCA8PAovRjEgMiAwIFIKPj4KPj4KZW5kb2JqCjcgMCBvYmoKPDwvTGVuZ3RoIDEyMCA+PgpzdHJlYW0KQlQKL0YxIDEyIFRmCjEwMCA3OTIgVGQKSU5FIEZSRU5URSAtIEVKRU1QTE8gRklD VElDSU8KTm9tYnJlOiBKVUFOIFBFUkVaIExPUEVaCkNVUlA6IFBFUEo4MDAxMDFIREZSUk4wNApDbGF2ZSBFbGVjdG9yOiBQUkxKODAwMTAxSERGUlBOMDIKU2VjY2nDsyAxMjM0ClZpZ2VuY2lhOiAyMDMwCkVUCmVuZHN0cmVhbQplbmRvYmoKeHJlZgowIDgKMDAwMDAwMDAwMCA2NTUzNSBmIAowMDAwMDAwMDEwIDAwMDAwIG4gCjAwMDAwMDAwNjAgMDAwMDAgbiAKMDAwMDAwMDA5OSAwMDAwMCBuIAowMDAwMDAwMTk2IDAwMDAwIG4gCjAwMDAwMDAyNTYgMDAwMDAgbiAKMDAwMDAwMDM0OSAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9Sb290IDEgMCBSIC9TaXplIDggL0luZm8gOSAwIFIgPj4Kc3RhcnR4cmVmCjM2OQolJUVPRgo=",
      "document_back": "JVBERi0xLjMKJZOMi54gUmVwb3J0TGFiIEdlbmVyYXRlZCBQREYgZG9jdW1lbnQgaHR0cDovL3d3dy5yZXBvcnRsYWIuY29tCjEgMCBvYmoKPDwKL0YxIDIgMCBSCj4+CmVuZG9iagoyIDAgb2JqCjw8Ci9CYXNlRm9udCAvSGVsdmV0aWNhIC9FbmNvZGluZyAvV2luQW5zaUVuY29kaW5nID4+CmVuZG9iagozIDAgb2JqCjw8Ci9UeXBlIC9QYWdlcyAvS2lkcyBbNCAwIFJdIC9Db3VudCAxCj4+CmVuZG9iago0IDAgb2JqCjw8Ci9UeXBlIC9QYWdlIC9QYXJlbnQgMyAwIFIgL01lZGlhQm94IFswIDAgNjEyIDc5Ml0gL0NvbnRlbnRzIDUgMCBSIC9SZXNvdXJjZXMgNiAwIFIgPj4KZW5kb2JqCjUgMCBvYmoKWy9QREYgL1RleHRdCmVuZG9iago2IDAgb2JqCjw8Ci9Qcm9jU2V0IFsvUERGIC9UZXh0XQovRm9udCA8PAovRjEgMiAwIFIKPj4KPj4KZW5kb2JqCjcgMCBvYmoKPDwvTGVuZ3RoIDk0ID4+CnN0cmVhbQpCVAovRjEgMTIgVGYKMTAwIDc5MiBUZApJTkUgUkVWRVJTTyAtIEVKRU1QTE8gRklD VElDSU8KRGlyZWNjacOz bjogQ2FsbGUgRmFsc2EgMTIzLCBDb2xvbmlhIENlbnRybywgQ0RNWAplc3RhZG86IENpdWRhZCBkZSBNw61YSUNPCkNQOiAwNjAwMApFVAplbmRzdHJlYW0KZW5kb2JqCnhyZWYKMCA4CjAwMDAwMDAwMDAgNjU1MzUgZiAKMDAwMDAwMDAxMCAwMDAwMCBuIAowMDAwMDAwMDYwIDAwMDAwIG4gCjAwMDAwMDAwOTkgMDAwMDAgbiAKMDAwMDAwMDE5NiAwMDAwMCBuIAowMDAwMDAwMjU2IDAwMDAwIG4gCjAwMDAwMDAzNDkgMDAwMDAgbiAKdHJhaWxlcgo8PAovUm9vdCAxIDAgUiAvU2l6ZSA4IC9JbmZvIDkgMCBSID4+CnN0YXJ0eHJlZgowMzY5CiUlRU9GCg==",

   "metadata": {
       "business_ID": "1298-AZS",
       "random_key": "random value"
   },
   "custom_reference": ""
}

Crear Método de Pago y asociarlo a un cliente

Request

-H "Accept: application/vnd.conekta-v2.2.0+json" \
-H "Content-type: application/json" \
-u key_YOUR_PRIVATE_API_KEY: \
-X POST -d '{
   "type": "direct_debit_recurrent",
   "clabe": "014123456789012344",
    "contract": "JVBERi0xLjQKJdPr6eEKMSAwIG9iago8PC9UaXRsZSAoY29udHJhY3QpCi9Qcm9kdWNlciAoU2tpYS9QREYgbTE0MSBHb29nbGUgRG9jcyBSZW5kZXJlcik+PgplbmRvYmoKMyAwIG9iago8PC9jYSAxCi9CTSAvTm9ybWFsPj4KZW5kb2JqCjUgMCBvYmoKPDwvRmlsdGVyIC9GbGF0ZURlY29kZQovTGVuZ3RoIDIyMT4+IHN0cmVhbQp4nJWPQWrDMBBF93OKuUBkfWmkkcF4EScNXQSaohu0TaDQRZP7QyS7QVDqRTVCGv5HT3/AttQG5dDe8dsXfZPRMKuPu4jgWq8HXprrhbqD58uNqp8QGTZEvn7QmU6/COrqLgw7S4WxNI3RvfAwdMfpeVfkcdzuJtpm6p6EISbWpZzPhBbViPYJ6nvOlbuBN07Vi0+c33mwVuLI+ZPUeJfgaphFD27Wk0EArKZmYM3Q2RBjFb0GbUb4MVKyUUJ7IbKCWg21fLHP/xo7OAMvUPwxvvUP4on2x4nuvCZjdQplbmRzdHJlYW0KZW5kb2JqCjIgMCBvYmoKPDwvVHlwZSAvUGFnZQovUmVzb3VyY2VzIDw8L1Byb2NTZXQgWy9QREYgL1RleHQgL0ltYWdlQiAvSW1hZ2VDIC9JbWFnZUldCi9FeHRHU3RhdGUgPDwvRzMgMyAwIFI+PgovRm9udCA8PC9GNCA0IDAgUj4+Pj4KL01lZGlhQm94IFswIDAgNjEyIDc5Ml0KL0NvbnRlbnRzIDUgMCBSCi9TdHJ1Y3RQYXJlbnRzIDAKL1RhYnMgL1MKL1BhcmVudCA2IDAgUj4+CmVuZG9iago2IDAgb2JqCjw8L1R5cGUgL1BhZ2VzCi9Db3VudCAxCi9LaWRzIFsyIDAgUl0+PgplbmRvYmoKOSAwIG9iago8PC9UeXBlIC9TdHJ1Y3RFbGVtCi9TIC9=="
        }
}’https://api.conekta.io/customers/cus_2tTSkfScREpvaRJsE/payment_sources/

{
   "type": "direct_debit_recurrent",
   "clabe": "014123456789012344",
   "status" : "ready_to_transactional",
   "contract": "JVBERi0xLjQKJdPr6eEKMSAwIG9iago8PC9UaXRsZSAoY29udHJhY3QpCi9Qcm9kdWNlciAoU2tpYS9QREYgbTE0MSBHb29nbGUgRG9jcyBSZW5kZXJlcik+PgplbmRvYmoKMyAwIG9iago8PC9jYSAxCi9CTSAvTm9ybWFsPj4KZW5kb2JqCjUgMCBvYmoKPDwvRmlsdGVyIC9GbGF0ZURlY29kZQovTGVuZ3RoIDIyMT4+IHN0cmVhbQp4nJWPQWrDMBBF93OKuUBkfWmkkcF4EScNXQSaohu0TaDQRZP7QyS7QVDqRTVCGv5HT3/AttQG5dDe8dsXfZPRMKuPu4jgWq8HXprrhbqD58uNqp8QGTZEvn7QmU6/COrqLgw7S4WxNI3RvfAwdMfpeVfkcdzuJtpm6p6EISbWpZzPhBbViPYJ6nvOlbuBN07Vi0+c33mwVuLI+ZPUeJfgaphFD27Wk0EArKZmYM3Q2RBjFb0GbUb4MVKyUUJ7IbKCWg21fLHP/xo7OAMvUPwxvvUP4on2x4nuvCZjdQplbmRzdHJlYW0KZW5kb2JqCjIgMCBvYmoKPDwvVHlwZSAvUGFnZQovUmVzb3VyY2VzIDw8L1Byb2NTZXQgWy9QREYgL1RleHQgL0ltYWdlQiAvSW1hZ2VDIC9JbWFnZUldCi9FeHRHU3RhdGUgPDwvRzMgMyAwIFI+PgovRm9udCA8PC9GNCA0IDAgUj4+Pj4KL01lZGlhQm94IFswIDAgNjEyIDc5Ml0KL0NvbnRlbnRzIDUgMCBSCi9TdHJ1Y3RQYXJlbnRzIDAKL1RhYnMgL1MKL1BhcmVudCA2IDAgUj4+CmVuZG9iago2IDAgb2JqCjw8L1R5cGUgL1BhZ2VzCi9Db3VudCAxCi9LaWRzIFsyIDAgUl0+PgplbmRvYmoKOSAwIG9iago8PC9UeXBlIC9TdHJ1Y3RFbGVtCi9TIC9=="
}

👍

TIP

Puedes crear directamente el cliente con su método de pago en 1 solo paso.


Request

-H "Accept: application/vnd.conekta-v2.2.0+json" \
-H "Content-type: application/json" \
-u key_YOUR_PRIVATE_API_KEY: \
-X POST -d '{
 "name": "Jorge Martínez",
 "email": "[email protected]",
 "phone": "+52181818181",
 "document_front": "JVBERi0xLjMKJZOMi54gUmVwb3J0TGFiIEdlbmVyYXRlZCBQREYgZG9jdW1lbnQgaHR0cDovL3d3dy5yZXBvcnRsYWIuY29tCjEgMCBvYmoKPDwKL0YxIDIgMCBSCj4+CmVuZG9iagoyIDAgb2JqCjw8Ci9CYXNlRm9udCAvSGVsdmV0aWNhIC9FbmNvZGluZyAvV2luQW5zaUVuY29kaW5nID4+CmVuZG9iagozIDAgb2JqCjw8Ci9UeXBlIC9QYWdlcyAvS2lkcyBbNCAwIFJdIC9Db3VudCAxCj4+CmVuZG9iago0IDAgb2JqCjw8Ci9UeXBlIC9QYWdlIC9QYXJlbnQgMyAwIFIgL01lZGlhQm94IFswIDAgNjEyIDc5Ml0gL0NvbnRlbnRzIDUgMCBSIC9SZXNvdXJjZXMgNiAwIFIgPj4KZW5kb2JqCjUgMCBvYmoKWy9QREYgL1RleHRdCmVuZG9iago2IDAgb2JqCjw8Ci9Qcm9jU2V0IFsvUERGIC9UZXh0XQovRm9udCA8PAovRjEgMiAwIFIKPj4KPj4KZW5kb2JqCjcgMCBvYmoKPDwvTGVuZ3RoIDEyMCA+PgpzdHJlYW0KQlQKL0YxIDEyIFRmCjEwMCA3OTIgVGQKSU5FIEZSRU5URSAtIEVKRU1QTE8gRklD VElDSU8KTm9tYnJlOiBKVUFOIFBFUkVaIExPUEVaCkNVUlA6IFBFUEo4MDAxMDFIREZSUk4wNApDbGF2ZSBFbGVjdG9yOiBQUkxKODAwMTAxSERGUlBOMDIKU2VjY2nDsyAxMjM0ClZpZ2VuY2lhOiAyMDMwCkVUCmVuZHN0cmVhbQplbmRvYmoKeHJlZgowIDgKMDAwMDAwMDAwMCA2NTUzNSBmIAowMDAwMDAwMDEwIDAwMDAwIG4gCjAwMDAwMDAwNjAgMDAwMDAgbiAKMDAwMDAwMDA5OSAwMDAwMCBuIAowMDAwMDAwMTk2IDAwMDAwIG4gCjAwMDAwMDAyNTYgMDAwMDAgbiAKMDAwMDAwMDM0OSAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9Sb290IDEgMCBSIC9TaXplIDggL0luZm8gOSAwIFIgPj4Kc3RhcnR4cmVmCjM2OQolJUVPRgo=",
    "document_back": "JVBERi0xLjMKJZOMi54gUmVwb3J0TGFiIEdlbmVyYXRlZCBQREYgZG9jdW1lbnQgaHR0cDovL3d3dy5yZXBvcnRsYWIuY29tCjEgMCBvYmoKPDwKL0YxIDIgMCBSCj4+CmVuZG9iagoyIDAgb2JqCjw8Ci9CYXNlRm9udCAvSGVsdmV0aWNhIC9FbmNvZGluZyAvV2luQW5zaUVuY29kaW5nID4+CmVuZG9iagozIDAgb2JqCjw8Ci9UeXBlIC9QYWdlcyAvS2lkcyBbNCAwIFJdIC9Db3VudCAxCj4+CmVuZG9iago0IDAgb2JqCjw8Ci9UeXBlIC9QYWdlIC9QYXJlbnQgMyAwIFIgL01lZGlhQm94IFswIDAgNjEyIDc5Ml0gL0NvbnRlbnRzIDUgMCBSIC9SZXNvdXJjZXMgNiAwIFIgPj4KZW5kb2JqCjUgMCBvYmoKWy9QREYgL1RleHRdCmVuZG9iago2IDAgb2JqCjw8Ci9Qcm9jU2V0IFsvUERGIC9UZXh0XQovRm9udCA8PAovRjEgMiAwIFIKPj4KPj4KZW5kb2JqCjcgMCBvYmoKPDwvTGVuZ3RoIDk0ID4+CnN0cmVhbQpCVAovRjEgMTIgVGYKMTAwIDc5MiBUZApJTkUgUkVWRVJTTyAtIEVKRU1QTE8gRklD VElDSU8KRGlyZWNjacOz bjogQ2FsbGUgRmFsc2EgMTIzLCBDb2xvbmlhIENlbnRybywgQ0RNWAplc3RhZG86IENpdWRhZCBkZSBNw61YSUNPCkNQOiAwNjAwMApFVAplbmRzdHJlYW0KZW5kb2JqCnhyZWYKMCA4CjAwMDAwMDAwMDAgNjU1MzUgZiAKMDAwMDAwMDAxMCAwMDAwMCBuIAowMDAwMDAwMDYwIDAwMDAwIG4gCjAwMDAwMDAwOTkgMDAwMDAgbiAKMDAwMDAwMDE5NiAwMDAwMCBuIAowMDAwMDAwMjU2IDAwMDAwIG4gCjAwMDAwMDAzNDkgMDAwMDAgbiAKdHJhaWxlcgo8PAovUm9vdCAxIDAgUiAvU2l6ZSA4IC9JbmZvIDkgMCBSID4+CnN0YXJ0eHJlZgowMzY5CiUlRU9GCg==",
 "metadata": {
   "business_ID": "1298-AZS",
   "random_key": "random value"
 }
"payment_sources":[{
   "type": "direct_debit_recurrent",
   "clabe": "014123456789012344",
    "contract": "JVBERi0xLjQKJdPr6eEKMSAwIG9iago8PC9UaXRsZSAoY29udHJhY3QpCi9Qcm9kdWNlciAoU2tpYS9QREYgbTE0MSBHb29nbGUgRG9jcyBSZW5kZXJlcik+PgplbmRvYmoKMyAwIG9iago8PC9jYSAxCi9CTSAvTm9ybWFsPj4KZW5kb2JqCjUgMCBvYmoKPDwvRmlsdGVyIC9GbGF0ZURlY29kZQovTGVuZ3RoIDIyMT4+IHN0cmVhbQp4nJWPQWrDMBBF93OKuUBkfWmkkcF4EScNXQSaohu0TaDQRZP7QyS7QVDqRTVCGv5HT3/AttQG5dDe8dsXfZPRMKuPu4jgWq8HXprrhbqD58uNqp8QGTZEvn7QmU6/COrqLgw7S4WxNI3RvfAwdMfpeVfkcdzuJtpm6p6EISbWpZzPhBbViPYJ6nvOlbuBN07Vi0+c33mwVuLI+ZPUeJfgaphFD27Wk0EArKZmYM3Q2RBjFb0GbUb4MVKyUUJ7IbKCWg21fLHP/xo7OAMvUPwxvvUP4on2x4nuvCZjdQplbmRzdHJlYW0KZW5kb2JqCjIgMCBvYmoKPDwvVHlwZSAvUGFnZQovUmVzb3VyY2VzIDw8L1Byb2NTZXQgWy9QREYgL1RleHQgL0ltYWdlQiAvSW1hZ2VDIC9JbWFnZUldCi9FeHRHU3RhdGUgPDwvRzMgMyAwIFI+PgovRm9udCA8PC9GNCA0IDAgUj4+Pj4KL01lZGlhQm94IFswIDAgNjEyIDc5Ml0KL0NvbnRlbnRzIDUgMCBSCi9TdHJ1Y3RQYXJlbnRzIDAKL1RhYnMgL1MKL1BhcmVudCA2IDAgUj4+CmVuZG9iago2IDAgb2JqCjw8L1R5cGUgL1BhZ2VzCi9Db3VudCAxCi9LaWRzIFsyIDAgUl0+PgplbmRvYmoKOSAwIG9iago8PC9UeXBlIC9TdHJ1Y3RFbGVtCi9TIC9=="
 }]
}’https://api.conekta.io/customers

{
   "livemode": false,
   "name": "Jorge Martínez",
   "email": "[email protected]",
   "phone": "+52181818181",
   "id": "cus_2tTU5GdkwZvBmS3fN",
   "object": "customer",
   "created_at": 1677803280,
   "corporate": false,
   "metadata": {
       "business_ID": "1298-AZS",
       "random_key": "random value"
   },
   "custom_reference": "",
   "default_payment_source_id": "src_2tTU5GdkwZvBmS3fT",
   "payment_sources": {
       "object": "list",
       "has_more": false,
       "data": [
           {
               "id": "src_2tTU5GdkwZvBmS3fT",
               "object": "payment_source",
               "type": "direct_debit_recurrent",
               "clabe": "014123456789012344",
               "status" : "ready_to_transactional",
               "parent_id": "cus_2tTU5GdkwZvBmS3fN"
           }
       ]
   }
}

Crear orden de pago

La orden requiere de cierta información que obtiene ya sea de algún servicio interno del negocio, o directamente del FrontEnd al solicitarla al usuario/cliente final. Los datos principales traducidos a atributos del request son:

  • ¿Quién está pagando? -> Customer
  • ¿Qué está pagando? -> Line_items
  • ¿Cuánto está pagando? -> Unit_pice multiplicado por Quantity
  • ¿Cuál es el método de pago? -> Payment_method

Request

-H "Accept: application/vnd.conekta-v2.2.0+json" \
-H "Content-type: application/json" \
-u key_YOUR_PRIVATE_API_KEY: \
-X POST -d '{
    "currency": "MXN",
    "customer_info": {
        "customer_id": "cus_2tTU5GdkwZvBmS3fN"
     },
    "line_items": [
      {
        "name": "Vasija de Cerámica",
        "unit_price": 20015,
        "quantity": 1,
        "description": "Description",
        "sku": "SKU",
        "charges":[{
            "payment_method": {
               "type": "direct_debit",
               "payment_source_id": "src_2qUCNd5AyQqfPMBuV"
            }
      }]
   }]
}’https://api.conekta.io/orders

{
   "livemode": false,
   "amount": 20015,
   "currency": "MXN",
   "amount_refunded": 0,
   "customer_info": {
       "email": "[email protected]",
       "phone": "+52181818181",
       "name": "Jorge Martínez",
       "corporate": false,
       "customer_id": "cus_2tTU5GdkwZvBmS3fN",
       "object": "customer_info"
   },
   "object": "order",
   "id": "ord_2tTUAiM5p5JbLGbDw",
   "metadata": {},
   "is_refundable": false,
   "created_at": 1677803708,
   "updated_at": 1677803708,
   "line_items": {
       "object": "list",
       "has_more": false,
       "total": 1,
       "data": [
           {
               "name": "Vasija de Cerámica",
               "description": "Description",
               "unit_price": 20015,
               "quantity": 1,
               "object": "line_item",
               "id": "line_item_2tTUAiM5p5JbLGbDu",
               "parent_id": "ord_2tTUAiM5p5JbLGbDw",
               "metadata": {},
               "antifraud_info": {}
           }
       ]
   },
    "charges": {
        "object": "list",
        "has_more": false,
        "total": 1,
        "data": [
            {
                "id": "63f3ea0d88dc6c0019a3fe39",
                "livemode": false,
                "created_at": 1676929549,
                "currency": "MXN",
                "device_fingerprint": "e6edc7bb5ca296c0c61acb60ad20d083",
                "payment_method": {
                  "clabe": "01218000488381111",
                   "object": "direct_debit_payment",
                   "product_type": "santander_direct_debit",
                   "reference": "6962261",
                   "type": "direct_debit"	
                },
                "object": "charge",
                "description": "Payment from order",
                "status": "pending_payment",
                "amount": 23000,
                "paid_at": 1676929550,
                "fee": 1255,
                "customer_id": "",
                "order_id": "ord_2tQAKpPrfkdyzZvfM"
            }
        ]
    }
}

Notificaciones vía webhook

Todos los eventos que ocurran antes, durante y después de una transacción pueden ser notificados a través de webhooks, justo en el momento en que ocurren. Te enlistamos todos los eventos que intervienen en esta modalidad, accediendo al siguiente enlace para revisar el detalle del payload correspondiente a cada uno de ellos, y mapearlos para llevar a cabo los procesos internos de tu negocio requeridos.

Te recomendamos capturar los siguientes eventos:

EventoDescripción
order.paidEnviado cuando el cliente completa un pago de forma exitosa
order.pending_paymentEnviado cuando una orden es creada pero está pendiente de pago
order.canceledEnviado cuando el pago de una orden es cancelado.

Updated 1 day ago