Skip to main content
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

​
Authorization
string
required
Bearer token. Format: Bearer talq_your_environment_token_here

​
Examples

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

​
data[].id
string
required
Payment method ID. Use this in payment_method_id when configuring auto topup.
​
data[].type
string
required
Always card currently.
​
data[].card.brand
string
Card brand (e.g., visa, mastercard, amex).
​
data[].card.last4
string
Last 4 digits of the card.
​
data[].card.exp_month
integer
Expiration month (1–12).
​
data[].card.exp_year
integer
Expiration year (YYYY).
​
data[].is_default
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.