Requisitos Previos para Pagos en Brasil

Copiar

• Copiar para LLM

  Copiar página como Markdown para LLMs
• Ver como Markdown

  Abrir esta página como Markdown
• Abrir en ChatGPT

  Obtener información de ChatGPT
• Abrir en Claude

  Obtener información de Claude
• Conectar a Cursor

  Instalar servidor MCP en Cursor
• Conectar a VS Code

  Instalar servidor MCP en VS Code

Antes de que puedas usar nuestra solución OFPI y comenzar a recibir pagos, necesitarás:

1. Registrarte para obtener una Cuenta de Belvo.

2. Crear tus claves secretas de Payments.

3. Registrar tu webhook para que podamos informarte sobre eventos importantes durante el proceso de pago, como las confirmaciones de pago.

4. Registrar una cuenta bancaria que recibirá los fondos.

5. Preparar las URLs de callback. Estas son URLs a las que el usuario debe ser redirigido cuando complete o cancele un pago, o si ocurre un error durante el proceso de pago.

Regístrate para una Cuenta de Belvo

Para comenzar con Belvo, necesitas crear una cuenta de Belvo y generar tus claves de API.

1. Ve a la página de registro de Belvo y completa los campos requeridos.

1. Revisa tu bandeja de entrada para un correo electrónico de nosotros y confirma tu dirección de correo electrónico.
   La línea de asunto será: [Belvo] Please Confirm Your Email Address

✳️ ¡Genial! Una vez que hagas clic en el enlace del correo electrónico, serás redirigido al dashboard de Belvo. En el dashboard, puedes configurar tu cuenta, revisar tus registros de actividad y generar tus claves de API de Belvo.

Genera tus claves API

Ahora que tienes una cuenta, generemos algunas claves API para comenzar a trabajar con Belvo.

Para generar tus claves API:

1. En el entorno de Producción, ve a la sección Herramientas para Desarrolladores - Claves API del dashboard.
2. Haz clic en la pestaña Claves API de Pagos.
3. Haz clic en Generar Claves API, lo que generará automáticamente tus claves API.
4. En la ventana emergente, haz clic en el botón Descargar claves API. Asegúrate de guardarlas en un lugar seguro.

Registrar un webhook

Nuestras soluciones de pago utilizan webhooks para informarte sobre el progreso de tus pagos, cualquier error que ocurra y cuando un pago se completa exitosamente. Por lo tanto, necesitarás configurar al menos un webhook para recibir eventos de Belvo. Tu servidor debe responder con un 200 OK a nuestros eventos de webhook.

Si nuestro sistema no recibe un código de estado 200, intentará enviar la solicitud nuevamente automáticamente. Este proceso de reintento ocurrirá hasta tres veces, con cada intento espaciado 60 segundos. Por ejemplo, si el primer intento falla, nuestro sistema espera 60 segundos antes de intentar nuevamente y continuará este patrón hasta que reciba una respuesta exitosa o alcance el máximo de tres reintentos.

Puedes recibir eventos de webhook desde las siguientes direcciones IP:

• 3.130.254.46
• 18.220.61.186
• 18.223.45.212

Para agregar URLs de webhook al sistema de Belvo:

1. En tu panel de control de Belvo, ve a la sección de webhooks de pagos.

2. En la pestaña Open Payments Webhooks, haz clic en +Nuevo webhook.

   

3. Completa el formulario de Nuevo webhook con la información requerida.

   • URL: la URL para recibir las notificaciones del webhook.
   • Authorization: un token bearer opcional para usar si tu URL está protegida.

4. Haz clic en Crear webhook.

   

5. Para registrar URLs de webhook adicionales, repite los pasos 2-4 para cada URL que desees agregar. Todas las URLs registradas recibirán los mismos eventos de webhook.

Registrar una cuenta bancaria beneficiaria

Para usar el producto OFPI de Belvo, necesitas registrar al menos una cuenta bancaria que recibirá fondos. El número de cuentas bancarias que necesitas registrar depende de tu caso de uso.

Caso de Uso 1

Caso de Uso 2

Caso de Uso 3

Instrucciones

Para registrar una cuenta bancaria, necesitas realizar una solicitud POST Registrar una nueva cuenta bancaria.

{
  "institution": "f512d996-583a-4a91-8b5b-eba2e103b068",
  "external_id": "2c75c041-9cc7-430a-84e9-3b234aae76a2",
  "holder": {
    "type": "INDIVIDUAL",
    "information": {
      "first_name": "Caetano",
      "last_name": "Veloso",
      "identifier_type": "CPF",
      "identifier": "12345678901"
    }
  },
  "details": {
    "account_type": "CHECKINGS",
    "agency": "0444",
    "number": "457220"
  }
}

Una vez que realices una solicitud exitosa, recibirás la siguiente respuesta de nuestra API. Asegúrate de guardar el id de la respuesta: lo usarás como el beneficiary_bank_account en el futuro cuando crees intenciones de pago.

{
  "id": "1c83ead8-6665-429c-a17a-ddc76cb3a95e",
  "created_at": "2020-04-23T21:30:20.336854+00:00",
  "created_by": "62053a72-e2d5-4c95-a578-6b16616900ac",
  "institution": "f512d996-583a-4a91-8b5b-eba2e103b068",
  "details": {
    "country": "BRA",
    "account_type": "CHECKINGS",
    "agency": "0444",
    "number": "45722-0"
  },
  "holder": {
    "type": "BUSINESS",
    "information": {
      "identifier_type": "CNPJ",
      "name": "Caetano Veloso Entertainment Universe",
      "identifier": "23100299900"
    }
  }
}

Crear URLs de callback

Tus usuarios necesitarán ser redirigidos de vuelta a tu aplicación una vez que hayan completado el proceso de pago.

API Directa (Intenciones de Pago)

Para las Intenciones de Pago, solo necesitas tener una URL a la cual redirigir al usuario una vez que hayan confirmado el pago en su institución (éxito o fallo).

¡Hecho!

Una vez que hayas completado todos estos requisitos previos, ahora puedes comenzar a procesar pagos utilizando la API de Belvo.