Os bancos Master e Vert foram incluídos como domicílio bancário aqui na iugu.
Os endpoints que receberam esta atualização foram:
v1/accounts/{account_id}/request_verification.v1/bank_verification.🚀 Versão 3.2.0 já está disponível! Lançada com tudo em 10/02/2025, trazendo melhorias incríveis para vocês! 🎉
Não perca, aproveite agora!
Acesse a nova versão por aqui e, antes de atualizar, desative qualquer versão anterior a 3.1.11.
Notas de atualização
✅ Integração DDI para um processamento de pagamentos ainda mais rápido e seguro.
✅ Implementação do HPOS (High-Performance Order Storage) , garantindo mais eficiência e controle no seu gerenciamento. Saiba mais
O banco 280 WILL BANK/AVISTA S.A CREDITO foi incluído como domicílio bancário!
Os endpoints que receberam esta atualização foram:
v1/accounts/{account_id}/request_verification.v1/bank_verification.Adicionamos o parâmetro data[reason] no gatilho Verificação de documentos de afiliados/subconta iugu — referrals.document_status_change. Nele será armazenado uma mensagem deixada pelo Time de Prevenção à Fraude explicando o motivo da recusa daquele documento.
Agora, seus clientes podem dividir o pagamento em dois cartões de crédito! 💳💳
Essa novidade é ideal para clientes com limite reduzido no Cartão ou para situações em que você prefira não oferecer pagamento via Pix ou Boleto. Com essa nova função, é possível dividir o valor da compra entre dois cartões de crédito em uma única transação!
Criamos um guia que instrui, passo a passo, como utilizar esta nova feature: Cobrança com 2 Cartões (NOVO✨). Além disso, disponibilizamos uma FAQ: Como receber pagamento com 2 cartões?.
PATCH /v1/transfer_requests/{id}/scheduled_cancelEste endpoint permite cancelar, individualmente, um PIX que foi Agendado. Para isso, basta informar o ID da Transferência que é sempre disponibilizado no retorno do endpoint Transferência para Terceiros — POST /v1/transfer_requests na propriedade transfer_request_id.
curl --request PATCH \
--url 'https://api.iugu.com/v1/transfer_requests/AB2483B68CA624DC98A88AFC7D1565213/scheduled_cancel?api_token=seu-api_token' \
--header 'accept: application/json'
{
"transfer_request_id": "E2483B68CA624DC98A88AFC7D1565213",
"created_at": "2025-02-11T11:28:08-03:00",
"amount_cents": 10,
"transfer_type": "pix",
"end_to_end_id": "E151119752025021114280e7d38e1745",
"external_reference": null,
"receipt_url": "https://comprovantes.iugu.test/e2483b68-ca62-4dc9-8a88-afc7d1565213-d52c04",
"status": "cancelled"
}
O status desta transferência deve ser scheduled. Se não, o erro abaixo será retornado:
{
"errors": "Status da transferência deve ser igual a agendado."
}
transfer_request_id?Caso não tenha a este ID, utilize o endpoint Listar Comprovantes de Transferências para Terceiros — GET /v1/transfer_requests/. Busque pela transferência deseja e atente-se a propriedade id.
O endpoint POST /v1/transfer_requests recebeu um novo parâmetro: scheduled_date. Este parâmetro permite agendar uma data para a realização deste PIX Out.
curl --request POST \
--url 'https://api.iugu.com/v1/transfer_requests?api_token=seu-api-token' \
--header 'Request-Time: 2025-02-11T10:50:45-03:00' \
--header 'Signature: signature=(assinatura-RSA)' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '
{
"scheduled_date": "2025-02-12",
"transfer_type": "pix",
"amount_cents": 500,
"receiver": {
"name": "Nome Sobrenome Fictício",
"cpf_cnpj": "113.436.750-30",
"pix": {
"type": "email",
"key": "[email protected]"
}
}
}
'
{
"transfer_request_id": "61756F81FD8C47629AEFDE3A8C17713C",
"created_at": "2025-02-05T15:43:51-03:00",
"amount_cents": 100,
"transfer_type": "pix",
"end_to_end_id": "E15111975202502051843d39ea29f4fb",
"external_reference": null,
"receipt_url": "https://comprovantes.iugu.test/61756f81-fd8c-4762-9aef-de3a8c17713c-b54c6d",
"status": "scheduled",
"scheduled_date": "2025-02-06"
}
Confira os dados que este gatilho envia quando acionado por este evento:
{
"event": "transfer_request.done",
"transfer_request_id": "7AB45C8123DE45678BC1234F6D7E8F90",
"transfer_status": "done",
"description": "",
"amount_cents": "2500",
"total_refunded_amount_cents": "",
"transfer_type": "pix",
"conciliation_id": "",
"sender_account_id": "9876543210ABCDEF1234567890ABCDEF",
"sender_name": "12345678000199 - EMPRESA XYZ (doc. approved)",
"sender_cpf_cnpj": "12.345.***/****-99",
"sender_bank_account_type": "checking_account",
"sender_bank_account": "1234567",
"sender_bank_name": "",
"sender_bank_branch": "0001",
"receiver_ispb": "60701190",
"receiver_name": "João Silva",
"receiver_cpf_cnpj": "123.***.***-45",
"receiver_bank_name": "Banco do Brasil",
"receiver_bank": "001",
"receiver_bank_branch": "1234",
"receiver_bank_branch_digit": "",
"receiver_bank_account": "987654",
"receiver_bank_account_digit": "",
"receiver_bank_account_type": "checking_account",
"receiver_pix_key": "12345678909",
"statement": "F9876543210987654321ABCDEF123456",
"done_at": "2025-03-10T14:30:00.000Z"
}
{
"event": "transfer_request.status_changed",
"transfer_request_id": "9EF12B45CD6789AB1234567890ABCDEF",
"transfer_status": "rejected",
"description": "",
"amount_cents": "5000",
"total_refunded_amount_cents": "",
"transfer_type": "pix",
"conciliation_id": "",
"sender_account_id": "ABCDEF1234567890ABCDEF1234567890",
"sender_name": "98765432000188 - EMPRESA ABC (doc. approved)",
"sender_cpf_cnpj": "98.765.***/****-88",
"sender_bank_account_type": "checking_account",
"sender_bank_account": "654321",
"sender_bank_name": "",
"sender_bank_branch": "0001",
"receiver_ispb": "60701190",
"receiver_name": "Ana Souza",
"receiver_cpf_cnpj": "321.***.***-76",
"receiver_bank_name": "Santander",
"receiver_bank": "033",
"receiver_bank_branch": "4567",
"receiver_bank_branch_digit": "",
"receiver_bank_account": "123456",
"receiver_bank_account_digit": "",
"receiver_bank_account_type": "checking_account",
"receiver_pix_key": "98765432101",
"statement": "F9876543210987654321ABCDEF123456",
"rejection_reason": "Insufficient Balance",
"rejected_at": "2025-02-15T10:20:30.000Z"
}
Idempotency-key no header!O endpoint Transferir Valor entre contas iugu — POST /v1/transfers recebeu uma atualização e, agora, também é possível utilizar a Chave de Idempotência.
Identificamos a falta do status approved na documentação do gatilho Verificação de documentos de afiliados/subconta iugu — referrals.document_status_change.
Além disso, enxergamos a necessidade de explicação para cada status de cada um dos gatilhos:
referrals.verificationaccepted: Conta aceita e Verificada. Apta a transacionar.rejected: Conta recusada e Não verificada. Não autorizada à transacionar.referrals.bank_verificationaccepted: Alteração de Domicílio Bancário aceita.rejected: Alteração de Domicílio Bancário recusada.referrals.document_status_changepending_manual_analisys: Documento com análise pendente pelo Time de Prevenção.requested: Documento recusado e reenvio solicitado. Utilize o endpoint para Reenviar Documentos para Verificar Conta iugu.approved: Documento aprovado.items no endpoint Criar FaturaA antiga descrição informava sobre o limite de 30 itens, porém, não deixava claro que esta limitação está presente apenas em ambiente de testes.
Deste modo, a descrição atual é: "Itens da fatura. O parâmetro price_cents tem o valor mínimo de 100. Limite de 30 itens em test_mode. Já live_mode não há limites."