STstarkbank
Verified Account

Create Verified Accounts

This route is used to verify that a bank account belongs to the informed tax ID before you send money to it. For each account, inform either the receiver's Pix key or the receiver's full bank details. Sending both in the same account is not allowed, and sending neither is not allowed either. You can create up to 100 Verified Accounts in a single request. NOTE:Verification is done with a real R$0.01 transfer to the receiver. It appears in your Transfer list tagged with the Verified Account id and is charged your usual transfer fee. NOTE:It is not possible to create more than three Verified Accounts for the same tax ID within 24 hours. Failed and canceled Verified Accounts do not count towards this limit.

post/v2/verified-account

Request

  • Base URL
    https://api.starkbank.com
  • URL
    https://api.starkbank.com/v2/verified-account
  • Auth
    API key in header Digital-Signature

Request body

taxIdstring required

Receiver CPF (11 digits formatted or unformatted) or CNPJ (14 digits formatted or unformatted). Example: "012.345.678-90"

bankCodestring required

Required when verifying with bank details. Receiver bank ISPB (8 digits) or bank code (1 to 3 digits). Example: "20018183" or "341"

branchCodestring required

Required when verifying with bank details. Receiver bank account branch. Use "-" in case there is a validation digit. Example: "1234-5"

keyIdstring required

Required when verifying with a Pix key. The receiver's Pix key, which can be a CPF, a CNPJ, an email, a phone or an EVP. Example: "arya.stark@starkbank.com"

namestring required

Required when verifying with bank details. Receiver full name, with at least 3 characters. Example: "Arya Stark"

numberstring required

Required when verifying with bank details. Receiver bank account number. Use "-" before the validation digit. Example: "76543-8"

typestring required

Required when verifying with bank details. Receiver bank account type. Options are "checking", "savings", "salary" and "payment". Example: "checking"

tagsstring[]

Array of up to 100 strings to tag the entity for future queries. Each tag can have up to 100 characters and all tags will be converted to lowercase. Example: ["daenerys", "invoice/1234"]

Response

Successful operation

object required

Changes

No recorded changes to this operation across all 1 revision of this API.