Replace Card

post

https://s3partnerapi-staging.solutran.com/2.2/cards/{cardid}/replace

Replaces the specified card if it is valid to replace.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

cardid

int64

required

The id of the card to repalce.

Body Params

Request body for replacing a card.

clientRequestId

string | null

Optional caller-supplied correlation ID. Returned in response headers and logs for end-to-end tracing.

updatedUser

string | null

Username or system identifier of the user performing the update. Used for audit trail.

int64

S3 internal card identifier. Populated from the {cardId} path parameter — do not set manually.

validateOnly

boolean

When true, validates the replacement request without committing changes.
Set to false to execute the replacement.

addressId

int64 | null

S3 internal address identifier to ship the replacement card to. If omitted, the address on file is used.

reasonCode

string

required

length ≥ 1

Reason code for the card replacement (e.g. Lost, Stolen, Damaged, Fraud, RiskMitigation, CardNotReceived). Required.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

content-type

string

enum

Defaults to application/json-patch+json

Generated from available request content types

Allowed:

Responses

202

Accepted

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

text/plain

application/json

text/json

400Bad Request

401Unauthorized

403Forbidden

422Unprocessable Content

500Internal Server Error