Connect your service
Send a phone number, amount, and order reference. Receive the result as JSON.
Appearance
Taura XashpayOffer Taura top-ups in your business
Send top-ups to phone numbers and track every result through one REST API.
Skip to content
Taura top-ups for vendors
Taura Xashpay lets vendors add Taura top-ups to a point-of-sale system, website, app, or backend. The API uses JSON and Bearer-token authentication.
Get started
- Contact Xash support to request access.
- Sign in and create a Bearer token under Profile & API Keys.
- Make sure your wallet has enough
UNITS. - Send the recipient, amount, and your unique reference.
See Access & API keys to request access or create a token. If you already have a token, start with the API overview.
Create a Taura top-up
bash
curl --request POST "https://taura.xashpay.com/api/v1/taura/topups" \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer TOKEN" \
--data '{
"recipient": "+263775696233",
"units": 25.00,
"ref": "ORDER-10045"
}'The response includes the top-up ID and status. Keep your ref with the customer order. See Top-ups for request fields and status handling.
What you can do
- Create and list Taura top-ups.
- Check your wallet balance and transaction history.
- View funding history.
- Read summary totals for reporting.
Frequently asked questions
How do I get access to the Taura Xashpay API?
Contact Xash support. Once access is confirmed, sign in at taura.xashpay.com and create a Bearer token under Profile & API Keys.
How are top-ups paid for?
Top-ups use the available UNITS in your wallet. Contact Xash support if you need help funding the wallet.
Can I retry after a network error?
Yes. Send the same ref for the same customer request. The API returns the existing top-up instead of creating another one.
Where can I track activity?
Use the API or the Taura Xashpay panel to review top-ups and wallet activity.