Professional Guide for Integrating TapSenior Family+ Card APIs

GET /partner/verify

This endpoint allows a business system to confirm whether the connected business is a valid TapSenior Network Partner.

curl -X GET "https://YOUR-DOMAIN.com/wp-json/tapsenior/v1/partner/verify" \
  -H "X-TapSenior-API-Key: YOUR_API_KEY"

{
  "success": true,
  "partner": {
    "partner_id": 123,
    "brand_name": "Maple Home Care",
    "category": "Home Care",
    "city": "Calgary",
    "province": "AB",
    "verified": true,
    "payment_status": "paid"
  }
}

POST /cards/validate

Use this endpoint when a customer presents a TapSenior Family+ Card. The partner system can check card status, member details, available points, and available credit.

*Send either card_id/card_code or email.

curl -X POST "https://YOUR-DOMAIN.com/wp-json/tapsenior/v1/cards/validate" \
  -H "X-TapSenior-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"card_id":"TS12345"}'

{
  "success": true,
  "card": {
    "card_id": "TS12345",
    "full_name": "John Smith",
    "status": "active",
    "available_points": 1200,
    "available_credit": 30,
    "redeem_rule": "200 points = $5 credit"
  }
}

POST /cards/create

This endpoint allows a verified partner to create a TapSenior Family+ Card for a senior customer directly from the partner’s own system.

curl -X POST "https://YOUR-DOMAIN.com/wp-json/tapsenior/v1/cards/create" \
  -H "X-TapSenior-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "full_name":"Mary Johnson",
    "email":"mary@example.com",
    "phone":"4035551234",
    "city":"Calgary",
    "province":"AB"
  }'

{
  "success": true,
  "created": true,
  "card": {
    "card_id": "TS45821",
    "full_name": "Mary Johnson",
    "status": "active"
  },
  "pin_code": "123456"
}

POST /points/earn

Use this endpoint after a senior customer completes a purchase. TapSenior records points based on the rule: $1 spent = 1 point.

curl -X POST "https://YOUR-DOMAIN.com/wp-json/tapsenior/v1/points/earn" \
  -H "X-TapSenior-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "card_id":"TS12345",
    "invoice_number":"INV-1001",
    "invoice_amount":150,
    "service_brand":"TapSenior"
  }'

{
  "success": true,
  "points_added": 150,
  "card": {
    "available_points": 1350,
    "available_credit": 33
  }
}

POST /points/redeem

Use this endpoint when a customer uses TapSenior Family+ points to receive credit or benefits from a partner business. The API checks available points, records the redemption, and creates commission tracking.

curl -X POST "https://YOUR-DOMAIN.com/wp-json/tapsenior/v1/points/redeem" \
  -H "X-TapSenior-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "card_id":"TS12345",
    "invoice_number":"INV-1002",
    "redeem_amount":5,
    "system_commission":10,
    "note":"Redeemed at partner location"
  }'

{
  "success": true,
  "redeemed": true,
  "points_used": 200,
  "commission": {
    "commission_rule": "partner_a_60_tapsenior_40",
    "partner_a_commission": 6,
    "admin_commission": 4
  }
}

GET /transactions

This endpoint returns redemption and commission-related transactions where the authenticated partner is either the service partner or the card-issuing partner.

curl -X GET "https://YOUR-DOMAIN.com/wp-json/tapsenior/v1/transactions?limit=50" \
  -H "X-TapSenior-API-Key: YOUR_API_KEY"

GET /commission

This endpoint shows the partner’s commission wallet and commission history earned from cards issued by that partner.

curl -X GET "https://YOUR-DOMAIN.com/wp-json/tapsenior/v1/commission" \
  -H "X-TapSenior-API-Key: YOUR_API_KEY"

{
  "success": true,
  "wallet": {
    "earned_commission": 320,
    "pending_withdrawal": 0,
    "paid_commission": 100,
    "available_commission": 220,
    "minimum_withdrawal": 100,
    "can_request_withdrawal": true
  },
  "history": []
}

GET /customers/lookup

Use this endpoint to find a TapSenior Family+ customer by card number, email, or phone.

curl -X GET "https://YOUR-DOMAIN.com/wp-json/tapsenior/v1/customers/lookup?email=mary@example.com" \
  -H "X-TapSenior-API-Key: YOUR_API_KEY"

GET /directory

This endpoint allows websites, apps, or partner systems to display TapSenior Network partners by search keyword, city, category, and verification status.

curl -X GET "https://YOUR-DOMAIN.com/wp-json/tapsenior/v1/directory?city=Toronto&category=Senior%20Transportation&verified_only=true" \
  -H "X-TapSenior-API-Key: YOUR_API_KEY"

GET /payout

Returns commission wallet and withdrawal history for the authenticated partner.

curl -X GET "https://YOUR-DOMAIN.com/wp-json/tapsenior/v1/payout" \
  -H "X-TapSenior-API-Key: YOUR_API_KEY"

POST /payout/request

Creates a withdrawal request. The minimum withdrawal amount is $100.

curl -X POST "https://YOUR-DOMAIN.com/wp-json/tapsenior/v1/payout/request" \
  -H "X-TapSenior-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount":150,
    "payment_note":"Please send by e-transfer to partner@example.com"
  }'