Partner API belgeleri

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
  }
}

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
  }
}

{
  "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": []}
  }
}

GET /orders/vm_order_8f2d1c

{
  "success": true,
  "data": {"id":"vm_order_8f2d1c","status":"completed","refunded":false}
}

GET /balance
GET /wallet/transactions?page=1&per_page=50

{
  "success": true,
  "data": {"balance":1000.00,"currency":"AZN","environment":"sandbox"}
}