Build a custom integration

​

High-level flow

1. Identify the customer. Look up or create a LoyaltyDog customer by email, phone, or a custom identifier.
2. Record activity. Post a transaction so the program’s rules credit points or issue rewards.
3. Surface state back to the user. Fetch the wallet pass URL, point balance, or gift card balance to display in your UI.

​

A minimal example

# 1. Create or find the customer
curl -sS -X POST "$LOYALTYDOG_API_URL/customers" \
  -H "Authorization: Bearer $LOYALTYDOG_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "programId": "prog_123",
    "email": "[email protected]"
  }'

# 2. Award points for a sale
curl -sS -X POST "$LOYALTYDOG_API_URL/loyalty/programs/prog_123/transactions" \
  -H "Authorization: Bearer $LOYALTYDOG_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "cust_456",
    "type": "earn",
    "amount": 5000,
    "currency": "USD",
    "reference": "order_789"
  }'

​

Best practices

• Make calls idempotent. Use your own order or transaction ID in the reference field so retries don’t double-credit.
• Handle 429s gracefully. Back off when you see rate-limit responses and respect the Retry-After header.
• Subscribe to webhooks. Don’t poll for state changes — let LoyaltyDog notify you. See Webhooks.
• Scope tokens per integration. Use a dedicated app key for each integration so you can rotate or revoke without impacting other systems.

​

Reference