Documentação
Agente de Pagamento

Atualizar Definições do Cliente

PatchAutenticação necessária

Atualiza a preferência do cliente autenticado quanto à possibilidade de os agentes de pagamento verem o seu nome verdadeiro nas transações. Defina show_real_name como true para o revelar ou false para o ocultar; as definições atualizadas são devolvidas. A primeira interação de um cliente com um agente de pagamento regista a sua conta, pelo que alguns erros 400 e 500 apenas ocorrem nessa primeira chamada.

Endpoint

Patch/payment-agents/v1/clients/me

URL Base: https://api.derivws.com

Códigos de Estado

200OK - Returns the updated client settings.
400Bad request - One of: NoClientWallet, InputError.
401Unauthorized - Invalid or missing authentication.
403Forbidden - Valid token but insufficient scope (payment scope required).
500Internal server error - One of: ClientIdentityLookupFailed, WalletLookupFailed, InternalError.
504Gateway timeout - Upstream service unavailable.

Respostas de Erro

400Bad request - no wallet available (first-ever call)
{
  "data": {},
  "errors": [
    {
      "status": 400,
      "code": "NoClientWallet",
      "detail": { "message": "The client has no wallet available for payment-agent transactions" }
    }
  ],
  "metadata": {
    "endpoint": "/payment-agents/v1/clients/me",
    "method": "PATCH",
    "timing": 12
  }
}

Acerca de Atualizar Definições do Cliente

O endpoint PATCH /payment-agents/v1/clients/me: Atualiza a preferência do cliente autenticado quanto à possibilidade de os agentes de pagamento verem o seu nome verdadeiro nas transações. Defina show_real_name como true para o revelar ou false para o ocultar; as definições atualizadas são devolvidas. A primeira interação de um cliente com um agente de pagamento regista a sua conta, pelo que alguns erros 400 e 500 apenas ocorrem nessa primeira chamada.

Click to open live chat support. Get instant help from our support team.