Generate Payment

curl -X POST 'https://developers.flouci.com/api/v2/generate_payment' \
  -H 'Authorization: Bearer <PUBLIC_KEY>:<PRIVATE_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "amount": "40300",
    "developer_tracking_id": "<YOUR_TRACKING_ID>",
    "accept_card": true,
    "success_link": "https://your-website.com/success",
    "fail_link": "https://your-website.com/fail",
    "webhook": "https://your-website.com/webhook",
    "webhook_version": 2
  }'

{
  "result": {
    "success": true,
    "payment_id": "AgCKuBm0S5uLPghBo571MQ",
    "link": "https://checkout.flouci.com/company_name/AgCKuBm0S5uLPghBo571MQ",
    "developer_tracking_id": "<DEVELOPER_TRACKING_ID>"
  },
  "name": "developers",
  "code": 0,
  "version": "v2"
}

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

curl -X POST 'https://developers.flouci.com/api/v2/generate_payment' \
  -H 'Authorization: Bearer <PUBLIC_KEY>:<PRIVATE_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "amount": "40300",
    "developer_tracking_id": "<YOUR_TRACKING_ID>",
    "accept_card": true,
    "success_link": "https://your-website.com/success",
    "fail_link": "https://your-website.com/fail",
    "webhook": "https://your-website.com/webhook",
    "webhook_version": 2
  }'

{
  "result": {
    "success": true,
    "payment_id": "AgCKuBm0S5uLPghBo571MQ",
    "link": "https://checkout.flouci.com/company_name/AgCKuBm0S5uLPghBo571MQ",
    "developer_tracking_id": "<DEVELOPER_TRACKING_ID>"
  },
  "name": "developers",
  "code": 0,
  "version": "v2"
}

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

This endpoint creates a new payment and returns a URL to redirect the user to for completing the payment.

curl -X POST 'https://developers.flouci.com/api/v2/generate_payment' \
  -H 'Authorization: Bearer <PUBLIC_KEY>:<PRIVATE_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "amount": "40300",
    "developer_tracking_id": "<YOUR_TRACKING_ID>",
    "accept_card": true,
    "success_link": "https://your-website.com/success",
    "fail_link": "https://your-website.com/fail",
    "webhook": "https://your-website.com/webhook",
    "webhook_version": 2
  }'

Body

string

required

The amount to be paid in millimes.

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

The webhook URL you want to receive payment confirmation on. Every call is signed with X-Flouci-Signature; see Payment Webhooks.

integer

default:"1"

The format of the webhook call. 1 sends GET <webhook>?payment_id=<id>&success=<True|False>; 2 sends a POST with a signed JSON payment.succeeded or payment.failed event. Any other value is rejected with 400. See Payment Webhooks.

string

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

integer

default:"1200"

The session timeout in seconds.

boolean

default:"false"

Whether to accept card payments.

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.

{
  "result": {
    "success": true,
    "payment_id": "AgCKuBm0S5uLPghBo571MQ",
    "link": "https://checkout.flouci.com/company_name/AgCKuBm0S5uLPghBo571MQ",
    "developer_tracking_id": "<DEVELOPER_TRACKING_ID>"
  },
  "name": "developers",
  "code": 0,
  "version": "v2"
}

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

Introduction

Basic Payment Flows

Advanced payment flows

Partner APIs

Payment Plugins

Business Dashboard

Environments

Changelog

Body

​Body

Body