Skip to content
Gowd Platform Production

Create account request

POST
/order/v1/banking/accounts

Create a banking account request with holder information and representatives.

idempotency-key
required
string

Unique key for idempotent requests

object
country
required

Holder country code in ISO-3

string
Allowed values: BRA
holderType
required

Holder type

string
Allowed values: INDIVIDUAL ORGANIZATION
fullName
required

Holder full name or business name.

string
email
required

Primary email of the holder.

string
phone
required

Primary phone of the holder.

string
birthdate
required

Holder birthdate or foundation date (YYYY-MM-DD).

string
document
required

Holder identification document.

object
type
required

Document type.

string
Allowed values: CPF CNPJ RUC NATIONAL_ID PASSPORT FOREIGNER_ID CHANCERY_ID CEDULA_DE_CIUDADANIA CEDULA_DE_EXTRANJERIA NUMERO_DE_IDENTIFICACION_TRIBUTARIA OTHERS DNI CURP RFC
number
required

Document number (digits and uppercase letters for alphanumeric CNPJ).

string
address
required

Complete holder address.

object
street
required

Street and number.

string
neighborhood
required

Neighborhood.

string
city
required

City.

string
state
required

State (UF).

string
zipCode
required

ZIP code (digits only).

string
complement

Address complement.

string
representatives

Representatives linked to the holder (required when holderType is ORGANIZATION).

Array<object>
object
country
required

Representative country in ISO-3.

string
Allowed values: AFG ALB DZA ASM AND AGO AIA ATA ATG ARG ARM ABW AUS AUT AZE BHS BHR BGD BRB BLR BEL BLZ BEN BMU BTN BOL BES BIH BWA BVT BRA IOT BRN BGR BFA BDI CPV KHM CMR CAN CYM CAF TCD CHL CHN CXR CCK COL COM COG COD COK CRI HRV CUB CUW CYP CZE DNK DJI DMA DOM ECU EGY SLV GNQ ERI EST ETH FLK FRO FJI FIN FRA GUF PYF ATF GAB GMB GEO DEU GHA GIB GRC GRL GRD GLP GUM GTM GGY GIN GNB GUY HTI HMD VAT HND HKG HUN ISL IND IDN IRN IRQ IRL IMN ISR ITA JAM JPN JEY JOR KAZ KEN KIR PRK KOR KWT KGZ LAO LVA LBN LSO LBR LBY LIE LTU LUX MAC MDG MWI MYS MDV MLI MLT MHL MTQ MRT MUS MYT MEX FSM MDA MCO MNG MNE MSR MAR MOZ MMR NAM NRU NPL NLD NCL NZL NIC NER NGA NIU NFK MNP NOR OMN PAK PLW PSE PAN PNG PRY PER PHL PCN POL PRT PRI QAT REU ROU RUS RWA BLM SHN KNA LCA MAF SPM VCT WSM SMR STP SAU SEN SRB SYC SLE SGP SXM SVK SVN SLB SOM ZAF SGS SSD ESP LKA SDN SUR SJM SWE CHE SYR TWN TJK TZA THA TLS TGO TKL TON TTO TUN TUR TKM TCA TUV UGA UKR ARE GBR USA UMI URY UZB VUT VEN VNM VGB VIR WLF ESH YEM ZMB ZWE
fullName
required

Representative full name.

string
email
required

Representative email.

string
phone
required

Representative phone number.

string
birthdate
required

Representative birthdate (YYYY-MM-DD).

string
documentNumber
required

Representative document number (CPF).

string
onboardingDocuments

Onboarding information.

object
tradingName

Company trade name.

string
businessName

Company legal name.

string
contactNumber

Contact phone number including country code.

string
site

Company institutional website URL.

string
socialContract

URL of the company articles of association or latest amendment.

string
cnpjCard

URL of the CNPJ registration card issued by the Brazilian IRS.

string
proofAddress

URL of the company proof of address issued within the last 30 days.

string
proofBankAddress

URL of the bank address proof, such as a bank statement or bank letter.

string
partnerProofAddress

URL of the partner or legal representative proof of address.

string
documentRepresentative

URL of the legal representative identity document, such as RG or CNH.

string
selfieRepresentative

URL of the legal representative selfie used for facial validation.

string
ir

URL of the company income tax return for the latest fiscal year.

string
kyc

URL of the completed and signed KYC form.

string

The resource was returned successfully

object
accountRequestId
required

Identifier of the account creation request.

string
status
required

Current status of the account creation request.

string
object
error
string
message
string
details
Array<object>
object
field
string
issue
string
description
string

Unauthorized Request

object
error
string
message
string
details
Array<object>
object
field
string
issue
string
description
string
object
error
string
message
string
details
Array<object>
object
field
string
issue
string
description
string
object
error
string
message
string
details
Array<object>
object
field
string
issue
string
description
string