Skip to main content
Pre-Authorization is a payment process where a cardholder’s funds are temporarily held to ensure the availability of the specified amount for a future transaction. This process involves verifying the card details and reserving the funds without actually transferring them, allowing merchants to confirm the card’s validity and the customer’s ability to pay. Once the pre-authorization is approved, the funds are earmarked and can be captured later when the final transaction is completed, providing flexibility and security for both merchants and customers in managing payments.

​
Initiate Pre-Authorization

This endpoint initiates a pre-authorization for a payment. 
curl -X POST 'https://developers.flouci.com/api/v2/generate_payment' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <PUBLIC_KEY>:<PRIVATE_KEY>' \
  -d '{
    "amount": 1000,
    "success_link": "https://your-website.com/success",
    "fail_link": "https://your-website.com/fail",
    "webhook": "https://your-website.com/webhook",
    "developer_tracking_id": "YOUR_TRACKING_ID",
    "pre_authorization": true
  }'

​
Body

​
amount
integer
required
The amount to be paid in millimes.
​
success_link
string
required
The URL to redirect the user to after a successful payment.
​
fail_link
string
required
The URL to redirect the user to after a failed payment.
​
webhook
string
The webhook URL you want to receive payment confirmation on.
​
developer_tracking_id
string
An ID for you to track the payment. This is a free field that Flouci doesn’t check against.
​
pre_authorization
boolean
required
Must be set to true to create a pre-authorization.
​
accept_card
boolean
default:"false"
Whether to accept card payments.
​
image_url
URL
The URL of the image to display on the payment page. This field is optional, and the default image is the image of the merchant in the Flouci portal.
​
session_timeout_secs
integer
default:"1200"
The session timeout in seconds.
{
  "result": {
    "success": true,
    "payment_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
    "link": "https://flouci.com/pay/a1b2c3d4-e5f6-7890-1234-567890abcdef",
    "developer_tracking_id": "YOUR_TRACKING_ID"
  },
  "name": "developers",
  "code": 0,
  "version": "v2"
}