Create Binding

curl --location 'https://developers.flouci.com/api/v2/generate_payment' \
  --header 'Authorization: Bearer <PUBLIC_KEY>:<PRIVATE_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "amount": "40300",
    "developer_tracking_id": "<YOUR_TRACKING_ID>",
    "accept_card": true,
    "success_link": "https://example.com/success",
    "fail_link": "https://example.com/failure",
    "client_id": "<unique_internal_id>"
  }'

{
  "result": {
    "success": true,
    "payment_id": "FoPKKHqfQIKfBqhEj8M47A",
    "link": "https://flouci.com/pay/FoPKKHqfQIKfBqhEj8M47A",
    "developer_tracking_id": "<YOUR_TRACKING_ID>"
  },
  "name": "developers",
  "code": 0,
  "version": "v2"
}

{
  "result": {
    "status": 400,
    "message": "Bad Request"
  }
}

curl --location 'https://developers.flouci.com/api/v2/generate_payment' \
  --header 'Authorization: Bearer <PUBLIC_KEY>:<PRIVATE_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "amount": "40300",
    "developer_tracking_id": "<YOUR_TRACKING_ID>",
    "accept_card": true,
    "success_link": "https://example.com/success",
    "fail_link": "https://example.com/failure",
    "client_id": "<unique_internal_id>"
  }'

{
  "result": {
    "success": true,
    "payment_id": "FoPKKHqfQIKfBqhEj8M47A",
    "link": "https://flouci.com/pay/FoPKKHqfQIKfBqhEj8M47A",
    "developer_tracking_id": "<YOUR_TRACKING_ID>"
  },
  "name": "developers",
  "code": 0,
  "version": "v2"
}

{
  "result": {
    "status": 400,
    "message": "Bad Request"
  }
}

This endpoint initiates the binding process by creating a payment with a unique client_id. The first transaction links the customer’s Flouci wallet or card to your application. Subsequent payments using the same client_id will use the saved payment method.

curl --location 'https://developers.flouci.com/api/v2/generate_payment' \
  --header 'Authorization: Bearer <PUBLIC_KEY>:<PRIVATE_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "amount": "40300",
    "developer_tracking_id": "<YOUR_TRACKING_ID>",
    "accept_card": true,
    "success_link": "https://example.com/success",
    "fail_link": "https://example.com/failure",
    "client_id": "<unique_internal_id>"
  }'

Body

string

required

The amount to be paid in millimes.

string

An ID for you to track the payment. This is a free field that Flouci doesn’t check against.

boolean

default:"false"

Whether to accept card payments.

string

required

The URL to redirect the user to after a successful payment.

string

required

The URL to redirect the user to after a failed payment.

string

required

A unique internal identifier for the customer. This is the key that creates and references the binding — subsequent payments with the same client_id will use the saved payment method.

string

The webhook URL you want to receive payment confirmation on. Signed with X-Flouci-Signature; set webhook_version to 2 for a JSON event. See Payment Webhooks.

URL

The URL of the image to display on the payment page.

integer

default:"1200"

The session timeout in seconds.

{
  "result": {
    "success": true,
    "payment_id": "FoPKKHqfQIKfBqhEj8M47A",
    "link": "https://flouci.com/pay/FoPKKHqfQIKfBqhEj8M47A",
    "developer_tracking_id": "<YOUR_TRACKING_ID>"
  },
  "name": "developers",
  "code": 0,
  "version": "v2"
}

{
  "result": {
    "status": 400,
    "message": "Bad Request"
  }
}

The customer completes this first payment through the Flouci checkout page. Once completed, the client_id is bound to their payment method for future use. You can get the Binding Id from the verify API after the payment is done.

Introduction

Basic Payment Flows

Advanced payment flows

Partner APIs

Payment Plugins

Business Dashboard

Environments

Changelog

Body

​Body

Body