Documentación
Agente de Pago

Actualizar la Configuración del Cliente

PatchRequiere autenticación

Actualiza la preferencia del cliente autenticado sobre si los agentes de pago pueden ver su nombre real en las transacciones. Establezca show_real_name en true para revelarlo o en false para ocultarlo; se devuelve la configuración actualizada. La primera interacción de un cliente con un agente de pago registra su cuenta, por lo que algunos errores 400 y 500 solo ocurren en esa primera llamada.

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.

Respuestas de Error

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 Actualizar la Configuración del Cliente

El endpoint PATCH /payment-agents/v1/clients/me: Actualiza la preferencia del cliente autenticado sobre si los agentes de pago pueden ver su nombre real en las transacciones. Establezca show_real_name en true para revelarlo o en false para ocultarlo; se devuelve la configuración actualizada. La primera interacción de un cliente con un agente de pago registra su cuenta, por lo que algunos errores 400 y 500 solo ocurren en esa primera llamada.

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