Developer portal · API v3.2.0
Build loyalty on real payment data
Spaycial turns your members' bank transactions into enriched purchases, rewards and real-time webhooks.
Check your API keyLists the banks open in your programme.
curl https://api.transactionconnect.com/banks -H "Api-Key: $SPAYCIAL_API_KEY"POST https://your-app.example/webhooks/spaycial
{
"event": "all_transactions",
"transactions": [
{
"id": "…",
"rawData": {
"amount": 18.4,
"label": "Monop4761",
"bankingStatementDate": "2025-11-05",
"currency": "EUR",
"transactionType": "card"
},
"spaycialData": {
"customerId": "…",
…
"enrichment": {
"merchant": { "name": "Monoprix" },
"purchaseLocation": {
"city": "Paris",
"pointOfSale": {
"name": "Monop' Taitbout",
"address": "88 Rue La Fayette, 75010 Paris, France",
"latitude": 48.876826,
"longitude": 2.347972
}
}
}
}
}
]
}- Webhooks
- 13 real-time events
- Sandbox
- api-test.transactionconnect.com
- Contract
- OpenAPI 3 spec, generated live
How it works
From bank label to reward.
Five steps between a purchase in a store and the event your platform receives.
- 01Bank transactionA member connects their bank. Each card purchase arrives with its raw bank label.
rawData.label - 02EnrichmentThe label becomes a merchant, a store and an exact location.
spaycialData.enrichment - 03Programme rulesThe offers of the programme check every eligible purchase.
offer - 04RewardProgress on an offer becomes a reward, from started to completed.
reward_updated - 05WebhookYour platform is notified of each change, in real time.
POST /your-endpoint
Guides
Everything you need to ship.
- 01AuthenticationAPI keys for server calls, JWT for member sessions.Read the guide
- 02SignatureSign partner requests and verify what Spaycial sends you.Read the guide
- 03Integration flowsSequence diagrams for subscription, authenticated actions and webhooks.Read the guide
- 04Web UIEmbed the member journeys: onboarding, bank connections and claims.Read the guide
- 05WebhooksThirteen real-time events, each with its payload and fields.See the events
- 06API ReferenceEvery public operation, generated from the live contract.Browse the operations
Webhooks in real time
Your platform, notified as it happens.
Subscribe to the events you need: members, purchases, claims, offers and rewards reach your endpoint as they change.
Webhooks overviewPOST
/your-endpointcustomer_creationContent-Type: application/jsonExpires-at: 1522249849Signature: 0o7LgMnlG7FX5tWLoKd6V5jlktodP8I/3vWq...
{ "event": "customer_creation", "customerExternalId": "4354213424", "customerId": "b84c33cf-62c6-4a44-8692-973cc0cc420c", ...