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
}
]
}
}
}| Property | Description | Mandatory / Optional |
|---|---|---|
| StoredValueRequest | Mandatory | |
| SaleData | Same as for Payment reqeust | Mandatory |
| StoredValueData | List, normally one | Optional |
| StoredValueTransactionType | "Load" for load/activation | Mandatory |
| ItemAmount | Amount to be loaded | Optional |
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
}
}
]
}
}
}| Property | Description | Mandatory / Optional |
|---|---|---|
| StoredValueResponse | Mandatory | |
| Response | Mandatory | |
| SaleData | Mandatory | |
| POIData | Mandatory | |
| StoredValueResult | List of results, normally one | Mandatory |
| StoredValueTransactionType | Copy of request | Mandatory |
| ItemAmount | Amount loaded | Mandatory |
| Currency | Copy of request | Mandatory |
| StoredValueAccountStatus | Mandatory | |
| CurrentBalance | Balance of the account, if present or known | Optional |
Updated 13 days ago
Did this page help you?