Wishbone Developer Docs

Wishbone lets cardholders convert loyalty and credit card reward points into donations for schools. These docs cover two integration surfaces: the Bank / Issuer API (server-to-server, used by your backend) and the Donation Portal API (used by the cardholder-facing web portal).

Base URL

https://api.getwishbone.io/v1

Two Integration Surfaces

Bank / Issuer API

Server-to-server. Banks link cardholders, submit donation requests, browse schools, and embed the Wishbone UI via iframe or deep link.

Donation Portal API

Cardholder-facing. Used by the Wishbone web portal for login, donation history, receipt management, school browsing, and preferences.

Wishbone Is Not In Funds Flow

Wishbone does not move money. Banks pass a dollar-equivalent value with each donation request. The school receives funds directly from the bank's redemption processing. Wishbone records the transaction, routes metadata, and provides confirmation webhooks.

Response Envelope

{
  "success": true,
  "data": { ... },
  "meta": {
    "request_id": "req_01HX...",
    "timestamp": "2026-05-07T14:22:00Z"
  }
}
// On error:
{
  "success": false,
  "error": {
    "code": "ACCOUNT_NOT_FOUND",
    "message": "No linked account found for the provided wishbone_user_id.",
    "status": 404
  },
  "meta": { "request_id": "req_01HX..." }
}