# API de Débito Directo de Belvo Nuestra infraestructura de pagos tiene como objetivo facilitar, acelerar y modular el movimiento de dinero entre empresas y personas. Version: 1.0.0 ## Servers ``` https://api.sandbox.directdebit.belvo.com ``` ## Security ### ApiKeyAuth Type: apiKey In: header Name: api-key-id ### ApiKeySecret Type: apiKey In: header Name: api-key-secret ## Download OpenAPI description [API de Débito Directo de Belvo](https://developers.belvo.com/_spec/@l10n/es/apis/BelvoPaymentsMexico.yaml) ## Institutions (Direct Debit Mexico) Instituciones de Débito Directo ### Enumera todas las instituciones. - [GET /institutions](https://developers.belvo.com/es/apis/belvopaymentsmexico/institutions-(direct-debit-mexico)/listdirectdebitinstitutions.md): Enumera todas las instituciones disponibles. ## Customers (Direct Debit Mexico) Un Cliente es el usuario final, ya sea un individuo o un negocio, que posee la cuenta bancaria involucrada en una operación de débito o pago. Belvo Direct Debit almacena la información esencial de este Cliente para simplificar y reutilizarla en múltiples métodos de pago y objetivos de pago. ### Crear un cliente - [POST /customers](https://developers.belvo.com/es/apis/belvopaymentsmexico/customers-(direct-debit-mexico)/createdirectdebitcustomer.md): Crear un nuevo cliente de Débito Directo ### Listar todos los clientes - [GET /customers/](https://developers.belvo.com/es/apis/belvopaymentsmexico/customers-(direct-debit-mexico)/listdirectdebitcustomers.md): Enumere todos los clientes de Débito Directo asociados con su cuenta. ### Actualizar un cliente - [POST /customers/{customerId}](https://developers.belvo.com/es/apis/belvopaymentsmexico/customers-(direct-debit-mexico)/updatedirectdebitcustomer.md): Actualizar un cliente de débito directo existente ### Obtener los detalles de un cliente - [GET /customers/{customerId}](https://developers.belvo.com/es/apis/belvopaymentsmexico/customers-(direct-debit-mexico)/detaildirectdebitcustomer.md): Obtener los detalles sobre un cliente específico de débito directo. ## Payment Methods (Direct Debit Mexico) Métodos de Pago ### Crear un método de pago - [POST /payment_methods/bank_accounts](https://developers.belvo.com/es/apis/belvopaymentsmexico/payment-methods-(direct-debit-mexico)/createdirectdebitpaymentmethod.md): Crear un nuevo método de pago para un cliente ### Enumera todos los métodos de pago. - [GET /payment_methods](https://developers.belvo.com/es/apis/belvopaymentsmexico/payment-methods-(direct-debit-mexico)/listdirectdebitpaymentmethods.md): Enumere todos los métodos de pago asociados con su cuenta. ### Obtener los detalles de un método de pago - [GET /payment_methods/{paymentMethodId}](https://developers.belvo.com/es/apis/belvopaymentsmexico/payment-methods-(direct-debit-mexico)/detaildirectdebitpaymentmethod.md): Obtén los detalles sobre un método de pago específico. ### Desactivar un método de pago - [POST /payment_methods/{paymentMethodId}/deactivate](https://developers.belvo.com/es/apis/belvopaymentsmexico/payment-methods-(direct-debit-mexico)/deactivatedirectdebitpaymentmethod.md): Desactivar un método de pago específico. > 📘 Información > > Solo puedes desactivar un método de pago cuando el está en el estado y no hay solicitudes de pago pendientes ( = ). ## Payment Requests (Direct Debit Mexico) Solicitudes de Pago ### Crear una solicitud de pago - [POST /payment_requests](https://developers.belvo.com/es/apis/belvopaymentsmexico/payment-requests-(direct-debit-mexico)/createdirectdebitpaymentrequest.md): Crea una nueva solicitud de pago para un método de pago existente. > 📘 Claves de Idempotencia > > Este método admite claves de idempotencia. ### Enumere todas las solicitudes de pago. - [GET /payment_requests](https://developers.belvo.com/es/apis/belvopaymentsmexico/payment-requests-(direct-debit-mexico)/listdirectdebitpaymentrequests.md): Enumere todas las solicitudes de pago asociadas con su cuenta. ### Obtener los detalles de una solicitud de pago - [GET /payment_requests/{paymentRequestId}](https://developers.belvo.com/es/apis/belvopaymentsmexico/payment-requests-(direct-debit-mexico)/detaildirectdebitpaymentrequest.md): Obtén los detalles sobre una solicitud de pago específica. ### Cancelar una solicitud de pago - [POST /payment_requests/{paymentRequestId}/cancel](https://developers.belvo.com/es/apis/belvopaymentsmexico/payment-requests-(direct-debit-mexico)/canceldirectdebitpaymentrequest.md): Cancelar una solicitud de pago. > 📘 Información > > Solo puedes cancelar una solicitud de pago cuando el está en el estado . ## Movements (Direct Debit Mexico) Los Movimientos de Cuenta son las transacciones que ocurren dentro de tu cuenta bancaria. ### Obtén los movimientos de tu cuenta - [GET /account_movements](https://developers.belvo.com/es/apis/belvopaymentsmexico/movements-(direct-debit-mexico)/listdirectdebitaccountmovements.md): Obtén un estado de los movimientos que han ocurrido dentro de tu cuenta. ## Payment Consents (Direct Debit Mexico) Un Consentimiento en Débito Directo es una prueba de su cliente de que ha confirmado que se le debitarán fondos de su cuenta (Método de Pago). Esta prueba se compone de fotos de su identificación, una selfie y un contrato firmado. ### Crear un Consentimiento - [POST /consents](https://developers.belvo.com/es/apis/belvopaymentsmexico/payment-consents-(direct-debit-mexico)/createconsent.md): Cree el Consentimiento inicial para un Método de Pago. Una vez que cree un Consentimiento, puede cargar documentos de respaldo que sirvan como consentimiento de su cliente para debitar su cuenta bancaria utilizando el endpoint Upload Consent Files. ### Lista todos los Consents - [GET /consents](https://developers.belvo.com/es/apis/belvopaymentsmexico/payment-consents-(direct-debit-mexico)/listallconsents.md): Enumere todos los Consentimientos que ha creado para sus Métodos de Pago. ### Obtener los Detalles de un Consentimiento - [GET /consents/{consentId}](https://developers.belvo.com/es/apis/belvopaymentsmexico/payment-consents-(direct-debit-mexico)/getconsentdetails.md): Obtén los detalles de un consentimiento específico. ### Subir archivos de consentimiento - [POST /consents/{consentId}/files](https://developers.belvo.com/es/apis/belvopaymentsmexico/payment-consents-(direct-debit-mexico)/uploadconsentfiles.md): Sube archivos que sirvan como consentimiento de tu cliente para debitar su cuenta bancaria. Debes subir todos los archivos requeridos para un Consentimiento (escaneos del anverso y reverso del documento de identidad, una selfie del usuario sosteniendo el documento de identidad y un contrato firmado). Cada archivo no puede ser mayor de 20MB. ### Obtener los archivos de un Consentimiento - [GET /consents/{consentId}/files](https://developers.belvo.com/es/apis/belvopaymentsmexico/payment-consents-(direct-debit-mexico)/listconsentfiles.md): Enumere todos los archivos que se han subido para un Consent específico.