Payment APIs

We're defining the Ready API that initiates the payment and the sequence that follows.

Start a payment flow

POST /payment/ready

This API returns the payment URL for the Excoinz ExPay Payment Page.

Headers

Name	Value
Content-Type	application/json
EXCOINZ_SECRET	Bearer <secret key>

Body

Name	Type	Description
client_id	string	The Merchant client ID.
item_name	string	The name of the product to display on the checkout.
item_img_url	string	The URL of the product image to display on the checkout.
partner_order_id	string	Merchant billing ID to prevent duplicate requests. Payment will not process payments for duplicate IDs.
partner_user_id	string	Merchant user identifier for statistics.
amount	string	Please enter the amount you want to charge
locale	string	Supports three types of values: "en", "cn", "ko"

Response

200

{
  redirect_url:'https://pay.excoinz.com/payment?locale=en&t=yourtoken'
}

400

{
  "code": -101,
  "message":"Invalid Client ID"
}

Error Code

Status	Error Code	Message	Solution
400	-101	Invalid Client ID	Double-check the client key value.