Set Card Funding Sources

post/api/cards/{cardId}/set-funding-sources

Point an existing card at a different Funding Source.

Submit exactly one Funding Source ID. The submitted list replaces the card's existing Funding Sources.

Request

Path Parameters

cardIdstringrequired
ID of card

Body application/json

fundingSourceIdsstring[]required
Funding sources to set on the card. Accepts exactly one entry; a request with none or more than one is rejected.

Response

Successful operation.

Request fields are invalid.

Body application/json

statusCodeintegerrequired
statusNamestringrequired
errorCodestringrequired
errorsobject[]
Items
- messagestring
- pathstring
  The location of the invalid path param, query param or payload attribute.

User is not allowed to perform the action with the reason stated in the message.

FORBIDDEN Insufficient permissions to perform the action, or the card or funding source ID was not found.

CARD_SET_FUNDING_SOURCES_NOT_ALLOWED Setting Funding Sources is not enabled for the account or the card.

Body application/json

statusCodeintegerrequired
statusNamestringrequired
errorCodestringrequired
reasonstring

Example

Example Request

ServerAuthentication

curl 'https://api.immersve.com/api/cards/{cardId}/set-funding-sources' \
  --request POST \
  --header 'Authorization: Bearer <access-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "fundingSourceIds": [
    "057aa15913a57f50577234c8426534c0"
  ]
}'

curl 'https://api.immersve.com/api/cards/{cardId}/set-funding-sources' \
  --request POST \
  --header 'Authorization: Bearer <access-token>' \
  --header 'X-Account-Id: <target-account>' \
  --header 'Content-Type: application/json' \
  --data '{
  "fundingSourceIds": [
    "057aa15913a57f50577234c8426534c0"
  ]
}'

curl 'https://api.immersve.com/api/cards/{cardId}/set-funding-sources' \
  --request POST \
  --header 'X-Api-Key: <api-key>' \
  --header 'X-Api-Secret: <api-secret>' \
  --header 'Content-Type: application/json' \
  --data '{
  "fundingSourceIds": [
    "057aa15913a57f50577234c8426534c0"
  ]
}'

curl 'https://api.immersve.com/api/cards/{cardId}/set-funding-sources' \
  --request POST \
  --header 'X-Api-Key: <api-key>' \
  --header 'X-Api-Secret: <api-secret>' \
  --header 'X-Account-Id: <target-account>' \
  --header 'Content-Type: application/json' \
  --data '{
  "fundingSourceIds": [
    "057aa15913a57f50577234c8426534c0"
  ]
}'

curl 'https://test.immersve.com/api/cards/{cardId}/set-funding-sources' \
  --request POST \
  --header 'Authorization: Bearer <access-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "fundingSourceIds": [
    "057aa15913a57f50577234c8426534c0"
  ]
}'

curl 'https://test.immersve.com/api/cards/{cardId}/set-funding-sources' \
  --request POST \
  --header 'Authorization: Bearer <access-token>' \
  --header 'X-Account-Id: <target-account>' \
  --header 'Content-Type: application/json' \
  --data '{
  "fundingSourceIds": [
    "057aa15913a57f50577234c8426534c0"
  ]
}'

curl 'https://test.immersve.com/api/cards/{cardId}/set-funding-sources' \
  --request POST \
  --header 'X-Api-Key: <api-key>' \
  --header 'X-Api-Secret: <api-secret>' \
  --header 'Content-Type: application/json' \
  --data '{
  "fundingSourceIds": [
    "057aa15913a57f50577234c8426534c0"
  ]
}'

curl 'https://test.immersve.com/api/cards/{cardId}/set-funding-sources' \
  --request POST \
  --header 'X-Api-Key: <api-key>' \
  --header 'X-Api-Secret: <api-secret>' \
  --header 'X-Account-Id: <target-account>' \
  --header 'Content-Type: application/json' \
  --data '{
  "fundingSourceIds": [
    "057aa15913a57f50577234c8426534c0"
  ]
}'

Example Response

No response body.

{
  "statusCode": 400,
  "statusName": "Bad Request",
  "errorCode": "INVALID_REQUEST_INPUT",
  "errors": [
    {
      "message": "Invalid type",
      "path": "items[1].attributes.invalidField"
    }
  ]
}

{
  "statusCode": 403,
  "statusName": "Forbidden",
  "errorCode": "FORBIDDEN",
  "reason": "Unauthorized"
}