Documentacao APISandbox e producao com o mesmo contrato
Accounts / Multiacesso

Vincular conta

Vincula uma conta a um acesso.

POST/hb/multi-access/accounts/:id/link-account

Requisicao

AutenticacaomTLS + Bearer Token
AmbienteDefinido pelo certificado
ContaNao exige header de conta
IdempotenciaNao aplicavel

Campos obrigatorios

accountIdfintechId

Valores aceitos

relationTypeMAIN | PAYMENT | VIEWER | OPERATOR

Body exemplo

{
  "accountId": "01HZX9Z8Q3H9W6N5K2A1B4C7D8E",
  "fintechId": "01JA1B2C3D4E5F6G7H8I9J0K",
  "relationType": "OPERATOR"
}

Exemplos de execucao

curl -X POST 'https://uzepay-mtls.deploy.pixland.com.br/hb/multi-access/accounts/:id/link-account' \
  -H 'Authorization: Bearer <TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
  "accountId": "01HZX9Z8Q3H9W6N5K2A1B4C7D8E",
  "fintechId": "01JA1B2C3D4E5F6G7H8I9J0K",
  "relationType": "OPERATOR"
}'

Resposta exemplo

200 OK
{
  "link": {
    "accessId": "01JW...",
    "accountId": "01HZX...",
    "relationType": "OPERATOR"
  }
}