Contas conectadas
Criar e gerir contas conectadas, capabilities, requirements e pessoas associadas.
Nesta página
Uma conta conectada representa um negócio que recebe pagamentos através da sua plataforma. A conta pertence sempre à plataforma que a criou e ao ambiente em que foi criada.
Endpoints
| Método | Endpoint | Descrição |
|---|---|---|
| POST | /v1/connected_accounts | Cria uma conta conectada. |
| GET | /v1/connected_accounts | Lista as contas conectadas do ambiente. |
| GET | /v1/connected_accounts/:id | Lê uma conta conectada. |
| POST | /v1/connected_accounts/:id | Actualiza dados da conta conectada. |
| GET | /v1/connected_accounts/:id/persons | Pessoas associadas à conta. |
| POST | /v1/connected_accounts/:id/persons | Associa uma pessoa à conta. |
Criar
curl -X POST https://api.rivox.co.mz/v1/connected_accounts \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: acct-000031" \
-d '{
"name": "Padaria Central",
"legal_name": "Padaria Central, Lda",
"entity_type": "registered_company",
"country": "MZ",
"email": "financeiro@padariacentral.co.mz",
"default_currency": "MZN"
}'Capabilities e requirements
Cada conta conectada tem capabilities (payments, transfers, payouts) com estado inactive, pending ou active, e uma lista de requirements agrupada por currently_due, eventually_due e past_due.
Activação
Concluir a verificação de identidade satisfaz requirements; não activa capabilities por si só. A activação é decidida pela revisão Rivox e do banco parceiro.Pessoas
- Relações suportadas:
owner,representative,director,ubo,authorised_admin. - Cada pessoa é única por conta e relação; associar duas vezes não cria duplicados.
- O estado de identidade de cada pessoa é devolvido em identity_status.