Skip to navigation
API ReferencePayment Accounts

Add a payment account

Add a payment account.

Credential: Customer session

Before you call

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

Catalog-required fields are enforced and duplicate identities return PAYMENT_METHOD_ALREADY_EXISTS.

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.
409CONFLICTRead the current state again before you prepare or retry.
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.

Request

This endpoint expects an object.
paymentMethodIdstringRequired
datamap from strings to stringsRequired
displayLabelstringOptional<=100 characters

Response

Created
idstring

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
409
Conflict Error
503
Service Unavailable Error