Initiate a PIX withdrawal

curl -X POST https://api.internationalfinance.com.br/v1/withdraw \
  -H "Authorization: Bearer $INFI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amountCents": 5000,
    "pixKey": "12345678901",
    "pixKeyType": "cpf",
    "description": "Payout",
    "externalRef": "withdraw-2026-05-08-001"
  }'

// Always use a unique and stable externalRef — protects against duplication on retries.
const res = await fetch('https://api.internationalfinance.com.br/v1/withdraw', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.INFI_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    amountCents: 5000,
    pixKey: '12345678901',
    pixKeyType: 'cpf',
    description: 'Payout',
    externalRef: 'withdraw-2026-05-08-001',
  }),
})
const body = await res.json()
if (res.status === 202) {
  // failed_unknown — DO NOT resend
  console.warn('withdrawal under verification', body.transactionId)
} else if (!res.ok) {
  throw new Error(`INFI ${res.status}: ${body.error}`)
}
if (body.idempotent) {
  console.info('idempotent retry — reusing transaction', body.transactionId)
}
const withdrawal = body

import os, requests
 
# Always use a unique and stable externalRef — protects against duplication on retries.
res = requests.post(
    "https://api.internationalfinance.com.br/v1/withdraw",
    headers={
        "Authorization": f"Bearer {os.environ['INFI_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "amountCents": 5000,
        "pixKey": "12345678901",
        "pixKeyType": "cpf",
        "description": "Payout",
        "externalRef": "withdraw-2026-05-08-001",
    },
)
body = res.json()
if res.status_code == 202:
    # failed_unknown — do not resend
    pass
elif not res.ok:
    raise RuntimeError(body.get("error"))
if body.get("idempotent"):
    print("idempotent retry — reusing transaction", body["transactionId"])
withdrawal = body

<?php
$client = new GuzzleHttp\Client(['http_errors' => false]);
// Always use a unique and stable externalRef — protects against duplication on retries.
$res = $client->post('https://api.internationalfinance.com.br/v1/withdraw', [
  'headers' => [
    'Authorization' => 'Bearer ' . getenv('INFI_API_KEY'),
    'Content-Type'  => 'application/json',
  ],
  'json' => [
    'amountCents' => 5000,
    'pixKey'      => '12345678901',
    'pixKeyType'  => 'cpf',
    'description' => 'Payout',
    'externalRef' => 'withdraw-2026-05-08-001',
  ],
]);
$body = json_decode($res->getBody(), true);
if ($res->getStatusCode() === 202) {
  // failed_unknown — do not resend
}