Etapa obrigatória para criar uma CCB
Método: POST
Endpoint:
https://sandbox.platform.flowfinance.com.br/banking/originator/persons
Headers:
| Chave | Valor |
|---|---|
| Authorization | Bearer {{originatorAccessToken}} |
| Content-Type | application/json |
Payload:
{
"full_name": "{{employeeName}}",
"taxpayer_id": "{{taxpayerId}}",
"id_document": {
"issue_date": "2024-01-01",
"issuer": "SSP/SC",
"number": "190653164",
"type": "RG"
},
"sex": "MALE",
"nationality": "Brasileiro",
"birth_date": "2001-01-01",
"occupation": "Administrador",
"marital_status": "SINGLE",
"marital_property_system": "NO_COMMUNION",
"pep": false,
"email_address": "{{email}}",
"phone": {
"country_code": "55",
"area_code": "48",
"number": "999999999"
},
"address": {
"street_number": "350",
"street_name": "Alameda Xingu",
"postal_code": "06455030",
"district": "Alphaville",
"city": "Barueri",
"state_code": "SP",
"country_code": "BRA"
},
"external_bank_account": {
"bank_code": "000",
"bank_account": "00000",
"bank_account_digit": "0",
"bank_branch": "00000"
},
"pix": {
"key": "4ca519ef-0ccc-4c41-b58b-c88f1f47d8ab",
"key_type": "ALEATORY_KEY"
}
}
Observação:
Em ambiente de sandbox, utilize a chave PIX
4ca519ef-0ccc-4c41-b58b-c88f1f47d8abpara habilitar transferências simuladas.
Exemplo de requisição::
curl --location 'https://sandbox.platform.flowfinance.com.br/banking/originator/persons' \
--header 'Content-Type: application/json' \
--header 'Authorization: \
--data-raw '{
"full_name": "Dr. Arthur Vasconcelos",
"taxpayer_id": "54807923188",
"id_document": {
"issue_date": "2024-01-01",
"issuer": "SSP/SC",
"number": "190653164",
"type": "RG"
},
"sex": "MALE",
"nationality": "Brasileiro",
"birth_date": "2001-01-01",
"occupation": "Administrador",
"marital_status": "SINGLE",
"marital_property_system": "NO_COMMUNION",
"pep": false,
"email_address": "[email protected]",
"phone": {
"country_code": "55",
"area_code": "48",
"number": "999999999"
},
"address": {
"street_number": "350",
"street_name": "Alameda Xingu",
"postal_code": "06455030",
"district": "Alphaville",
"city": "Barueri",
"state_code": "SP",
"country_code": "BRA"
},
"external_bank_account": {
"bank_code": "000",
"bank_account": "00000",
"bank_account_digit": "0",
"bank_branch": "00000"
},
"pix": {
"key": "4ca519ef-0ccc-4c41-b58b-c88f1f47d8ab",
"key_type": "ALEATORY_KEY"
}
}
'
Exemplo de resposta:
{
"id": "1beffab9-a80e-4242-bbc5-ae9e2f535f49",
"external_id": null,
"taxpayer_id": "54807923188",
"nationality": "Brasileiro",
"pep": false,
"full_name": "Dr. Arthur Vasconcelos",
"phone": {
"country_code": "55",
"area_code": "48",
"number": "999999999",
"formatted_number": "+5548999999999"
},
"occupation": "Administrador",
"birth_date": "2001-01-01",
"marital_status": "SINGLE",
"email_address": "[email protected]",
"mothers_name": null,
"marital_property_system": "NO_COMMUNION",
"id_document": {
"number": "190653164",
"issuer": "SSP/SC",
"issue_date": "2024-01-01",
"type": "RG"
},
"sex": "MALE",
"address": {
"street_name": "Alameda Xingu",
"street_number": 350,
"postal_code": "06455030",
"district": "Alphaville",
"city": "Barueri",
"state_code": "SP",
"country_code": "BRA",
"extra_info": null
},
"pix": {
"key": "4ca519ef-0ccc-4c41-b58b-c88f1f47d8ab",
"key_type": "ALEATORY_KEY"
},
"external_bank_account": {
"bank_code": "000",
"bank_account": "00000",
"bank_account_digit": "0",
"bank_branch": "00000",
"bank_account_type": null,
"ispb_code": null
},
"custom_variables": {},
"spouse_full_name": null,
"originator": {
"id": "5185f88e-cbb4-46b6-8f4d-63d5dc33af9f",
"legal_name": "O grande banquinho"
},
"employer": null,
"created_at": "2025-10-29T22:48:02.733905Z",
"version": 0,
"spouse_taxpayer_id": null,
"spouse_date_of_birth": null,
"birthplace": null,
"monthly_income": null,
"income_range": null,
"has_scr_evidence": false,
"scr_evidence_provider": null,
"scr_evidence_type": null,
"education_level": "NOT_INFORMED"
}