Create sandbox card token
Issue a short-lived, account-bound card token for a participant in your sandbox. Create a card at the Moov platform with the token, then send the returned payment method ID to the sandbox claim and pay routes.
The token grants only /accounts/{accountID}/cards.write and
/accounts/{accountID}/payment-methods.read. It cannot call the Moov Money
API. The token is bound to the participant’s Moov account.
Returns 200 with the token. Returns 400 when providerID or
participantID is malformed. Returns 401 when your credentials are
missing or invalid. Returns 403 when the target is a production provider;
the sandbox routes run against sandbox providers only. Returns 404 when
the participant is not found or belongs to another provider.
Auth: API key or bearer token. Application callers must use an application
credential authorized for the provider in the path. An affiliated
integrator needs the /accounts/{providerID}/moov-money-participants.write
and /accounts/{providerID}/cards.write grants from the FI.
curl -X POST https://api.moov.money/providers/{providerID}/sandbox/participants/{participantID}/card-token \
-u "$MOOV_API_KEY_ID:$MOOV_API_KEY_SECRET" \
-H "X-Moov-Version: v2026.10.00"{
"accountID": "acc_01HF5J9ZKQT4RXP8M2VYBN3D",
"embedded": {
"accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9",
"expiresIn": 600,
"scope": "/accounts/acc_01HF5J9ZKQT4RXP8M2VYBN3D/cards.write /accounts/acc_01HF5J9ZKQT4RXP8M2VYBN3D/payment-methods.read",
"tokenType": "bearer"
},
"participantID": "3v2whagmwvbujhwbt7v3nl6ffq_user"
}Response body application/problem+json
application/problem+json.
From v2026.10.00, every error response that has a body uses this schema.type
string
requiredhttps://api.moov.money/errors#<code> (for
example invalid-request, idempotency-key-reused, or
idempotency-request-in-progress). Treat the value as
an opaque constant and do not fetch it. about:blank means the HTTP
status code says everything there is to know.title
string
requiredstatus
integer<int32>
requireddetail
stringinstance
stringerrors
array<object>Show child attributes
errors[]
pointer
string
requireddetail
string
requiredRetry-After.Response body application/problem+json
application/problem+json.
From v2026.10.00, every error response that has a body uses this schema.type
string
requiredhttps://api.moov.money/errors#<code> (for
example invalid-request, idempotency-key-reused, or
idempotency-request-in-progress). Treat the value as
an opaque constant and do not fetch it. about:blank means the HTTP
status code says everything there is to know.title
string
requiredstatus
integer<int32>
requireddetail
stringinstance
stringerrors
array<object>Show child attributes
errors[]
pointer
string
requireddetail
string
requiredHeaders
X-Moov-Version
stringv2026.10.00). When omitted, the server applies its default version.Path parameters
providerID
string
requiredparticipantID
string
requiredparticipantID, or your externalID for them. Both
resolve to the same participant.Response
accountID
string
requiredparticipantID
string
requiredembedded
object
requiredShow child attributes
embedded
accessToken
string
requiredexpiresIn
integer<int32>
requiredscope
string
requiredtokenType
string
requiredbearer.