Create Order

Create an order

Creating a new order

curl --location -g --request POST '{{BASE_URL}}/v2/create-order' \
--header 'Authorization: Bearer {{API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
	"domain": "yourdomain.com",
	"order_id": "Test123",
    "user_id": "1",
	"amount": "100",
	"currency_name": "EUR",
    "order_date": "2022-04-26",
	"redirect_url": "https://yourdomain.com/thank-you/",
    "items": {
			"1": {
				"Item Name": "Test Item 1",
                "Quantity":"1",
				"Price": 10,
                "Total":"12",
			},
			"2": {
				"Item Name": "Test Item 2",
				"Price": 20
			}
		}
}'

var myHeaders = new Headers();
myHeaders.append("Authorization", "Bearer {{API_KEY}}");
myHeaders.append("Content-Type", "application/json");

var raw = "{\r\n	\"domain\": \"yourdomain.com\",\r\n	\"order_id\": \"Test123\",\r\n    \"user_id\": \"1\",\r\n	\"amount\": \"100\",\r\n	\"currency_name\": \"EUR\",\r\n    \"order_date\": \"2022-04-26\",\r\n	\"redirect_url\": \"https://yourdomain.com/thank-you/\",\r\n    \"items\": {\r\n			\"1\": {\r\n				\"Item Name\": \"Test Item 1\",\r\n                \"Quantity\":\"1\",\r\n				\"Price\": 10,\r\n                \"Total\":\"12\",\r\n			},\r\n			\"2\": {\r\n				\"Item Name\": \"Test Item 2\",\r\n				\"Price\": 20\r\n			}\r\n		}\r\n}";

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw,
  redirect: 'follow'
};

fetch("{{BASE_URL}}/v2/create-order", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

var request = require('request');
var options = {
  'method': 'POST',
  'url': '{{BASE_URL}}/v2/create-order',
  'headers': {
    'Authorization': 'Bearer {{API_KEY}}',
    'Content-Type': 'application/json'
  },
  body: '{\r\n	"domain": "yourdomain.com",\r\n	"order_id": "Test123",\r\n    "user_id": "1",\r\n	"amount": "100",\r\n	"currency_name": "EUR",\r\n    "order_date": "2022-04-26",\r\n	"redirect_url": "https://yourdomain.com/thank-you/",\r\n    "items": {\r\n			"1": {\r\n				"Item Name": "Test Item 1",\r\n                "Quantity":"1",\r\n				"Price": 10,\r\n                "Total":"12",\r\n			},\r\n			"2": {\r\n				"Item Name": "Test Item 2",\r\n				"Price": 20\r\n			}\r\n		}\r\n}'

};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => '%7B%7BBASE_URL%7D%7D/v2/create-order',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
	"domain": "yourdomain.com",
	"order_id": "Test123",
    "user_id": "1",
	"amount": "100",
	"currency_name": "EUR",
    "order_date": "2022-04-26",
	"redirect_url": "https://yourdomain.com/thank-you/",
    "items": {
			"1": {
				"Item Name": "Test Item 1",
                "Quantity":"1",
				"Price": 10,
                "Total":"12",
			},
			"2": {
				"Item Name": "Test Item 2",
				"Price": 20
			}
		}
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer {{API_KEY}}',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

import requests
import json

url = "{{BASE_URL}}/v2/create-order"

payload = "{\r\n\t\"domain\": \"yourdomain.com\",\r\n\t\"order_id\": \"Test123\",\r\n    \"user_id\": \"1\",\r\n\t\"amount\": \"100\",\r\n\t\"currency_name\": \"EUR\",\r\n    \"order_date\": \"2022-04-26\",\r\n\t\"redirect_url\": \"https://yourdomain.com/thank-you/\",\r\n    \"items\": {\r\n\t\t\t\"1\": {\r\n\t\t\t\t\"Item Name\": \"Test Item 1\",\r\n                \"Quantity\":\"1\",\r\n\t\t\t\t\"Price\": 10,\r\n                \"Total\":\"12\",\r\n\t\t\t},\r\n\t\t\t\"2\": {\r\n\t\t\t\t\"Item Name\": \"Test Item 2\",\r\n\t\t\t\t\"Price\": 20\r\n\t\t\t}\r\n\t\t}\r\n}"
headers = {
  'Authorization': 'Bearer {{API_KEY}}',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

Field

Description

Example

domain

Your domain name

"yourdomain.com"

order_id

The id of the order

"3"

user_id

The user's ID (optional)

"1"

amount

The amount of the order

"10"

currency_name

The ISO-4217 currency

"USD"

order_date

The date of the order

"2022-04-26"

redirect_url

The page where you want to redirect users after the payment

"https://yourdomain.com/thank-you/"

items

List of items in JSON format

{ "1": { "Item Name": "Test Item 1", "Quantity":"1", "Price": 10, "Total":"12" }, "2": { "Item Name": "Test Item 2", "Price": 20 } }

Create an order.

POST https://merchant.fcfpay.com/api/v2/create-order

Creates a new order.

Request Body

Name

Type

Description

domain*

string

domain host of the order

order_id*

string

The id of the order as a string

amount*

decimal

The amount as a string

currency_name*

string

The ISO-4217 currency

redirect_url*

string

The URL where will redirected

order_date

string

The date with "YYYY-MM-DD" format

user_id

String

The id of the user as a string

items

JSON

List of Items

{
    "success": true,
    "data": {
        "checkout_page_url": "https://checkout-sandbox.fcfpay.com/pay/JDJ5JDEwJGNFWHNualp6NnFydDNNZzhkVUJwN2VILkJkTko1RmFTZ1ZVQVRCVWxqSVlxUy83YzRwTFou",
        "payment_status": "waiting"
    },
    "message": "Order successfully created. Waiting for the payment."
}

{
    "success": false,
    "data": [],
    "message": "Merchant Authentication problem!"
}

After order creation, our system will send you a checkout page URL. You should redirect your customers to that URL.

If you send information about items, this will be displayed on the checkout page:

PreviousAPI Requests - V2 NextCreate Invoice

Last updated 2 years ago