Create Donation

Create a donation checkout session for a creator.

POST
/donation/create
x-api-key<token>

API key used for authentication

In: header

amountnumber

Donation amount in dollars (e.g. 5.00 for $5.00)

Range0.01 <= value
currencystring

Currency code (ISO 4217). Must be a valid Stripe-supported currency.

Value in"aed" | "afn" | "all" | "amd" | "ang" | "aoa" | "ars" | "aud" | "awg" | "azn" | "bam" | "bbd" | "bdt" | "bgn" | "bif" | "bmd" | "bnd" | "bob" | "brl" | "bsd" | "bwp" | "byn" | "bzd" | "cad" | "cdf" | "chf" | "clp" | "cny" | "cop" | "crc" | "cve" | "czk" | "djf" | "dkk" | "dop" | "dzd" | "egp" | "etb" | "eur" | "fjd" | "fkp" | "gbp" | "gel" | "gip" | "gmd" | "gnf" | "gtq" | "gyd" | "hkd" | "hnl" | "hrk" | "htg" | "huf" | "idr" | "ils" | "inr" | "isk" | "jmd" | "jpy" | "kes" | "kgs" | "khr" | "kmf" | "krw" | "kyd" | "kzt" | "lak" | "lbp" | "lkr" | "lrd" | "lsl" | "mad" | "mdl" | "mga" | "mkd" | "mmk" | "mnt" | "mop" | "mro" | "mur" | "mvr" | "mwk" | "mxn" | "myr" | "mzn" | "nad" | "ngn" | "nio" | "nok" | "npr" | "nzd" | "pab" | "pen" | "pgk" | "php" | "pkr" | "pln" | "pyg" | "qar" | "ron" | "rsd" | "rub" | "rwf" | "sar" | "sbd" | "scr" | "sek" | "sgd" | "shp" | "sle" | "sll" | "sos" | "srd" | "std" | "stn" | "szl" | "thb" | "tjs" | "top" | "try" | "ttd" | "twd" | "tzs" | "uah" | "ugx" | "usd" | "uyu" | "uzs" | "vnd" | "vuv" | "wst" | "xaf" | "xcd" | "xof" | "xpf" | "yer" | "zar" | "zmw" | "zwl"
donorName?string

Donor name

donorEmail?string
message?string

Donation message

Lengthlength <= 500

Response Body

application/json

application/json

curl -X POST "https://loading/api/v1/donation/create" \  -H "Content-Type: application/json" \  -d '{    "amount": 0.01,    "currency": "aed"  }'
{
  "id": "test-donation-id",
  "amount": 1000,
  "currency": "usd",
  "donorName": "Test Donor",
  "donorEmail": "[email protected]",
  "message": "Test donation",
  "createdAt": "2025-11-30T19:52:04.898Z"
}
{
  "error": "string",
  "code": "string",
  "details": {}
}