跳到主要内容

solicitar_transferencia

Request​

ENDPOINT
/baas/pix_transfer
MÉTODO
POST
Request Body
{
    "pix_transfer_type": "manual",
    "source_account": {
        "account_branch": "0001",
        "branch_digit": "1",
        "account_digit": "3",
        "account_number": "12345678",
        "owner_document_number": "32402502000135"
    },
    "target_account": {
        "account_branch": "0001",
        "account_digit": "3",
        "account_number": "12345678",
        "financial_institution_code": "329",
        "owner_document_number": "32402502000135",
        "owner_name": "Qi Tech",
        "account_type": "checking_account",
        "ispb": "32402502"
    },
    "transaction_amount": 500,
    "receiver_conciliation_id": "REC00000000000000000000009459463343",
    "is_chargeback": false,
    "requester_document_identification": "11111111111",
    "pix_transfer_key": "b5904f04-101e-4602-8fbc-c5dcc4c2caec",
    "chargeback_amount": 500,
    "chargeback_other_reason": "Valor excedente ao combinado"
}

Body Params​

字段类型描述字符数
pix_transfer_type *stringPix 有不同的发起类型："manual" 类型中用户需发送目标账户和来源账户字段；"key" 类型中用户需发送收款方 Pix 密钥（目标账户）和来源账户数据。10
source_account *Object来源账户。source_account 对象
target_accountObject目标账户 - 仅在 "manual" 类型交易中发送。target_account 对象
transaction_amount *string转账金额。10
receiver_conciliation_idstring收款方对账标识。10
is_chargebackstringPix 退款交易标识标志（布尔值 True 或 False）。10
requester_document_identification *string申请转账的用户 CPF。10
pix_transfer_keystringPix 交易幂等密钥 - 仅在转账类型为 "key" 时发送。10
chargeback_amountstring退款金额 - 仅在退款情况下发送，并排除 "transaction_amount" 字段的必填要求。10
chargeback_other_reasonstring退款原因（仅在退款情况下发送）。10
chargeback_messagestring退款时用户输入的消息字段（仅在退款情况下发送）。10

source_account 对象​

字段类型描述字符数
account_branch *string机构号。0
branch_digitstring机构检验位。0
account_digit *string账户检验位。0
account_number *string账户号。0
owner_document_number *string账户持有人 CPF 或 CNPJ（仅数字）。0

target_account 对象​

字段类型描述字符数
account_branch *string机构号。10
account_digit *string账户检验位10
account_number *string账户号。10
owner_document_number *string账户持有人 CPF 或 CNPJ（仅数字）。10
owner_name *string账户持有人姓名。10
account_type *string账户持有人 CPF 或 CNPJ（仅数字）。10
ispbstring八位数代码，用于在巴西中央银行储备转账系统中识别银行。10

Response​

STATUS
200
Response Body: 手动转账
{
  "operation_key": "8cb70dea-9fb0-4a68-9572-99a72849c8d6",
  "status": "pending",
  "event_datetime": "2021-08-04 20:05:54",
  "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
  }
}


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