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

Description

Create Payment Description: The /payment/ endpoint allows creation of payment records with transaction details, currency information, and associated files. Method: POST Authorization:
  • Required role: admin or higher
Request Payload:

Code Examples

Authorizations

Authorization
string
header
required

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

Body

user
string
required

TenantUserId associated with the payment

title
string
required

Title/description of the payment

transactionDate
string<date-time>
required

Date and time of the transaction

currency
string
required

Currency code (e.g., USD, NGN)

amount
number
required

Amount in the specified currency

amountUSD
number
required

Amount converted to USD

conversionRate
number

Exchange rate used for conversion

memo
string

Additional notes about the payment

files
file[]

File attachments (receipts, invoices, etc.)

id
string

Optional custom ID for the payment record

Response

Success

id
string
TenantId
integer
TenantUserId
string
title
string
transactionDate
string<date>
currency
string
amount
number
amountUSD
number
conversionRate
number
memo
string
updatedAt
string<date-time>
createdAt
string<date-time>