These endpoints have a consistent, standard request and response format across all NowBookIt partners. No custom configuration is required beyond standard HMAC authentication setup during onboarding.
NowBookIt proxies these requests to the configured gift card service and returns the result. The response reflects the live state of the card.
POST partners/{partnerName}/giftcards/redeem
Redeem a gift card via NowBookIt from your POS terminal. NowBookIt forwards the redemption request to the configured gift card service.
Path parameters
| Parameter | Description |
|---|
partnerName | Your registered partner identifier |
| Field | Type | Required | Description |
|---|
cardNumber | string | Yes | The gift card number |
amount | number | Yes | Amount to redeem |
locationId | string | Yes | Your NowBookIt location ID |
curl -X POST '[BASE_URL]/partners/mypos/giftcards/redeem' \
--header 'X-Partner-Signature: your_hmac_signature' \
--header 'Content-Type: application/json' \
--data '{
"cardNumber": "ABCDE-12345678-WXYZ",
"amount": 50.00,
"locationId": "loc-9"
}'
| Status | Description |
|---|
200 | Redemption result returned — check response body for outcome |
400 | Empty request body, or signature invalid/missing |
POST partners/{partnerName}/giftcards/balance
Check the current balance of a gift card via NowBookIt from your POS terminal.
Path parameters
| Parameter | Description |
|---|
partnerName | Your registered partner identifier |
| Field | Type | Required | Description |
|---|
cardNumber | string | Yes | The gift card number |
locationId | string | Yes | Your NowBookIt location ID |
curl -X POST '[BASE_URL]/partners/mypos/giftcards/balance' \
--header 'X-Partner-Signature: your_hmac_signature' \
--header 'Content-Type: application/json' \
--data '{
"cardNumber": "ABCDE-12345678-WXYZ",
"locationId": "loc-9"
}'
| Status | Description |
|---|
200 | Balance result returned |
400 | Empty request body, or signature invalid/missing |
