11/02/25 — PIX Agendado no ar!

Agora é possível agendar Transferências via PIX

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.

Requisição exemplo

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]"
    }
  }
}
'

Retorno exemplo

{
  "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"
}

Gatilho — Mudança de status de transferência para terceiros

Confira os dados que este gatilho envia quando acionado por este evento:

Sucesso

{
  "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"
}

Falha

{
  "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"
}