Brazil

Brasil es uno de los mercados clave para los pagos digitales en Latinoamérica. Con un ecosistema fintech en rápido crecimiento, el país ofrece una infraestructura moderna y robusta para transacciones de ingreso y salida de fondos. Entre los métodos de pago más utilizados se encuentra PIX, un sistema de pagos en tiempo real desarrollado por el Banco Central de Brasil.

tip

Tenga en cuenta que el proceso es siempre el mismo, antes de procesar la transacción debe crear la orden, aquí hay un ejemplo del cuerpo de la orden para este país.

{
  "country": "BRA",
  "origin": "api",
  "amount": "5",
  "email": "test@gmail.com"
}

Nuestra plataforma admite operaciones de ingreso y salida de fondos en Brasil.

Pay In

Transferencia bancaria

Tipo Transacción	Tipo Pago	Método de pago	Proveedores admitidos	Logotipos
bankin	bank	pix	pix

Completar tranascción - Body (Solicitud de ejemplo)

{
    "hash":"U2FsdGVkX1%2BSi%2B...",
    "paymentMethod" : "pix",
    "typePayment" : "bank",
    "typeTransaction":"bankin",
    "description" : "Orden de prueba",
    "customer" :
    {
        "name": "Test User"
    },
    "cpf": "136.006.426-50"
}

---

Billetera

PayPal

Este endpoint permite iniciar un proceso de pago con PayPal a través de nuestra API.
Generaremos una URL de checkout a la que el cliente podrá ser redirigido para completar de forma segura el proceso de pago.

Completar transacción - Body (Ejemplo de solicitud)

{
  "hash": "U2FsdGV...",
  "paymentMethod": "paypal",
  "typePayment": "wallet",
  "typeTransaction": "walletin",
  "merchantId": "564153131",
  "urlReturn": "https://google.com",
  "urlRejected": "https://youtube.com",
  "urlWebhook": "https://webhook/ok"
}

Notas adicionales

• El comercio debe redirigir al usuario a la URL de payer-action inmediatamente después de recibir la respuesta.
• No se debe confiar únicamente en la redirección del usuario para confirmar el pago; siempre se debe validar el estado final del pago utilizando el webhook.

---

Pay Out

Cash - Cash out

Completar tranascción - Body (Solicitud de ejemplo)

{
    "hash":"U2FsdGVkX1%2BmLtf1vpR3e...",
    "paymentMethod" : "pix",
    "typePayment" : "cash",
    "typeTransaction":"cashout",
    "description" : "Orden de prueba",
    "customer" :
    {
        "name": "Test User"
    },
    "cpf": "136.006.426-50"
    "transaction": {"orderId": "string", "orderDescription": "string"},
}

Respuestas de ejemplo

202 Accepted

{
    "status": {
        "code": 202,
        "message": "success",
        "kind": "unknown"
    },
    "data": {
        "statusCode": "Done",
        "data": {
            "transaction": {
                "id": "56e6af48-xxxx-xxxx-xxxx-2407443859",
                "orderId": "f85b47d8-xxxx-xxxx-xxxx-07b5",
                "date": "2024-11-06T18:37:33.098Z",
                "state": "Registered",
                "amount": "10"
            },
        },
        "payment": {
            "id": 524,
            "uuid": "f85b47d8-xxxx-xxxx-xxxx-07b5",
            "merchant": "test.88pay@gmail.com",
            "merchantUuid": "eb81c-719c501cb757",
            "country": "BRA",
            "origin": "api",
            "createdAt": "2024-11-06T18:36:52.000Z",
            "amount": 10,
            "rate": null,
            "rateAmount": null,
            "total": null,
            "rateProviderAmount": null,
            "sandbox": 1,
            "paymentMethod": "pix",
            "typeMethod": "cash"
        }
    }
}

406 Payment declined

{
    "status": {
        "code": 406,
        "message": "failed",
        "kind": "unknown"
    },
    "data": {
        "status": "Declined",
        "statusCode": 406,
        "statusReason": "Payment declined",
        "transactionId": "",
        "idempotencyKey": "123f5da45678",
        "transactionReferenceId": null,
        "descriptor": "",
        "errors": [],
        "payment": {
            "id": 140,
            "uuid": "e0ebd9cf-xxxx-xxxx-xxxx-401f5da67049",
            "merchant": "d6d29ad2-xxxx-xxxx-xxxx-55d518578434",
            "country": "USA",
            "origin": "api",
            "status": "refused",
            "createdAt": "2024-07-31T06:59:52.000Z",
            "type": "cardin",
            "amount": 10,
            "rate": null,
            "rateAmount": null,
            "total": null,
            "paymentPocketStatus": "PENDING",
            "rateProviderAmount": null,
            "sandbox": 1,
            "paymentMethod": "TC",
            "typeMethod": "credit"
        }
    }
}

---

Limites

💡 Nota: Los valores expresados en esta sección de "Límites" están en USD.

Metodo de Pago	Minimo	Maximo	Min. Transacciones Diarias / Max. Transacciones Diarias
PIX	0.17 USD x Transaccion	8665 USD x Transaccion	Sin Limite