OpenAPI

Developers can leverage its comprehensive endpoints to manage transactions, process refunds, and retrieve payment statuses, ensuring efficient and reliable payment management.

Initiate a payment transaction

post

Initiates a payment transaction and returns a payment URL. The merchant must be validated, and the vcode must be correct.

Body
amountnumber · doubleRequired

The payment amount

Example: 49.99
currencystringRequired

The payment currency code

Example: MYR
orderIdstringRequired

The merchant's order ID

Example: ORD-923779
billNamestringOptional

Customer's name

Example: John Doe
billMobilestringOptional

Customer's mobile number

Example: 60123456789
billEmailstring · emailOptional

Customer's email address

Example: customer@example.com
billDescstringOptional

Description of the payment

Example: Payment for order
countrystringOptional

Customer's country code

Example: MY
merchantIdstringRequired

The merchant identifier

Example: MERCH_abc123def456
vcodestringRequired

Verification code calculated as MD5(amount + orderId + merchantId + verifyKey)

Example: a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
Responses
200

Payment initiated successfully

application/json
post
POST /api/v1/payments/initiate HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: */*
Content-Length: 261

{
  "amount": 49.99,
  "currency": "MYR",
  "orderId": "ORD-923779",
  "billName": "John Doe",
  "billMobile": 60123456789,
  "billEmail": "customer@example.com",
  "billDesc": "Payment for order",
  "country": "MY",
  "merchantId": "MERCH_abc123def456",
  "vcode": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"
}
{
  "paymentUrl": "https://pay.fiuu.com/checkout/zt1750570357296"
}
PreviousQuickstart

Last updated