curl "https://app.talkover.ai/api/v1/auto-topup/payment-methods" \
-H "Authorization: Bearer talq_your_environment_token_here"
{
"success": true,
"data": [
{
"id": "pm_uuid_1",
"type": "card",
"card": {
"brand": "visa",
"last4": "4242",
"exp_month": 12,
"exp_year": 2027
},
"is_default": true,
"created_at": "2024-01-01T10:00:00Z"
},
{
"id": "pm_uuid_2",
"type": "card",
"card": {
"brand": "mastercard",
"last4": "5555",
"exp_month": 8,
"exp_year": 2026
},
"is_default": false,
"created_at": "2024-01-05T14:00:00Z"
}
]
}
Billing & Auto Topup
List Payment Methods
List saved payment methods available for auto topup
GET
/
api
/
v1
/
auto-topup
/
payment-methods
curl "https://app.talkover.ai/api/v1/auto-topup/payment-methods" \
-H "Authorization: Bearer talq_your_environment_token_here"
{
"success": true,
"data": [
{
"id": "pm_uuid_1",
"type": "card",
"card": {
"brand": "visa",
"last4": "4242",
"exp_month": 12,
"exp_year": 2027
},
"is_default": true,
"created_at": "2024-01-01T10:00:00Z"
},
{
"id": "pm_uuid_2",
"type": "card",
"card": {
"brand": "mastercard",
"last4": "5555",
"exp_month": 8,
"exp_year": 2026
},
"is_default": false,
"created_at": "2024-01-05T14:00:00Z"
}
]
}
List Payment Methods
List the payment methods saved on your environment that can be used for auto topup recharges. Currently only card-based methods are supported.Endpoint
GET /api/v1/auto-topup/payment-methods
Request headers
string
required
Bearer token. Format:
Bearer talq_your_environment_token_hereExamples
curl "https://app.talkover.ai/api/v1/auto-topup/payment-methods" \
-H "Authorization: Bearer talq_your_environment_token_here"
Response
{
"success": true,
"data": [
{
"id": "pm_uuid_1",
"type": "card",
"card": {
"brand": "visa",
"last4": "4242",
"exp_month": 12,
"exp_year": 2027
},
"is_default": true,
"created_at": "2024-01-01T10:00:00Z"
},
{
"id": "pm_uuid_2",
"type": "card",
"card": {
"brand": "mastercard",
"last4": "5555",
"exp_month": 8,
"exp_year": 2026
},
"is_default": false,
"created_at": "2024-01-05T14:00:00Z"
}
]
}
Response fields
string
required
Payment method ID. Use this in
payment_method_id when configuring auto topup.string
required
Always
card currently.string
Card brand (e.g.,
visa, mastercard, amex).string
Last 4 digits of the card.
integer
Expiration month (1–12).
integer
Expiration year (YYYY).
boolean
Whether this is the default payment method.
Notes
- New payment methods can be added through the dashboard checkout flow — there is no API endpoint to add cards.
- Cards are tokenized — the full card number is never returned by the API.
Was this page helpful?