跳到主要内容

查询开户请求详情

用于查询开户请求的完整详情，包括提案状态、相关方、附件文档、事件和配置等信息。

信息

此接口仅支持 checking（活期账户）和 escrow（托管账户）类型的账户。

Request​

ENDPOINT
/v2/account_request/ACCOUNT_REQUEST_KEY/full
MÉTODO
GET

Path Params​

字段类型描述
ACCOUNT_REQUEST_KEYUUID要查询的开户请求唯一密钥

Response​

STATUS
200
Response Body
{
    "proposal_key": "3e4b8746-da58-4799-bcd0-063326428d3f",
    "contract_number": "123456",
    "requester_key": "47d08366-a8ec-414c-a0a5-a089fc8a4ee8",
    "requester_name": "请求者姓名",
    "requester_document_number": "30987145223",
    "request_control_key": "f1a2b3c4-d5e6-7890-abcd-ef1234567890",
    "reserved_account_key": "b1690f7b-1e82-4f76-a8d3-c326a2b89b67",
    "created_account_key": "c2790f8c-2f93-5g87-b9e4-d437b3c90c78",
    "reserved_related_account": {
        "reserved_account_key": "d3890g9d-3g04-6h98-c0f5-e548c4da1d89",
        "account_branch": "0001",
        "account_number": "5960388",
        "account_digit": "5",
        "document_number": "30987145223",
        "name": "账户持有人姓名",
        "financial_institutions_code_number": "329",
        "financial_institutions": {
            "name": "QI Sociedade de Crédito Direto S.A.",
            "code_number": 329,
            "ispb": 32402502
        },
        "ted_account_type": {
            "enumerator": "checking_account",
            "translation_path": "...",
            "created_at": "2023-05-15T19:56:10"
        },
        "is_activated": true,
        "updated_at": "2023-05-15T19:56:10",
        "created_at": "2023-05-15T19:56:10"
    },
    "proposal_status": {
        "enumerator": "account_opened",
        "translation_path": "...",
        "created_at": "2023-05-15T19:56:10"
    },
    "account_type": {
        "enumerator": "checking",
        "translation_path": "...",
        "created_at": "2023-05-15T19:56:10"
    },
    "document_key": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "document_template_key": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "is_simplified": false,
    "created_at": "2023-05-15T19:56:10",
    "signed_contract": null,
    "additional_documents": null,
    "events": [
        {
            "old_status": {
                "enumerator": "pending",
                "translation_path": "...",
                "created_at": "2023-05-15T19:56:10"
            },
            "new_status": {
                "enumerator": "account_opened",
                "translation_path": "...",
                "created_at": "2023-05-15T19:56:10"
            },
            "rejection_reason": null,
            "event_description": "账户开立成功",
            "created_at": "2023-05-15T20:00:00"
        }
    ],
    "destinations": [
        {
            "reserved_account_key": "e4901h0e-4h15-7i09-d1g6-f659d5eb2e90",
            "account_branch": "0001",
            "account_number": "5960389",
            "account_digit": "7",
            "document_number": "30987145223",
            "name": "目标账户名称",
            "financial_institutions_code_number": "329",
            "financial_institutions": {
                "name": "QI Sociedade de Crédito Direto S.A.",
                "code_number": 329,
                "ispb": 32402502
            },
            "ted_account_type": {
                "enumerator": "checking_account",
                "translation_path": "...",
                "created_at": "2023-05-15T19:56:10"
            },
            "is_activated": true,
            "updated_at": "2023-05-15T19:56:10",
            "created_at": "2023-05-15T19:56:10"
        }
    ],
    "attached_documents": [
        {
            "document_key": "c3d4e5f6-a7b8-9012-cdef-123456789012",
            "document_type": {
                "enumerator": "identity",
                "translation_path": "...",
                "created_at": "2023-05-15T19:56:10"
            },
            "description": "身份证明文件",
            "document_url": "https://example.com/document.pdf",
            "is_activated": true,
            "updated_at": "2023-05-15T19:56:10",
            "created_at": "2023-05-15T19:56:10"
        }
    ],
    "related_parties": [
        {
            "person_key": "47d08366-a8ec-414c-a0a5-a089fc8a4ee8",
            "person_type": {
                "enumerator": "natural",
                "translation_path": "...",
                "created_at": "2023-05-15T19:56:10"
            },
            "individual_document_number": "30987145223",
            "company_document_number": null,
            "name": "Maria Luiza Vieira",
            "mother_name": "Dona Maria Mariane",
            "is_pep": false,
            "final_beneficiary": true,
            "is_signer": true,
            "is_activated": true,
            "address": {
                "street": "Av. Brigadeiro Faria Lima",
                "neighborhood": "Jardim Paulistano",
                "number": "2391",
                "postal_code": "01452905",
                "city": "São Paulo",
                "state": "SP",
                "country": "BR",
                "complement": "补充信息",
                "created_at": "2023-05-15T19:56:10"
            },
            "phone": {
                "phone_type": {
                    "enumerator": "mobile",
                    "translation_path": "...",
                    "created_at": "2023-05-15T19:56:10"
                },
                "country_code": "055",
                "area_code": "11",
                "number": "999999999",
                "created_at": "2023-05-15T19:56:10"
            },
            "nationality": "巴西",
            "email": "teste@gmail.com",
            "birth_date": "1990-05-06",
            "role_type": {
                "enumerator": "account_holder",
                "translation_path": "...",
                "created_at": "2023-05-15T19:56:10"
            },
            "updated_at": "2023-05-15T19:56:10",
            "created_at": "2023-05-15T19:56:10"
        }
    ],
    "credit_operations": [],
    "automatic_transfer_config": {},
    "billing_configuration_data": null,
    "account_owner_data": null
}

