Activate and load stored value card

For merchants supporting it, a stored value card can be activated and loaded with a selected amount.

For merchants supporting it, a stored value card can be activated and loaded with a selected amount. If already activated, the balance of the card is increased with the loaded amount.

Funding of the loaded amount is handled separately.

Example StoredValue request to load a giftcard

{
  "SaleToPOIRequest": {
    "MessageHeader": {
      "ProtocolVersion": "3.1",
      "ServiceID": "2",
      "MessageClass": "Service",
      "MessageCategory": "StoredValue",
      "MessageType": "Request",
      "SaleID": "ECR123",
      "POIID": "AT12345"
    },
    "StoredValueRequest": {
      "SaleData": {
        "SaleTransactionID": {
          "TransactionID": "12345678",
          "TimeStamp": "2024-04-18T22:16:13.178+02:00"
        }
      },
      "StoredValueData": [
        {
          "StoredValueTransactionType": "Load",
          "ItemAmount": 100.00
        }
      ]
    }
  }
}
PropertyDescriptionMandatory / Optional
StoredValueRequestMandatory
SaleDataSame as for Payment reqeustMandatory
StoredValueDataList, normally oneOptional
StoredValueTransactionType"Load" for load/activationMandatory
ItemAmountAmount to be loadedOptional

Example StoredValue response to load/activate a giftcard

{
  "SaleToPOIResponse": {
    "MessageHeader": {
      "ProtocolVersion": "3.1",
      "ServiceID": "2",
      "MessageClass": "Service",
      "MessageCategory": "StoredValue",
      "MessageType": "Response",
      "SaleID": "ECR123",
      "POIID": "AT12345"
    },
    "StoredValueResponse": {
      "Response": {
        "AeStan": "123456",
        "AeAcquirerResponseCode": "00",
        "AeResponseCode": "000",
        "AdditionalResponse": "",
        "Result": "Success"
      },
      "POIData": {
        "POITransactionID": {
          "TransactionID": "87654321",
          "TimeStamp": "2024-04-18T22:16:13.478+02:00"
        },
        "POIReconciliationID": "20240418_001"
      },
      "StoredValueResult": [
        {
          "StoredValueTransactionType": "Load",
          "ItemAmount": 100.00,
          "Currency": "EUR",
          "StoredValueAccountStatus": {
            "CurrentBalance": 100.00
           } 
        }
      ] 
    }
  }
}
PropertyDescriptionMandatory / Optional
StoredValueResponseMandatory
ResponseMandatory
SaleDataMandatory
POIDataMandatory
StoredValueResultList of results, normally oneMandatory
StoredValueTransactionTypeCopy of requestMandatory
ItemAmountAmount loadedMandatory
CurrencyCopy of requestMandatory
StoredValueAccountStatusMandatory
CurrentBalanceBalance of the account, if present or knownOptional

Did this page help you?