Load Card

Add funds to a card

post

https://emea.gsc.verifone.cloud/oidchttps://us.gsc.verifone.cloud/oidchttps://nz.gsc.verifone.cloud/oidchttps://cst.test-gsc.vfims.com/oidchttps://uscst-gb.gsc.vficloud.net/oidc

/api/v2/transactions/stored-value-card/load

Load a card with given value. This is to be used for load, reload, top-up, deposit operations.

Authorizations

BearerAuthBasicAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Header parameters

x-vfi-api-idempotencykeystringOptional

Example: 63bbc548-d2de-4546-b106-880a5018461c

A value you specify that uniquely identifies this transaction. This must be used to trigger a reversal if there is a timeout.

Body

application/json

or

Responses

201

Response for gift card transactions

application/json

400

Bad Request

application/json

401

Unauthorised

application/json

403

Forbidden

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

post

/api/v2/transactions/stored-value-card/load

HTTPcURLJavaScriptPython

POST /oidc/api/v2/transactions/stored-value-card/load HTTP/1.1
Host: emea.gsc.verifone.cloud
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 561

{
  "payment_provider_contract": "30b8bec8-5042-4e67-939c-5453fbe41711",
  "customer": "0a57b387-2ba7-4f65-be2f-e176bb49d2ce",
  "invoice_number": "text",
  "merchant_reference": "7a1db7a8-6f24-4bc5-a51b-cef33fc05140",
  "dynamic_descriptor": "text",
  "shopper_interaction": "ECOMMERCE",
  "currency_code": "AED",
  "card_brand": "text",
  "promo_code": "text",
  "amount": 0,
  "encrypted_card": "U3dhZ2dlciByb2Nrcw==",
  "token_preference": {
    "token_scope": "0e48425a-f1bc-431a-b7d8-f866de8ba276",
    "reuse_token_type": "INTERNAL",
    "token_type": "REUSE",
    "token_expiry_date": "2026-06-13"
  },
  "public_key_alias": "text"
}

{
  "id": "text",
  "balance_amount": 1,
  "created_at": "2026-06-13T15:53:04.707Z",
  "customer": "text",
  "invoice_number": "text",
  "merchant_reference": "text",
  "processor": "text",
  "processor_reference": "text",
  "processor_details": {},
  "status": "INITIATED",
  "status_reason": "text",
  "arn": "text",
  "authorization_code": "5B1D4C",
  "rrn": "text",
  "reason_code": "text",
  "shopper_interaction": "ecommerce",
  "stan": 1,
  "promo_code": "text",
  "token_details": {
    "reuse_token": "text",
    "reuse_token_type": "CHASE",
    "analytics_token": "text",
    "token_expiry_date": "2026-06-13",
    "token_scope": "123e4567-e89b-12d3-a456-426614174000",
    "token_status": "DELETED",
    "created_at": "2026-06-13",
    "updated_at": "2026-06-13",
    "variant": "NEW_WORLD",
    "type": "CREDIT",
    "issuer_name": "HSBC",
    "issuer_country": "ZZZ",
    "brand": "VISA",
    "expiry_year": 2021,
    "expiry_month": 12,
    "card_holder_name": "MR J HOLDER",
    "last_four": "3127",
    "bin": "492912",
    "currency_code": "AED"
  },
  "card_details": {
    "masked_card_number": "520000****1096",
    "expiry_year": 2024,
    "expiry_month": 12
  },
  "amount": 0,
  "additional_data": {
    "acquirer_response_code": "0000",
    "acquirer_response_message": "text",
    "acquirer_authorizing_network_id": "text",
    "acquirer_authorizing_network_id_descriptor": "text",
    "settlement_date": "2026-06-13",
    "issuer_receipt_text": "text"
  }
}