Listele

API anahtarı: Payment

Bu kimlik bilgisinin görebildiği kanalları, en yeniden eskiye doğru döndürür. Kendi müşteri kayıtlarınızı bizimkilerle mutabık kılmak veya atadığınız external_id ile bir kanalı bulmak için kullanın.

Sorgu parametreleri

Parametre	Tip	Varsayılan	Açıklama
limit	integer	20	1 ile 100 arasında sayfa boyutu.
cursor	string	—	Bir önceki sayfanın next_cursor değerinden gelen opak imleç.
status	string	—	active, blocked veya provisioning. Tekrarlanabilir; aynı değerin iki kez verilmesi reddedilir.
external_id	string	—	Oluşturma sırasında verdiğiniz kimlikle tam eşleşme.
project_id	string	—	Tek bir projeyle sınırlar (prj_…).

Başka her parametre reddedilir. external_order_id yoktur; created_from / created_to da yoktur — bunlar faturalara ve çekimlere aittir, kanallara değil.

Örnek

GET /v1/payment-channels?limit=50&status=active&status=provisioning HTTP/1.1
Host: api.paymos.io
Authorization: HMAC-SHA256 pk_live_…:…
X-Request-Timestamp: 1767225660

Yanıt (200 OK)

{
  "items": [
    {
      "id": "pc_2QhKZv6mRt9WdA3nYpLbXf",
      "project_id": "prj_xFukZuAJZR06pLVBh3uwzv",
      "external_id": "customer-42",
      "status": "active",
      "is_accepting_payments": true,
      "is_fully_provisioned": false,
      "is_test": false,
      "applied_fee_percent": 1.0,
      "customer_fee_percent": 0,
      "networks": [
        {
          "network": "TRC20",
          "status": "active",
          "address": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
          "tokens": [
            { "symbol": "USDT", "minimum_deposit": "1.00" },
            { "symbol": "USDC", "minimum_deposit": "1.00" }
          ]
        },
        {
          "network": "ERC20",
          "status": "active",
          "address": "0x9f2a6c1b4e8d7350ab11c9e5f0d2743b86ce41d9",
          "tokens": [
            { "symbol": "USDT", "minimum_deposit": "12.00" },
            { "symbol": "USDC", "minimum_deposit": "12.00" }
          ]
        },
        {
          "network": "SOL",
          "status": "provisioning",
          "tokens": [
            { "symbol": "USDC", "minimum_deposit": null }
          ]
        }
      ],
      "created_at": 1767225600,
      "updated_at": 1767225780
    },
    {
      "id": "pc_6BwTyH4nPl8QmZ2vKrJdSc",
      "project_id": "prj_xFukZuAJZR06pLVBh3uwzv",
      "external_id": "customer-41",
      "status": "provisioning",
      "is_accepting_payments": false,
      "is_fully_provisioned": false,
      "is_test": false,
      "applied_fee_percent": 1.0,
      "customer_fee_percent": 0,
      "networks": [
        {
          "network": "TRC20",
          "status": "provisioning",
          "tokens": [
            { "symbol": "USDT", "minimum_deposit": null },
            { "symbol": "USDC", "minimum_deposit": null }
          ]
        },
        {
          "network": "ERC20",
          "status": "provisioning",
          "tokens": [
            { "symbol": "USDT", "minimum_deposit": null },
            { "symbol": "USDC", "minimum_deposit": null }
          ]
        },
        {
          "network": "SOL",
          "status": "provisioning",
          "tokens": [
            { "symbol": "USDC", "minimum_deposit": null }
          ]
        }
      ],
      "created_at": 1767225540,
      "updated_at": 1767225540
    }
  ],
  "next_cursor": "CfDJ8JvN…"
}

Sayfalama

Sıralama önce created_at, sonra kanal kimliğidir; ikisi de azalan. Böylece sayfalar arasında ilerlerken dizinin sırası kaymaz.

• —next_cursor, son sayfada null olur. Durma işareti budur.
• —İmleç, kendisini üreten filtrelere bağlıdır. status, external_id veya project_id değerini değiştirip eski imleci yeniden kullanırsanız 400 pagination_cursor_invalid alırsınız — alternatifi, hiç görmediğiniz kayıtların sessizce atlanması olurdu.
• —İmleçlerin süresi, verildikten 24 saat sonra dolar. Sonrasında ilk sayfadan yeniden başlayın.
• —Kimlik bilginizin kapsamı dışındaki bir project_id için 404 değil, boş bir sayfa döner; böylece API, göremediğiniz bir projenin var olup olmadığını asla açık etmez.

Hatalar

Kod	HTTP	Ne zaman
payment_channels_disabled	503	Ödeme kanalları, bu ortamda hesabınız için etkin değil.
payment_key_required	403	İstek, Payout (rk_) anahtarıyla imzalandı.
pagination_cursor_invalid	400	İmleç bozuk, süresi dolmuş ya da farklı filtrelere bağlı.
field_invalid_enum	400	Bilinmeyen bir status değeri.
field_invalid_format	400	project_id geçerli bir prj_ kimliği değil ya da aynı status değeri iki kez tekrarlandı.
payment_channel_external_id_invalid	400	external_id, 128 karakterden uzun.
field_out_of_range	400	limit, 1–100 aralığının dışında.
query_parameter_unknown	400	Yukarıdaki tabloda bulunmayan bir parametre.

Tam katalog için bkz. Hata Kodları.