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`	string	Optional. Catatan untuk item (misal: ID akun game). Max 50 karakter.

Error Responses

400 BALANCE_IS_INSUFFICIENT

Saldo tidak mencukupi untuk transaksi ini.

422 REF_ID_ALREADY_EXIST

ref_id sudah pernah digunakan.

Example Request

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"
                  }
                ]
              }'

Response Sample

200 OK

{
              "message": "OK",
              "data": {
                "id": 12345,
                "invoice": "INV-20240101-XXXXX",
                "ref_id": "TRX-2024-001",
                "amount": 50000,
                "status": "paid",
                "created_at": "2024-01-01T12:00:00Z"
              }
            }