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-Modesarlavhasi bor:testyokilive. - Test kalitlari darhol ishlaydi, hisobingiz hali tasdiqlanishni kutayotgan bo'lsa ham. Faqat rad etilgan yoki to'xtatilgan hisoblar yopiladi. Live kalitlar hisob tasdiqlangach ishlaydi.
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_idqiymatlarini 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
- Buyurtma
processingholatida yaratiladi va test balansidan pul yechiladi. - Taxminan 10 soniyadan keyin u
completed(yoki senariyga qarabfailed) bo'ladi. - O'zgarish buyurtmani o'qiganingizda (
GET /ordersyokiGET /orders/{transaction_id}) yoki fon vazifasi orqali taxminan bir daqiqa ichida bo'ladi. order.processing,order.completedvaorder.failedwebhooklaridataichida"sandbox": truebilan 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.
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.
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 shutransaction_idbilan 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
- API kalitlari bo'limida live kalit yarating va serverlaringizni uning IP ro'yxatiga qo'shing.
- Haqiqiy balansni to'ldiring.
- 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.