Response Body 参数​

字段类型描述
proposal_keystring开户请求唯一密钥
contract_numberstring合同编号
requester_keystring请求者密钥
requester_namestring请求者姓名
requester_document_numberstring请求者 CPF 或 CNPJ
request_control_keystring请求控制密钥
reserved_account_keystring预留账户密钥
created_account_keystring已创建账户密钥
reserved_related_accountobject预留关联账户数据（可为 null）
proposal_statusobject当前提案状态
account_typeobject账户类型
document_keystring文档密钥
document_template_keystring文档模板密钥
is_simplifiedboolean是否为简化账户
created_atdatetime请求创建日期
signed_contractobject已签署合同数据（可为 null）
additional_documentsarray附加文档（可为 null）
eventsarray请求事件列表
rejection_reasonstring拒绝原因，仅在被拒绝时出现
destinationsarray已配置的目标账户列表
attached_documentsarray附件文档列表
related_partiesarray相关方列表
credit_operationsarray信贷操作列表
automatic_transfer_configobject自动转账配置
billing_configuration_dataobject计费配置（可为 null）
account_owner_dataobject账户所有人数据（可为 null）

proposal_status / account_type 对象​

字段类型描述
enumeratorstring枚举值
translation_pathstring翻译路径
created_atdatetime创建日期

proposal_status 枚举值​

枚举值描述
pending待处理
pending_kyc_analysis待 KYC 审核
account_opened账户已开立
rejected已拒绝
cancelled已取消

account_type 枚举值​

枚举值描述
checking活期账户
escrow托管账户

events 对象​

字段类型描述
old_statusobject旧状态（与 proposal_status 格式相同）
new_statusobject新状态（与 proposal_status 格式相同）
rejection_reasonstring拒绝原因（可为 null）
event_descriptionstring事件描述
created_atdatetime事件日期

destinations / reserved_related_account 对象​

字段类型描述
reserved_account_keystring预留账户密钥
account_branchstring机构号
account_numberstring账户号
account_digitstring检验位
document_numberstringCPF 或 CNPJ
namestring账户持有人姓名
financial_institutions_code_numberstring金融机构代码
financial_institutionsobject金融机构数据
ted_account_typeobjectTED 账户类型
is_activatedboolean目标账户是否激活
updated_atdatetime更新日期
created_atdatetime创建日期

attached_documents 对象​

字段类型描述
document_keystring文档唯一密钥
document_typeobject文档类型（枚举格式）
descriptionstring文档描述
document_urlstring文档 URL
is_activatedboolean文档是否激活
updated_atdatetime更新日期
created_atdatetime创建日期
字段类型描述
person_keystring人员唯一密钥
person_typeobject人员类型（枚举格式）
individual_document_numberstringCPF
company_document_numberstringCNPJ
namestring姓名
mother_namestring母亲姓名
is_pepboolean是否为政治敏感人士
final_beneficiaryboolean是否为最终受益人
is_signerboolean是否为签署人
is_activatedboolean是否激活
addressobject地址
phoneobject电话
nationalitystring国籍
emailstring电子邮件
birth_datestring出生日期
role_typeobject角色类型（枚举格式）
updated_atdatetime更新日期
created_atdatetime创建日期

错误​

STATUS
404
Response Body: 未找到开户请求
{
    "title": "Proposal Not Found",
    "description": "Proposal not found.",
    "translation": "Proposta não encontrada.",
    "code": "ACR000003"
}
STATUS
400
Response Body: 不支持的账户类型
{
    "title": "Temporarily unavailable",
    "description": "Temporarily unavailable",
    "translation": "Temporariamente indisponível",
    "code": "ACR000068"
}
STATUS
403
Response Body: 用户无凭证
{
    "title": "Permission Validator Error",
    "description": "Selected agent do not own this item.",
    "translation": "O agente selecionado não é dono do item.",
    "code": "QIT000005"
}