Create Transaction

Buat transaksi baru untuk membeli item menggunakan saldo. Transaksi akan langsung diproses dan saldo akan dipotong secara otomatis.

POST

/v1/trx

Production Ready

Transaction Flow

send

Request

account_balance_wallet

Deduct Balance

inventory_2

Lock Stock

check_circle

Completed

Request Parameters

Parameter	Type	Description
`ref_id` Required	string	ID referensi unik dari sistem Anda. Harus unique untuk setiap transaksi. Max 191 karakter.
`carts` Required	array	Array berisi item yang akan dibeli.
`carts.*.item_id` Required	integer	ID item/variant yang akan dibeli.
`carts.*.quantity` Required	integer	Jumlah item yang akan dibeli.
`carts.*.note` Conditional	string\|json	Catatan untuk item. Format tergantung tipe produk: Produk biasa/H2H: String biasa (misal: ID akun game). Max 50 karakter. Item open denom: JSON string dengan format `{"target":"08123xxxx","provider_qty":10000}`. Produk SMM: Wajib berupa JSON string. Lihat format di bawah.

Format Note untuk Item Open Denom

Jika item memiliki provider_meta.open_denom = true, kirim carts.*.note sebagai JSON string. Struktur input final sebaiknya mengikuti required_fields dari endpoint item.

Field	Type	Description
`target` Required	string	Tujuan transaksi, misalnya nomor e-wallet, nomor HP, atau user ID.
`provider_qty` Required	integer	Nominal yang dikirim ke provider. Validasi min/max/step mengikuti `provider_meta`.
`zone_id`	string	Optional. Isi jika item juga membutuhkan zona/server ID.

info Format Note untuk Produk SMM

Untuk produk SMM (Social Media Marketing), field note harus berupa JSON string dengan format tertentu. Jika format tidak sesuai, order akan ditolak dengan error SMM_ORDER_REQUIRES_JSON_NOTE.

Field	Type	Description
`target` Required	string	Target SMM order (link post, username, dll).
`opt_smm` Conditional	array	Array string opsi tambahan. Isi tergantung tipe layanan: Username, Hashtag, Link media, dll. Bisa dikosongkan `[]` jika tidak diperlukan.
`comment_smm`	string	Optional. Komentar untuk layanan yang membutuhkan komentar (tipe CR/CC).

Error Responses

400 BALANCE_IS_INSUFFICIENT

Saldo tidak mencukupi untuk transaksi ini.

400 SMM_ORDER_REQUIRES_JSON_NOTE

Produk SMM membutuhkan note dalam format JSON {target, opt_smm}.

422 REF_ID_ALREADY_EXIST

ref_id sudah pernah digunakan.

Example Request — Produk Biasa / H2H

curl --request POST \
              --url https://sekalipay.com/api/v1/trx \
              --header 'X-APIKEY: YOUR_API_KEY' \
              --header 'Content-Type: application/json' \
              --data '{
                "ref_id": "TRX-2024-001",
                "carts": [
                  {
                    "item_id": 123,
                    "quantity": 1,
                    "note": "12345678"
                  }
                ]
              }'

Example Request - Item Open Denom

curl --request POST \
              --url https://sekalipay.com/api/v1/trx \
              --header 'X-APIKEY: YOUR_API_KEY' \
              --header 'Content-Type: application/json' \
              --data '{
                "ref_id": "OKC-OPEN-001",
                "carts": [
                  {
                    "item_id": 2451,
                    "quantity": 1,
                    "note": "{\"target\":\"081234567890\",\"provider_qty\":10000}"
                  }
                ]
              }'

Example Request — Produk SMM

curl --request POST \
              --url https://sekalipay.com/api/v1/trx \
              --header 'X-APIKEY: YOUR_API_KEY' \
              --header 'Content-Type: application/json' \
              --data '{
                "ref_id": "SMM-2024-001",
                "carts": [
                  {
                    "item_id": 1725,
                    "quantity": 100,
                    "note": "{\"target\":\"https://instagram.com/p/xxx\",\"opt_smm\":[\"@username\"],\"comment_smm\":\"\"}"
                  }
                ]
              }'

Response Sample

200 OK

{
              "message": "OK",
              "data": {
                "invoice": "SPY1773219883T2S2",
                "ref_id": "TRX-2024-001",
                "status": "paid",
                "price": 270,
                "fees": 0,
                "amount": 270,
                "contact": "[email protected]",
                "created_at": "2024-01-01T12:00:00+07:00"
              }
            }