INinterlace
Payments

Create a payment

Create a payment. Integration Methods:

  1. API-ONLY Integration 1.1 Card Payments 1.1.1 Hosted Mode (Supports full hosted/embedded mode) 1.1.2 Server-to-Server Mode
  2. Checkout Page Integration (Supports full hosted mode, embedded mode not supported yet) 2.1 Create checkout session (Customers choose payment method themselves) 2.2 Pre-selected payment method For checkout payments, integrationMode and threeDS may be omitted to use their defaults.

Payment Method Value and ID Mapping:

  • CASH_APP:(100001)
  • CARD:(100002)
  • CRYPTO_CARD:(100003)
  • USDC:(100007)
  • USDT:(100008)
  • APPLE_PAY:(100009)
  • GOOGLE_PAY:(100010)
post/open-api/v3/acquiring/payments

Request

  • Base URL
    https://api-sandbox.interlace.money
  • URL
    https://api-sandbox.interlace.money/open-api/v3/acquiring/payments
  • Auth
    API key in header x-access-token

Request body

merchantTradeNostring required

Merchant-generated order number, globally unique/idempotent

amountstring required

Payment amount in string format, up to 6 decimal places

currencystring required

Payment currency

countrystring required

Payment country

descriptionstring

Merchant-provided information, will be returned as-is

Example request

{
  "merchantTradeNo": "ORDER20250814123456",
  "amount": "99.99",
  "currency": "USD",
  "country": "US",
  "paymentDetail": {
    "paymentMethodId": "100003"
  },
  "returnUrls": {
    "successUrl": "https://merchant.com/success",
    "failUrl": "https://merchant.com/fail"
  },
  "card": {
    "firstName": "John",
    "lastName": "Doe",
    "pan": "4111111111111111",
    "expireMonth": "12",
    "expireYear": "2025",
    "cvv": "123"
  },
  "customer": {
    "merchantCustomerId": "CUST001",
    "firstName": "John",
    "lastName": "Doe",
    "email": "john.doe@example.com",
    "phoneNumber": "+1234567890"
  },
  "goods": [
    {
      "name": "Product Name",
      "sku": "SKU123",
      "quantity": 1,
      "price": "99.99",
      "totalAmount": "99.99"
    }
  ],
  "shippingInfo": {
    "firstName": "John",
    "lastName": "Doe",
    "shippingAddress": {
      "firstName": "John",
      "lastName": "Doe",
      "addressLine1": "123 Main St",
      "city": "New York",
      "state": "NY",
      "country": "US",
      "postalCode": "10001"
    }
  },
  "billInfo": {
    "firstName": "John",
    "lastName": "Doe",
    "billAddress": {
      "firstName": "John",
      "lastName": "Doe",
      "addressLine1": "123 Main St",
      "city": "New York",
      "state": "NY",
      "country": "US",
      "postalCode": "10001"
    }
  },
  "additionalInfo": {
    "transferReference": "TRANSFER123",
    "riskSessionId": "qrs_5792782e343f4c1f8d72b625b94f2163"
  },
  "browserInfo": {
    "ip": "203.0.113.10",
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 Chrome/130.0.0.0 Safari/537.36",
    "referrer": "https://merchant.example/checkout"
  },
  "description": "Additional order information"
}

Response

OK

codeinteger

Return code

messagestring

Error message

Changes

No recorded changes to this operation across all 1 revision of this API.