Quickstart

In three steps you issue your first PIX charge.

1. Generate an API key

In the INFI dashboard, go to Devices / API keys and click Create new key. The full secret is shown only once. Save it in a safe place (secrets vault, environment variable).

Preconditions

Creation requires approved KYC and a verified email. If either is pending, finish onboarding before continuing.

2. Create a charge

Endpoint: POST https://api.internationalfinance.com.br/v1/pix. Use Authorization: Bearer <YOUR_API_KEY>.

curl -X POST https://api.internationalfinance.com.br/v1/pix \
  -H "Authorization: Bearer $INFI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amountCents": 1000,
    "externalRef": "order-123",
    "expiresInDays": 2,
    "customer": {
      "name": "Maria Silva",
      "email": "maria@example.com",
      "document": { "number": "12345678901", "type": "cpf" }
    }
  }'

const res = await fetch('https://api.internationalfinance.com.br/v1/pix', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.INFI_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    amountCents: 1000,
    externalRef: 'order-123',
    expiresInDays: 2,
    customer: {
      name: 'Maria Silva',
      email: 'maria@example.com',
      document: { number: '12345678901', type: 'cpf' },
    },
  }),
})
 
const charge = await res.json()
console.log(charge.transactionId, charge.pixPayload)

import os, requests
 
res = requests.post(
    "https://api.internationalfinance.com.br/v1/pix",
    headers={
        "Authorization": f"Bearer {os.environ['INFI_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "amountCents": 1000,
        "externalRef": "order-123",
        "expiresInDays": 2,
        "customer": {
            "name": "Maria Silva",
            "email": "maria@example.com",
            "document": {"number": "12345678901", "type": "cpf"},
        },
    },
)
charge = res.json()
print(charge["transactionId"], charge["pixPayload"])

<?php
$client = new GuzzleHttp\Client();
$res = $client->post('https://api.internationalfinance.com.br/v1/pix', [
  'headers' => [
    'Authorization' => 'Bearer ' . getenv('INFI_API_KEY'),
    'Content-Type'  => 'application/json',
  ],
  'json' => [
    'amountCents'   => 1000,
    'externalRef'   => 'order-123',
    'expiresInDays' => 2,
    'customer' => [
      'name'  => 'Maria Silva',
      'email' => 'maria@example.com',
      'document' => ['number' => '12345678901', 'type' => 'cpf'],
    ],
  ],
]);
$charge = json_decode($res->getBody(), true);

Response 201:

{
  "transactionId": "Q4t9aV...",
  "status": "pending",
  "pixPayload": "00020126580014BR.GOV.BCB.PIX...",
  "expiresAt": 1715000000,
  "amountCents": 1000
}

Show pixPayload to the payer as copy-and-paste or render the QR Code from it on your side.

3. Receive confirmation

Register an HTTPS URL in the dashboard under Webhook. When the status changes (paid, failed, cancelled…), INFI sends a POST to your endpoint with the HMAC signature. See Setting up the webhook.

Webhook is best-effort

INFI sends a single webhook attempt (8s timeout). If your application is down or slow to respond, the event may be lost — implement a fallback by polling GET /v1/transactions/:id for final statuses.

Next steps

Authentication — key format and revocation.
Charge reference — all fields.
Errors — format and known messages.

Overview Environments