Skip to navigation
API ReferencePayment Accounts

Update a payment account

Update a payment account.

Credential: Customer session

Before you call

  • A customer session for the same partner, integration, customer, wallet and chain.

paymentMethodId and the catalog identity value are immutable. Changes to data or reactivation recheck the enabled catalog method and required fields. An unavailable method returns 400 VALIDATION_ERROR; unreadable catalog or stored account data can return 502 UPSTREAM_ERROR. Setting isActive false skips reactivation checks.

Confirm with Sinbad that this endpoint is enabled in your environment.

Errors

StatusCodeWhat to do
400VALIDATION_ERRORCorrect the fields reported in details before retrying.
401UNAUTHENTICATEDCreate a new customer session or use a valid server credential.
403FORBIDDENCheck credential ownership, integration and the supplied Origin.
404NOT_FOUNDCheck the resource ID. A resource that belongs to someone else also returns 404.
409CONFLICTRead the current state again before you prepare or retry.
502UPSTREAM_ERRORRetry with backoff and quote requestId if it persists. For transaction reports, retry the same hash without sending another transaction.
503UPSTREAM_ERRORRetry with backoff; preserve the same idempotency key for a repeated mutation.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

idstringRequired

Request

This endpoint expects an object.
displayLabelstringOptional<=100 characters
isActivebooleanOptional
datamap from strings to stringsOptional

Response

Updated
idstring
updatedboolean

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
502
Bad Gateway Error
503
Service Unavailable Error