Documentação

Argentina (ARS)

A Argentina tem um meio de pagamento: transferência bancária. O paymentMethod é opcional e assume BANK_TRANSFER.

Recebimentos na Argentina são por transferência bancária na moeda ARS (pesos argentinos). Mesmo endpoint de sempre — POST /transactions/v2/purchase — mudando currency para "ARS". O pagador transfere pelo app do banco dele para um CVU (Clave Virtual Uniforme, o identificador de conta argentino — equivalente à CLABE mexicana).

Leia isto antes de desenhar sua tela. Diferente de BRL e MXN, na Argentina o CVU não vem na resposta da criação da cobrança. Ele é negociado com a rede local e fica pronto alguns segundos depois. A resposta volta com status: "PENDING" e cvu vazio — isso é o comportamento normal, não é erro.

Como obter o CVU: faça polling em GET /transactions/:id até cvu vir preenchido. Costuma levar poucos segundos. A mesma chamada devolve paymentInstruction, com os dados completos da transferência (beneficiário e o que mais o trilho exigir) — é o que você mostra na sua tela.

Quando a transferência cai, disparamos o webhook cashin.paid — igual ao PIX.

Só habilite ARS se a sua conta tiver um adquirente ARS configurado. A moeda da transação precisa casar com a do adquirente.

O que muda em relação ao BRL

Campo	BRL (PIX)	ARS (Transferência)
`currency`	`"BRL"` (padrão)	`"ARS"` (obrigatório)
`paymentMethod`	obrigatório (`"PIX"`)	opcional — default `BANK_TRANSFER`
`cpf`	obrigatório	opcional (documento BR; não se aplica)
`phone`	obrigatório	opcional
`name`	obrigatório	obrigatório
Instrução de pagamento	`pixCode`, na resposta da criação	`cvu`, alguns segundos depois (polling)
Expiração	`expiresAt` preenchido	sem prazo — `expiresAt` nulo

amount continua em centavos: 200000 = AR$ 2.000,00.

Limites da rede: mínimo AR$ 2.000 e máximo AR$ 1.000.000 por transação. Valores fora da faixa são recusados na criação.

Exemplo — criar cobrança ARS

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": "Juan Pérez",
    "email": "juan@ejemplo.com",
    "amount": 200000,
    "currency": "ARS",
    "description": "Suscripción Pro",
    "responsibleDocument": "12345678901",
    "responsibleExternalId": "user-1234",
    "postbackUrl": "https://seu-dominio.com/webhook"
  }'

Resposta — repare no cvu vazio:

JSON

{
  "id": "17864385245624641191295936",
  "currency": "ARS",
  "method": "BANK_TRANSFER",
  "status": "PENDING",
  "amount": 200000,
  "cvu": "",
  "expiresAt": null,
  "createdAt": "2026-08-27T08:55:24.748Z",
  "costFee": 6000
}

Alguns segundos depois, GET /transactions/:id já traz a instrução:

JSON

{
  "id": "17864385245624641191295936",
  "currency": "ARS",
  "method": "BANK_TRANSFER",
  "status": "PENDING",
  "amount": 200000,
  "cvu": "0000003100010000000001",
  "paymentInstruction": {
    "currency": "ARS",
    "cvu": "0000003100010000000001",
    "beneficiary": "NOME DO BENEFICIÁRIO"
  }
}

Mostre o beneficiário e o CVU para o pagador, e peça o valor exato — transferência com valor diferente pode não ser identificada.

O status fica PENDING até a transferência cair; a confirmação chega pelo webhook cashin.paid (mesmo evento do PIX). Não existe cash-out em pesos argentinos: o saldo em ARS é liquidado para BRL pela iHubGames e você saca em real, como sempre — veja Como esse dinheiro vira saque, logo abaixo.

Como esse dinheiro vira saque

Cash-out em pesos argentinos 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 ARS.
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 Argentina é só mais uma moeda de entrada: você cobra em ARS e saca em BRL como sempre fez.

O que muda pro seu fluxo de caixa: enquanto o saldo estiver em ARS, 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.