Documentação

Bolívia (BOB)

A Bolívia tem um meio de entrada: QR. O paymentMethod é opcional e assume QR. A saída é por transferência bancária.

Recebimentos na Bolívia são por QR na moeda BOB (bolivianos). Mesmo endpoint de sempre — POST /transactions/v2/purchase — mudando currency para "BOB".

O comprador escaneia o QR pelo app do banco dele, ou copia o payload e cola lá.

A instrução não vem na resposta da criação. O payload do QR fica pronto alguns segundos depois; a resposta volta com status: "PENDING" e qr vazio. Faça polling em GET /transactions/:id até vir preenchido.

Quando o pagamento cai, disparamos o webhook cashin.paid — igual ao PIX.

Só habilite BOB se a sua conta tiver um adquirente BOB configurado.

Mostre o QR E um botão de copiar

Este é o erro mais comum na Bolívia, e ele custa venda.

Boa parte dos compradores abre o seu checkout no celular. E ninguém consegue escanear, com o celular, um QR exibido na tela do próprio celular — a pessoa fica presa numa tela que parece estar funcionando.

Renderize o QR e, logo abaixo, o mesmo payload como texto com um botão copiar. O valor é idêntico nos dois: o campo qr serve tanto para desenhar a imagem quanto para copiar e colar.

O que muda em relação ao BRL

Campo	BRL (PIX)	BOB (QR)
`currency`	`"BRL"` (padrão)	`"BOB"` (obrigatório)
`paymentMethod`	obrigatório (`"PIX"`)	opcional — default `QR`
`name`	obrigatório	obrigatório
`email`	opcional	obrigatório
`phone`	obrigatório	obrigatório
`responsibleDocument`	CPF/CNPJ	obrigatório — CI, NIT ou PAS
Instrução de pagamento	`pixCode`, na resposta	`qr`, alguns segundos depois

Limites da rede: mínimo BOB 10 e máximo BOB 10.000 por transação — a faixa mais estreita entre as moedas que operamos.

amount continua em centavos: 10000 = Bs 100,00.

Exemplo — criar cobrança BOB

bash

curl -X POST "https://api.ihubplay.com/transactions/v2/purchase" \
  -H "Authorization: Basic $(echo -n 'secret:SUA_SECRET_KEY' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Ana Flores",
    "email": "ana@ejemplo.com",
    "phone": "59171234567",
    "amount": 10000,
    "currency": "BOB",
    "description": "Suscripción Pro",
    "responsibleDocument": "1234567",
    "postbackUrl": "https://seu-dominio.com/webhook"
  }'

Depois do polling, qr vem preenchido com o payload — use o mesmo valor para desenhar a imagem e para o botão de copiar.

Como esse dinheiro vira saque

Cash-out em bolivianos não existe: todo saque da plataforma sai em BRL, por PIX. O caminho do dinheiro é sempre o mesmo:

O comprador paga e o saldo entra em BOB.
A iHubGames liquida esse saldo para BRL pela cotação de câmbio do dia.
O valor em BRL passa a aparecer no seu saldo e você saca pelo fluxo normal — POST /withdraws/cash-out, o mesmo de uma conta brasileira.

Você não faz nada no passo 2. Não existe endpoint de conversão, não precisa abrir chamado nem aprovar cotação — a liquidação é operada pela iHubGames e o saldo em BRL simplesmente aparece. Do lado da sua integração, a Bolívia é só mais uma moeda de entrada: você cobra em BOB e saca em BRL como sempre fez.

O que muda pro seu fluxo de caixa: enquanto o saldo estiver em BOB, ele ainda não é sacável — só o saldo em BRL é. Consulte os dois em GET /accounts/balances, que devolve uma linha por moeda, e programe o saque em cima da linha de BRL.