Build with the Hubble API and SDK.
Sign up on the integration portal to test, go live and run your orders. The docs cover the API and the SDK.
From sign-up
to live orders
Sign up on the portal.
Create your account on the integration portal. Your test environment is ready straight away.
Build and test.
Follow the API or SDK docs against the test environment, and place a test order.
Go live.
Switch to production from the portal when your integration is ready.
Run it.
Track your orders and top up your wallet from the same portal.
Place an order,
get the codes back
A request and response from the API docs, against the staging host. Each referenceId is used once, so retries never create a second order.
curl -X POST "https://api.dev.myhubble.money/v1/partners/orders" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <token>" \
-H "X-REQUEST-ID: 239774a8-f59c-496c-bb52-ceb683d60af3" \
-d '{
"productId": "01GMAW822RPDJ5C50XK24QC2C4",
"referenceId": "ORD-2026-001",
"amount": 1000,
"denominationDetails": [
{ "denomination": 500, "quantity": 2 }
],
"customerDetails": {
"name": "John Doe",
"phoneNumber": "9876543212",
"email": "john@example.com"
}
}'{
"id": "01KJA7HBZAPKDN0VVXTVN6R41H",
"referenceId": "ORD-2026-001",
"status": "SUCCESS",
"vouchers": [
{
"id": "voucher_id",
"cardType": "CARD_AND_PIN_NO_SECURED",
"cardPin": "112233",
"cardNumber": "2359481287412",
"validTill": "2027-02-25",
"amount": 500
},
{
"id": "voucher_id",
"cardType": "CARD_AND_PIN_NO_SECURED",
"cardPin": "445566",
"cardNumber": "2359481287413",
"validTill": "2027-02-25",
"amount": 500
}
],
"failureReason": null
}The API at a glance
- Staging
https://api.dev.myhubble.money- Production
https://api.myhubble.money- Authentication
- A bearer token from
POST /v1/partners/auth/login, usually valid for 3,600 seconds - Every request
- An
X-REQUEST-IDheader with a new UUID - Idempotency
referenceId, up to 40 characters, never reused- Webhooks
- Brand updated · Brand discount update · Order reached terminal state · Wallet low balance
- SDK platforms
- Android · iOS · Web · React Native · Flutter
Tools and updates
Postman collection
Every endpoint, ready to run. Open in Postman
Changelog
API changes and deprecations, newest first. Version history
Security
and data
ISO 27001 certified, with regular security testing (VAPT) by an outside firm. Customer data is stored on Google Cloud in India, encrypted in transit and at rest. We process personal data only for the purpose it was shared for, with the user's consent, as India's DPDP Act requires.