Create Order

Create an order

Creating a new order

cURL

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
			}
		}
}'

JavaScript

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));

Node.js

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

<?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;

Python

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

200 Order successfully created

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

401: Unauthorized Invalid API Key

{
    "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: