Skip to content
Developers
Get started
Early access: these pages are being written and reviewed. Facts in the header boxes come straight from the product.

Start a wallet top-up

POST
/api/v1/billing/wallet/topups
curl --request POST \
--url https://api.pitch2sale.com/api/v1/billing/wallet/topups \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "pack_id": "usd_10", "phone_e164": "example" }'

Body { pack_id } only (USD usd_10/usd_25/usd_50, INR inr_500/inr_2000/inr_5000; the pack must match the wallet currency; any other field, including an amount, is 400). Creates a Cashfree one-time order at the pack’s server-side amount plus 18% GST for INR, and returns the payment_session_id for checkout. The wallet is credited only from a verified Cashfree payment. Owners and admins on an active Essentials, Growth or Scale plan; 403 wallet_not_in_plan otherwise (trial: start your plan). 502 gateway_unavailable when Cashfree is unreachable.

Media typeapplication/json
object
pack_id
required
string
Allowed values: usd_10 usd_25 usd_50 inr_500 inr_2000 inr_5000
phone_e164
string
/^\+[1-9]\d{7,14}$/

OK

Validation failed

Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"details": [
{
"field": "example",
"message": "example",
"code": "example"
}
]
}

Authentication required or token invalid

Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"details": [
{
"field": "example",
"message": "example",
"code": "example"
}
]
}

Role permission or token scope missing; OAuth app tokens are not accepted on this route

Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"details": [
{
"field": "example",
"message": "example",
"code": "example"
}
]
}

Rate limit exceeded

Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"details": [
{
"field": "example",
"message": "example",
"code": "example"
}
]
}