Como transferir valores sem a rota POST /v2/transaction?

Para simplificar e padronizar o uso das rotas, faremos uma atualização importante em nossa API, em que não será mais possível realizar transferências internas pela rota POST /v2/transaction. 

Importante: essa mudança afeta apenas o envio (POST), a consulta de informações (GET) não será impactada.

Devido a esta mudança, criamos este artigo para te ajudar nesta adaptação.

---

Instruções para transferir valores entre workspaces

A partir de agora, as transferências internas devem ser feitas pela rota POST /v2/transfer.

Por ser interna, alguns dados serão fixos e obrigatórios:

• bankCode: 20018183
• branchCode: 0001
• account_type: "checking"
• taxId: CNPJ da sua empresa
• name: nome fantasia ou razão social da sua empresa

Exemplo POST /v2/transaction (antigo):

POST /v2/transaction
    - amount: “1000”
    - description: “transferencia teste”
    - external_id: "transacao ABC 2025-09-30"
    - receiver_id: "5656565656565656"

Exemplo POST /v2/transfer (novo):

POST /v2/transfer
    - amount: “1000”
    - name: "Anthony Edward Stark"
    - tax_id: "01234567890"
    - bank_code: "20018183"
    - branch_code: “0001”
    - account_number: 5656565656565656
    - account_type: "checking"

Importante: diferentemente da rota de transaction, na qual os parâmetros external_id e receiver_id são obrigatórios, na rota de transfer esses dois campos são opcionais.

A lista completa de parâmetros nessa rota está disponível no GitHub StarkBank.