Pular para o conteúdo principal

Agendar transferência Pix

Segue o mesmo princípio da transferência pix, tendo como principal diferença que deve ser enviado o schedule_date e nesse caso você receberá a schedule_key.

Request

ENDPOINT
/baas/pix_transfer
MÉTODO
POST
Request Body: Transferência Manual
    {
"pix_transfer_type": "manual",
"source_account": {
"account_branch": "0001",
"account_digit": "2",
"account_number": "2359934",
"owner_document_number": "09080702000105"
},
"schedule_date": "2023-08-24",
"target_account": {
"bank_code": "104",
"account_branch": "0001",
"account_digit": "4",
"account_number": "6717606",
"owner_document_number": "60744463000190",
"owner_name": "Qi Tech",
"account_type": "checking",
"ispb": "32402502"
},
"transaction_amount": 15
}

Response

STATUS
200
Response Body: Transferência manual

{
"data": {
"operation_key": "8cb70dea-9fb0-4a68-9572-99a72849c8d6",
"status": "pending",
"event_datetime": "2021-08-04 20:05:54",
"pix_transfer_key": "8cb70dea-9fb0-4a68-9572-99a72849c8d6",
"pix_transaction": {
"pix_message": "",
"pix_transfer_key": "8cb70dea-9fb0-4a68-9572-99a72849c8d6",
"transaction_amount": 1891268.97,
"source_account": {
"account_branch": "0001",
"account_digit": "3",
"account_number": "24339",
"owner_document_number": "32402502000135",
"owner_name": "Qi Tech",
"account_type": "checking"
},
"target_account": {
"target_account": "78340-6",
"financial_institution_code": "329",
"owner_document_number": "32402502000135",
"owner_name": "QI Tech",
"target_account_type": "checking_account",
"owner_person_type": "legal",
"trading_name": "QITech"
},
"fee_amount": 0,
"schedule_date": "2020-08-04"
}
}
}

Body Params

CampoTipoDescriçãoCaracteres
pix_transfer_type *stringO Pix possui diferentes tipos de iniciação, o "manual" onde o usuário deve enviar os campos da conta de destino e conta de origem e o "key" onde o usuário deve enviar os campos da chave Pix do recebedor (conta de destino) e os dados da conta de origem.10
source_account *ObjectConta de origem.Objeto source_account
target_accountObjectConta destino - Só deve ser enviada em transações do tipo "manual".Objeto target_account
transaction_amount *stringValor da transferencia.10
schedule_datedateData de agendamento da transação (caso não seja enviado a transferência é realizada no momento da aprovação).10
receiver_conciliation_idstringIdenticação de conciliação do recebedor.10
is_chargebackstringFlag de identificação de uma devolução de transação Pix (booleano True ou False).10
requester_document_identification *stringCPF do usuário quem está solicitando a transferência.10
pix_transfer_keystringChave de idempotência de uma transação Pix - só deve ser enviado se o tipo de transferência for "key".10
chargeback_amountstringValor da devolução - Este campo deve ser enviado apenas em caso de chargeback e exclui a obrigatoriedade do campo "transaction_amount".10
chargeback_other_reasonstringMotivo de devolução ( Este campo deve ser enviado apenas em caso de chargeback).10
chargeback_messagestringCampo para usuário inserir mensagem durante a devolução ( Este campo deve ser enviado apenas em caso de chargeback).10

Objeto source_account

CampoTipoDescriçãoCaracteres
account_branch *stringNúmero Agência.0
branch_digitstringDígito da Agência.0
account_digit *stringDígito da conta.0
account_number *stringNúmero da conta.0
owner_document_number *stringCPF ou CNPJ (apenas números) do titular da conta.0

Objeto target_account

CampoTipoDescriçãoCaracteres
account_branch *stringAgência.10
account_digit *stringDígito da conta10
account_number *stringNúmero da conta.10
owner_document_number *stringCPF ou CNPJ (apenas números) do titular da conta.10
owner_name *stringNome do titular da conta.10
account_type *stringCPF ou CNPJ (apenas números) do titular da conta.10
trading_namestringNome fantasia para pessoa jurídica.10
ispbstringCódigo de oito dígitos que identifica os bancos no sistema de transferência de reserva do Banco Central.10

Response

STATUS
400
Response Body
{
"data": "{\"title\": \"Bad Request\", \"description\": \"Invalid request body.\", \"translation\": \"Corpo da requisição inválido.\", \"extra_fields\": {}, \"code\": \"LEG000069\"}"
}