You can check the card status and balance without a Smart Transaction. This is useful if a buyer only asks for the card balance.
The obtain the card details using the card number you need to call GET
/Loyalty/MerchantCards/?q=card.cardnumber:{id}
. You don't need to send a request body.
Request
GET /api/v2/Loyalty/MerchantCards?q=card.cardnumber:9276004428481652 HTTP/1.1
Host: connect-testing.secuconnect.com
Authenticate: Bearer qb56tjj1bcvo9n2nj4u38k84lo
Accept: application/json
You will receive a list of cards. Since you seek for a certain card number, there should be one match or none, for instance for a typo.
Response
HTTP/1.1 200 OK
Content-Type: application/json
{
"count"
: 1,
"data"
: [
{
"object"
:
"loyalty.merchantcards"
,
"id"
:
"MCD_W5ZVSRG8U2MN358FD2MRDCMPYM06AU"
,
"merchant"
: {
"object"
:
"general.merchants"
,
"id"
:
"MRC_WVHJQFQ4JNVYNG5B55TYK748ZCHQP8"
},
"created_for_merchant"
: {
"object"
:
"general.merchants"
,
"id"
:
"MRC_F40KSJYW5AAJHHC93TQ6C7A8X76WO6"
},
"card"
: {
"object"
:
"loyalty.cards"
,
"id"
:
"CRD_3CVJTETZ3MHPR034C9BYGEKDH6XRP4"
,
"cardnumber"
:
"9276004428481652"
,
"created"
:
"2015-02-20T08:54:07+01:00"
},
"cardgroup"
: {
"object"
:
"loyalty.cardgroups"
,
"id"
:
"CRG_2BESGJNETJJRZVVYS8R7JWGVWK4PRZ"
,
"display_name"
:
"Geschenkgutschein"
,
"display_name_raw"
:
"Geschenkgutschein"
,
"stock_warn_limit"
: 0,
"picture"
:
"https://connect.secucard.com/ds_g/8e79737df1e2513db48908b342c3cc436edf501a"
},
"created_for_store"
: {
"object"
:
"general.stores"
,
"id"
:
"STO_2ZCZRU9V6U8QA7B49K94667UP6C4PJ"
},
"is_base_card"
:
false
,
"points"
: 0,
"cash_balance"
: 300,
"bonus_balance"
: 52,
"balance"
: 352,
"last_usage"
:
"2019-09-12T10:52:22+02:00"
,
"last_charge"
:
"2018-04-27T15:47:42+02:00"
,
"stock_status"
:
"inactive"
,
"lock_status"
:
"unlocked"
,
"passcode"
: 1,
"expiry_date"
:
null
}
]
}
The card details are the same like those you receive in the Smart Transaction.
The card in our example has a cash balance of €3.00, a bonus balance of €0.52, making a total balance of €3.52 (line 39-41).
Monetary amounts are expressed in the smallest currency unit (e. g. Euro Cent).
The card is not locked and has no expiry date.