Requisitos Previos para Pagos en Brasil

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 confirmaciones de pago.

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

5. Preparar URLs de callback. Estas son URLs a las que el usuario debe ser redirigido cuando completen o cancelen 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.

Crea tus claves secretas de pagos

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

Para generar tus claves de API:

1. En el entorno de Producción, ve a la sección Desarrolladores - Claves de API del dashboard.
2. Haz clic en la pestaña Payments API Keys.
3. Haz clic en Generate API Keys, lo que generará automáticamente tus claves de API.
4. En la ventana emergente, haz clic en el botón Download API keys. Asegúrate de almacenarlas 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 complete con éxito. Por lo tanto, necesitarás configurar 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 el código de estado 200, intenta automáticamente enviar la solicitud nuevamente. 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 tu URL de webhook al sistema de Belvo:

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

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

   

3. Completa el formulario de New 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 Create 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 enlaces de pago o 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. Las URLs de callback que proporciones dependen de si estás utilizando una integración Direct API o utilizando nuestro widget de Payment Links.

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).

Payment Links

Para los Payment Links, necesitarás proporcionar dos URLs:

• success: La URL a la que el usuario debe ser redirigido después de completar el flujo en el widget de payment link.
• cancel: La URL a la que el usuario debe ser redirigido si sale del widget antes de completar el flujo.

¡Hecho!

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