POST
/
payments
/
create-intent
curl --request POST \
  --url https://api.xpaycheckout.com/payments/create-intent \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": 100,
  "currency": "USD",
  "receiptId": "order123",
  "customerDetails": {
    "name": "John Doe",
    "email": "john.doe@example.com",
    "contactNumber": 9123456789,
    "customerAddress": {
      "addressLine1": "123 Main St",
      "addressLine2": "Apt 101",
      "city": "Los Angeles",
      "state": "California",
      "country": "United States",
      "postalCode": "123456"
    }
  },
  "description": "Order for 2 items",
  "callbackUrl": "https://example.com/callback",
  "paymentMethods": [
    "CARD",
    "GOOGLE_PAY",
    "APPLE_PAY"
  ],
  "customerReferenceId": "customer123"
}'
{
  "amount": 100,
  "currency": "USD",
  "presentmentCurrency": "USD",
  "receiptId": "order123",
  "mode": "TEST",
  "customerDetails": {
    "name": "John Doe",
    "email": "john.doe@example.com",
    "contactNumber": "9123456789",
    "customerAddress": {
      "addressLine1": "123 Main St",
      "addressLine2": "Apt 101",
      "city": "Los Angeles",
      "state": "California",
      "country": "United States",
      "postalCode": "123456"
    }
  },
  "description": "Order for 2 items",
  "callbackUrl": "https://example.com/callback",
  "createdAt": "2024-09-26T10:41:50.472+00:00",
  "status": "CREATED",
  "xIntentId": "66f53a6e2097773e4f0112c8",
  "fwdUrl": "https://pay.xpaycheckout.com/?xpay_intent_id=67f53a6e2097773e4f0112c8"
}

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json
Create Intent
​
amount
integer
required

The amount in lowest count unit. e.g.: For USD 1, amount is 100 representing 100 cents (The minimum amount should be greater than 1 USD)

Example:

100

​
currency
string
required

Three letter abbreviation of the currency. Refer supported currencies

Example:

"USD"

​
customerDetails
object
required

Details about the customer

​
callbackUrl
string
required

The URL we will callback to with the order status once it finishes.

Example:

"https://example.com/callback"

​
receiptId
string

Your identifier of the order

Example:

"order123"

​
description
string

The description of the order, if any

Example:

"Order for 2 items"

​
paymentMethods
string[]

List of payment methods to be enabled for the link. supported payment methods

Example:
["CARD", "GOOGLE_PAY", "APPLE_PAY"]
​
customerReferenceId
string

The customerReferenceId is used to enable the saved payment method feature. When a new, unique customerReferenceId is provided, a new customer profile is created. To retrieve and display a customer's previously saved payment methods, use the same customerReferenceId in subsequent transactions.

⚠️Warning : Ensure the customerReferenceId is unique for each customer. Using a duplicate ID may result in payment methods being unintentionally shared across different customers, compromising security and privacy

Example:

"customer123"

Response

200
application/json
Create Intent response
​
amount
integer

The amount in lowest count unit (e.g., cents for USD)

Example:

100

​
currency
string

Three-letter currency code

Example:

"USD"

​
presentmentCurrency
string

The currency that the customer paid in

Example:

"USD"

​
receiptId
string

Your identifier for the order

Example:

"order123"

​
mode
string

The mode in which the transaction was made (e.g., TEST or LIVE)

Example:

"TEST"

​
customerDetails
object
​
description
string

Description of the order, if any

Example:

"Order for 2 items"

​
callbackUrl
string

Callback URL to notify order status

Example:

"https://example.com/callback"

​
createdAt
string

Timestamp of when the intent was created

Example:

"2024-09-26T10:41:50.472+00:00"

​
status
string

Current status of the intent.

Example:

"CREATED"

​
xIntentId
string

Unique identifier of the intent

Example:

"66f53a6e2097773e4f0112c8"

​
fwdUrl
string

The URL to redirect the customer to the xPay payment gateway for payment.

Example:

"https://pay.xpaycheckout.com/?xpay_intent_id=67f53a6e2097773e4f0112c8"

Was this page helpful?