Skip to main content
POST
New Payment Request
This endpoint requires authentication. Include your Bearer token in the Authorization header.

Description

Endpoint: /payment-request/ Authorization:
  • Required role: user or higher
Method: POST

Request Body

This endpoint allows you to create a new payment request, specifying the payment setting ID, currency, amounts, and an optional memo.

Code Examples

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Body

application/json
currency
string
required

Currency code for the payment

amountUSD
number
required

Amount in USD

user
string<uuid>

ID of the user to create the payment request for. Admin/API key only. If not provided, creates for authenticated user.

PaymentSettingId
string

ID of the payment setting being used. Optional during creation but required for approval and payment processing.

amount
number

Amount in the specified currency

memo
string

Optional memo describing the purpose of payment

Response

Success

status
string
message
string
newpayment
object