Enable spending of cUSD on products and services
This section explains how to unleash utility for your token by enabling in-app spending in your web or mobile app.
Last updated
This section explains how to unleash utility for your token by enabling in-app spending in your web or mobile app.
Last updated
Create an account at
Email support@chimoney.io to request "Verification and API Access". Include links to your website and tell us a little more about your use case. Alternatively, DM @uchiuchibeke on Twitter
Pick a Chimoney API Plan and pay the subscription fee
Once you are approved, follow the steps below to integrate:
Get products and services with the endpoint
Initiate a spend using the endpoint.
You're not charged for this
Depending on the type of purchase/spend, you need to include certain fields
Gift Card must have a type=giftcard and redeemData object with the productId and countryCode fields set. productId and countryCode fields come from set 4.1 above
Mobile money must have a type=momo and momoCode, phoneNumber and email field. These come from 4.1
Airtime must have a type=airtime and country and phoneNumber field. Country is iso country code and can be gotten from endpoint. These come from 4.1
Create a CELO transaction that delivers cUSD to Chimoney's address. Include the issueID as an stringified object in the transaction comment eg {issueID: issueID}. The issueID is returned from step 3.2 above
Submit and confirm the transaction
After confirmation, redirect to where TXID is the celo transaction hash/id
The product is instantly delivered to the user after we confirm the payment, in most cases. For Gift Cards, we use the emails passed in redeemData and for Airtime and Mobile Money, we use phoneNumber.
Other considerations
in supported countries is not enabled by default but we support 10+ countries. Email us to enable the addon
Get live exchange rate for the country using
For support or payment issues, users will usually and we will handle any issues from our end