Xəbərlər
🔥
Standoff 2 Gold paketlərində endirimləri qaçırma!
🚀
Məhsulunu ValyutaMobile-da sat!
💬
Suallar üçün WhatsApp Dəstək Xidməti aktivdir
⚡
Limitli oyun məhsulları hər gün yenilənir
ValyutaMobile Partner API üçün texniki istinad: endpointlər, autentifikasiya və cavab formatları.
https://valyutamobile.com/wp-json/valyutamobile/v1Qorunan sorğular Bearer token və HMAC SHA-256 imzası tələb edir.
TOKEN='vm_test_YOUR_TOKEN'
TS=$(date +%s)
NONCE=$(openssl rand -hex 16)
METHOD='GET'
TARGET='/wp-json/valyutamobile/v1/catalog?page=1&per_page=20'
BODY=''
BODY_HASH=$(printf '%s' "$BODY" | openssl dgst -sha256 | awk '{print $2}')
CANONICAL=$(printf '%s\n%s\n%s\n%s' "$TS" "$METHOD" "$TARGET" "$BODY_HASH")
SIGNATURE=$(printf '%s' "$CANONICAL" | openssl dgst -sha256 -hmac "$TOKEN" | awk '{print $2}')
curl "https://valyutamobile.com$TARGET" \
-H "Authorization: Bearer $TOKEN" \
-H "X-VM-Timestamp: $TS" \
-H "X-VM-Nonce: $NONCE" \
-H "X-VM-Signature: $SIGNATURE"{
"success": true,
"data": {
"items": [],
"page": 1,
"per_page": 20,
"total": 0,
"total_pages": 0
}
}vm_test_ tokeni test mühitində işləyir və real balansı dəyişmir.
test_scenario | Nəticə |
|---|---|
completed | Uğurlu test cavabı |
processing | Emal vəziyyətində test cavabı |
failed | Uğursuz test cavabı |
insufficient_balance | Balans xətası testi |
POST /sandbox/reset test balansını sıfırlayır.
/catalog?page=1&per_page=100&search=&category=Məhsul və kateqoriya məlumatlarını API-dən alın. Sifariş üçün məhsul id və fields dəyərlərindən istifadə edin. API v1 sabit nominallı məhsulları dəstəkləyir. Sərbəst məbləğli balans artırma API vasitəsilə mövcud deyil; əvvəl sinxronlaşdırılmış ID-lər vəsait çıxılmadan rədd edilir.
fields daxilində type sahəsini nəzərə alın. dynamic_options=true olduqda sifarişdən əvvəl GET /products/{id} vasitəsilə aktual seçimləri alın. select üçün options.value göndərin, options.label yox. unavailable olduqda və ya tələb olunan seçim siyahısı boş olduqda sifarişi qəbul etməyin. number dəyərlərini də mətn kimi göndərin; number_format integer və ya decimal formatını göstərir.
GET /catalog?page=1&per_page=100
GET /categories
GET /products/{vm_prod_id}{
"success": true,
"data": {
"items": [{
"id": "vm_prod_a1b2c3",
"name": "Example product",
"price": 9.50,
"currency": "AZN",
"stock_status": "in_stock",
"fields": [{"key":"user_id","label":"User ID","type":"text","required":true}]
}],
"page": 1,
"total": 1
}
}/ordersPOST /orders sorğusunda məhsul məlumatlarını və unikal Idempotency-Key göndərin.
Nümunədəki test_scenario yalnız vm_test_ tokeni üçündür; real sifarişlərdə bu sahəni göndərməyin.
{
"external_order_id": "shop-1058-line-1",
"product_id": "vm_prod_a1b2c3",
"quantity": 1,
"fields": {"user_id": "123456", "server_id": "EU"},
"test_scenario": "completed"
}{
"success": true,
"data": {
"id": "vm_order_8f2d1c",
"external_order_id": "shop-1058-line-1",
"status": "completed",
"amount": 9.50,
"currency": "AZN",
"environment": "sandbox",
"delivery": {"text": "TEST-CODE-1234", "images": []}
}
}/orders/{vm_order_id}GET /orders/{id} cari statusu və mövcud çatdırılma məlumatını qaytarır.
GET /orders/vm_order_8f2d1c{
"success": true,
"data": {"id":"vm_order_8f2d1c","status":"completed","refunded":false}
}/balanceGET /balance cari token mühitinin balansını qaytarır.
GET /balance
GET /wallet/transactions?page=1&per_page=50{
"success": true,
"data": {"balance":1000.00,"currency":"AZN","environment":"sandbox"}
}order.updated hadisələri imzalanmış webhook sorğuları ilə göndərilə bilər. İmzanı yoxlayın və 2xx cavabı qaytarın.
X-VM-Webhook-SignatureSorğuları yoxlamaq üçün yalnız vm_test_ tokenindən istifadə edin.
Cavab burada görünəcək.
| HTTP | Məna |
|---|---|
400/422 | Yanlış sorğu və ya məlumat |
401/403 | Autentifikasiya və ya icazə xətası |
402 | Balans kifayət deyil |
409 | Konflikt və ya əlçatmaz resurs |
429 | Sorğu limiti aşılıb |
5xx | Müvəqqəti server xətası |