Asosiy qismga o'tish

Boshlash · 4-bob

Sandbox (test rejimi)

Balansni to'ldirishdan yoki hisob tasdiqlanishidan oldin butun integratsiyani sinab ko'ring. Test kaliti xuddi shu API bilan ishlaydi, lekin buyurtmalar virtual balansdan to'lanadi va hech narsa haqiqatda yetkazilmaydi.

3 daqiqa o'qish

Test kalitlari

Panelda API kalitlari bo'limida Test rejimini tanlab kalit yarating. Test kaliti shunday ko'rinadi:

Authorization: Bearer gxp_test_xxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  • Live kalitlar avvalgidek gxp_… ko'rinishida. Har bir rejimda 10 tagacha faol kalit bo'lishi mumkin.
  • Test kaliti hech qachon live sifatida ishlamaydi, live kalit esa sandbox'ga tushmaydi.
  • Har bir javobda X-Api-Mode sarlavhasi bor: test yoki live.
  • Test kalitlari darhol ishlaydi, hisobingiz hali tasdiqlanishni kutayotgan bo'lsa ham. Faqat rad etilgan yoki to'xtatilgan hisoblar yopiladi. Live kalitlar hisob tasdiqlangach ishlaydi.
Eslatma

Asosiy manzil va barcha so'rovlar bir xil: https://partner.goxost.net/api/v1. Rejimni faqat kalit belgilaydi.

Sandbox'da nima ishlaydi

Qism Sandbox'da
Katalog (GET /offers) Haqiqiy katalog, sizning haqiqiy narxlaringiz bilan.
Balans (GET /balance) Virtual test balansingiz; "mode": "test".
O'yinchini tekshirish Taqlid qilinadi, senariylarga qarang.
Buyurtmalar Live bilan bir xil tekshiruvlar: maydonlar, quantity, max_price / PRICE_CHANGED, 402 INSUFFICIENT_BALANCE, transaction_id bilan xavfsiz qayta yuborish va TRANSACTION_ID_CONFLICT. Yetkazishga hech narsa yuborilmaydi, haqiqiy pul harakatlanmaydi.
Webhooklar Xuddi shu webhook manzilingizga, xuddi shunday imzo bilan yuboriladi; X-Webhook-Mode: test sarlavhasi va data ichida "sandbox": true bo'ladi. Faqat bir marta qayta yuboriladi.

Test buyurtmalari raqami S-000123 ko'rinishida (live: P-…), buyurtma obyektida esa "sandbox": true bo'ladi. Ular paneldagi buyurtmalar ro'yxatida ko'rinmaydi — test kaliti bilan GET /orders orqali o'qing.

Test balansi

  • Birinchi test kaliti bilan 1000.00 USD beriladi.
  • API kalitlari sahifasidagi tugma 1000.00 USD qo'shadi.
  • Balans hech qachon 10 000.00 USD dan oshmaydi.
  • Paneldagi Tozalash barcha test buyurtmalarini o'chiradi (ularning transaction_id qiymatlarini qayta ishlatish mumkin) va balansni 1000.00 USD ga qaytaradi.

Test kodingizdan ham to'ldirishingiz mumkin:

POST/sandbox/balance

curl https://partner.goxost.net/api/v1/sandbox/balance \
  -H "Authorization: Bearer $PARTNER_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "amount": "500.00" }'
{
  "data": {
    "balance": "1500.00",
    "currency": "USD",
    "mode": "test"
  }
}

amount 0.01 dan 10000.00 gacha bo'lishi kerak, aks holda 422 VALIDATION_FAILED qaytadi. Natija 10 000.00 USD bilan cheklanadi. Live kalit bilan bu so'rov 403 SANDBOX_ONLY qaytaradi.

Buyurtma jarayoni

  1. Buyurtma processing holatida yaratiladi va test balansidan pul yechiladi.
  2. Taxminan 10 soniyadan keyin u completed (yoki senariyga qarab failed) bo'ladi.
  3. O'zgarish buyurtmani o'qiganingizda (GET /orders yoki GET /orders/{transaction_id}) yoki fon vazifasi orqali taxminan bir daqiqa ichida bo'ladi.
  4. order.processing, order.completed va order.failed webhooklari data ichida "sandbox": true bilan manzilingizga yuboriladi.

Kod bilan beriladigan takliflarda bajarilgan test buyurtmasi har bir dona uchun bittadan soxta kod oladi:

"delivered": [{ "type": "code", "value": "TEST-4F7K-Q2MD-8XWA", "pin": null }]

To'g'ridan-to'g'ri to'ldirish takliflarida delivered live'dagidek bo'sh qoladi.

Muhim

Sandbox webhooklari live bilan bir xil manzilga keladi. Ishlab turgan ishlov beruvchingiz X-Webhook-Mode: test (yoki "sandbox": true) bo'lgan yetkazishlarni o'tkazib yuborishi shart — aks holda xuddi shu transaction_id li test buyurtma sizdagi haqiqiy buyurtmani o'zgartirib yuborishi mumkin.

Senariylar

Natijani X-Sandbox-Scenario sarlavhasi bilan yoki buyurtmaning istalgan maydoniga (masalan player_id) maxsus qiymat yozib tanlang. Sarlavha ustun turadi. Ikkalasi ham bo'lmasa, buyurtma muvaffaqiyatli bajariladi.

Senariy Sarlavha Maydon qiymati Natija
Muvaffaqiyat success — processing → completed.
Xato fail test_fail processing → failed, SUPPLIER_FAILED bilan, "refunded": true, test balansi qaytariladi.
Noto'g'ri o'yinchi invalid test_invalid Buyurtma darhol INVALID_PLAYER bilan bajarilmaydi va pul qaytariladi, live'dagidek. O'yinchini tekshirish "valid": false, "reason": "Player not found" qaytaradi.
Osilib qolgan pending test_pending Doim processing holatida qoladi — kutish vaqti va so'rab turishni sinash uchun.
curl https://partner.goxost.net/api/v1/orders \
  -H "Authorization: Bearer $PARTNER_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Sandbox-Scenario: fail" \
  -d '{ "transaction_id": "test-1", "offer_id": 1042, "fields": { "player_id": "5123456789" } }'

Boshqa barcha hollarda o'yinchini tekshirish "valid": true va "player_name": "Test Player" qaytaradi.

Maslahat

Variantlari belgilangan maydonlar (masalan server) baribir faqat o'sha variantlarni qabul qiladi. Bunday takliflarda senariyni sarlavha bilan tanlang.

Cheklovlar

  • Test trafigining so'rovlar limiti alohida — test live kalitlaringizni sekinlashtirmaydi.
  • Daqiqasiga 30 tagacha test buyurtma — undan oshsa 429 RATE_LIMITED; xuddi shu transaction_id bilan qayta yuborish hisoblanmaydi.
  • 5000 tagacha saqlanadigan test buyurtma — undan oshsa 409 SANDBOX_LIMIT. Paneldagi Tozalash ni bosing yoki kuting.
  • Test buyurtmalar 7 kun saqlanadi, keyin avtomatik o'chiriladi.

Live rejimiga o'tish

  1. API kalitlari bo'limida live kalit yarating va serverlaringizni uning IP ro'yxatiga qo'shing.
  2. Haqiqiy balansni to'ldiring.
  3. Sozlamalaringizda test kalitini live kalitga almashtiring — boshqa hech narsa o'zgarmaydi.

Test buyurtmalari alohida saqlanadi: sandbox'da ishlatilgan transaction_id hech qachon live buyurtma bilan to'qnashmaydi.