Create Bill

POST 
/v2/pwf/bill

Important Notice - Link ID and Bill Link ID Format Change

Action Required by April 10, 2026

The link_id and bill_link_id format will change from Integer to BigInteger (19-digit format) on April 10, 2026.

Ensure your system stores transaction IDs as BigInteger or String to prevent data truncation and integration issues. JavaScript / TypeScript / Node.js users: default JSON.parse() silently rounds 19-digit numbers — use json-bigint or treat IDs as strings.

Read the full announcement →

An endpoint to create a payment/bill link

Request

Responses

200

Expected Create bill Response

401

Sample response when Your Flip api secret key value for Authorization is missing or invalid

422

Expected Error Response

Callbacks

POST acceptPaymentCallback

POST 
/your-callback-url

Accept payment callback will be sent to you if there is a payment status that changed to SUCCESSFUL, CANCELLED, or FAILED. Please make sure that you have set the Accept Payment callback URL on the Flip for Business dashboard.

Callbacks Responses

200

URL must return a 200 HTTP Status Code. If the URL returns another HTTP Status Code or if our system doesn’t receive any response within 30 seconds (timeout), our system will retry the request 5 times, with a 2-minute interval for the transaction callback (Money Transfer, Accept Payment, International Transfer).