Create a Payment

Creates a new payment intent for processing a transaction. This endpoint requires an active API key and valid payload containing the amount and currency.

Body Parameters

amountinteger

Required

The transaction amount in the smallest currency unit (e.g., cents).

currencystring

Required

Three-letter ISO currency code, in lowercase.

descriptionstring

An arbitrary string attached to the object. Often useful for displaying to users.

Request Example

curl https://api.lightswind.com/v1/payments/create \
  -H "Authorization: Bearer sk_test_123" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 2000,
    "currency": "usd",
    "description": "Premium Plan"
  }'

Use our official SDKs for Node.js, Python, or Go to handle authentication automatically.