Account Validation

Gunakan endpoint ini untuk cek nickname atau nama akun sebelum membuat transaksi. Client cukup mengirim item_id; sistem akan memilih kode validasi provider dari produk.

POST /v1/item/validate

Field	Type	Description
item_id	integer	ID variant dari endpoint `/v1/item`.
customer_id	string	User ID, nomor e-wallet, nomor rekening, atau ID pelanggan.
zone_id	string\|null	Wajib hanya jika `validation.requires_zone_id` bernilai true.

GET /v1/validation/services

Endpoint ini mengembalikan daftar produk dan item yang memiliki validasi aktif. Gunakan untuk membuat halaman daftar layanan cek ID, atau untuk audit katalog.

Query Param	Type	Description
search	string\|null	Opsional. Filter berdasarkan nama produk atau nama item.

Response Fields

data[].product_id integer

ID produk yang punya validasi aktif.

data[].product_name string

Nama produk.

data[].validation object

Metadata validasi: available, requires_zone_id, dan fields (input yang dibutuhkan saat cek akun).

data[].variants[] array

Daftar item: item_id, name, sku, price, status.

meta object

total_products dan total_items.

Response Fields (POST /v1/item/validate)

data.display_name string

Nama siap tampil. Untuk MLBB region bisa berisi format seperti Aqaa. (Malaysia).

data.account_name string

Nickname atau nama pemilik akun tanpa tambahan region jika provider menyediakannya.

data.region string|null

Region akun untuk layanan yang mendukung region lookup.

data.cached boolean

Bernilai true jika hasil diambil dari cache validasi.

Validate MLBB

curl --request POST \
  --url https://sekalipay.com/api/v1/item/validate \
  --header 'X-APIKEY: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"item_id":123,"customer_id":"256632355","zone_id":"9402"}'

Validate DANA

curl --request POST \
  --url https://sekalipay.com/api/v1/item/validate \
  --header 'X-APIKEY: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"item_id":456,"customer_id":"08123456789"}'

Response Sample (validate)

{
  "message": "OK",
  "data": {
    "display_name": "Aqaa. (Malaysia)",
    "account_name": "Aqaa.",
    "region": "Malaysia",
    "region_code": "MY",
    "cached": false,
    "details": {}
  }
}

List Validation Services

curl --request GET \
  --url 'https://sekalipay.com/api/v1/validation/services?search=mobile' \
  --header 'X-APIKEY: YOUR_API_KEY'

Response Sample (services)

{
  "message": "OK",
  "data": [
    {
      "product_id": 10,
      "product_name": "Mobile Legends",
      "validation": {
        "available": true,
        "requires_zone_id": true,
        "fields": [ /* ... */ ]
      },
      "variants": [
        {
          "item_id": 123,
          "name": "86 Diamonds",
          "sku": "ML86",
          "price": 20000,
          "status": "active"
        }
      ]
    }
  ],
  "meta": {
    "total_products": 1,
    "total_items": 1
  }
}