Create Order

Creates a new payment order. Support both bearer or cookie secure session

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

An order is created using the Create Order API. Once the order is created, redirect the buyer to a ForgingBlock payment page, where they can see the payable amount, choose a supported cryptocurrency, and complete the payment.

ForgingBlock provides two payment URLs:

invoice_url
  • Single-use payment invoice
  • Fixed 20-minute lifetime
  • Intended for direct checkout flows
  • Automatically expires if unpaid
checkout_url
  • Reusable payment link
  • Safe to share via messengers, email, or QR
  • Each visit generates a new invoice using the same order data
  • Ideal for asynchronous or off-site payments

Action:
Redirect the buyer to the URL or share it with them to complete payment.

Body Params
string
length between 3 and 128

Optional merchant-side order identifier. Must be unique per user. Used to map this order to your internal system (e.g. WooCommerce order ID).

required

Order amount in the specified price currency. Must be a positive number or a decimal string with up to 8 decimal places.

string
required
length between 3 and 3

ISO-4217 currency code (e.g. USD, EUR). Determines how the order amount is interpreted and converted to crypto.

string
length between 3 and 120

Product name or order title shown to the buyer during checkout and visible in the merchant dashboard.

string
length between 3 and 2000

Detailed description of the order shown to the buyer during checkout. Can include product details, notes, or payment context.

string
length between 3 and 2048

Redirect to Merchant URL after successful payment.

string
length between 3 and 2048

Redirect to Merchant URL when buyer cancels the order or leaves the checkout before completing payment.

customerInfo
object

Optional customer information attached to the order for receipts, tracking, and fulfillment.

Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json