Skip to content
Vaki API

Vaki API

Create a cause, mint a checkout link, and collect where your donors already are — local rails in Colombia and Mexico, cards from anywhere in the world. Two endpoints, one HTTP call to your first live donation.
Quickstart API reference
Terminal window
curl https://api.vaki.cohttps://public-api-staging.vaki.co/v1/checkout_links \
  -H "Authorization: Bearer $VAKI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "vaki": "clinicalaliga", "amount": 50000, "currency": "COP" }'

Raising in the United States Coming soon

Vaki USA Foundation is an IRS-approved 501(c)(3). The route we are building is an entity-scoped API key: a Foundation key creates causes that collect into the Foundation, so which entity receives the money is decided by the credential you hold — not by a flag on every request you have to remember to set.

A US donor then gives in USD to a US entity — a domestic charge, with no currency conversion and none of the cross-border spread a card pays reaching an entity abroad. What does not exist yet is the part your donors’ taxes would need: Vaki does not issue US donor acknowledgments, Foundation-scoped keys are not issuable today, and whether a gift counts as a gift to the Foundation turns on the Foundation exercising discretion and control over the funds — not on which account they land in. So please do not promise your donors a tax outcome on Vaki’s behalf yet.

Planning a campaign for US donors? Write to hi@vaki.org before you launch and we will tell you exactly where this stands. The mechanism, and the constraint in full, are on US giving via the Vaki USA Foundation.

Local rails, not just cards

In Colombia donors pay with PSE or a card; in Mexico, PayPal; anywhere else, a card. You get one hosted checkout URL and never touch a payment credential.

Your reference, end to end

Send external_reference and it comes back on the checkout link and on the resulting payment, so reconciliation is a join, not a reconciliation project.

5% flat

One number. Vaki absorbs the gateway’s own cost — the donor is never charged a separate processing fee. See Fees.

Honest about what isn't built

Eight endpoints on this site are badged Coming soon with the contract we intend to ship. Nothing here 500s to teach you a lesson.

Start here

Section titled “Start here”
Quickstart From an API key to a live checkout URL in under five minutes.
Accept a donation from your own site You already have a checkout route that returns a URL. This replaces its body.
Known limitations What doesn't work yet, in writing, before it costs you an afternoon.

Stuck at 2am?

Section titled “Stuck at 2am?”
Lola Informa, Vaki's integration assistant

Ask Lola Informa Coming soon

Lola is Vaki’s integration assistant. She’ll answer questions about these endpoints from the published spec — and tell you when she doesn’t know rather than inventing a parameter. Until she’s here, email lola@vaki.co and a human replies.