Skip to main content
POST
/
payment
/
Create Payment
curl --request POST \
  --url https://server26-dot-royalti-project.uc.r.appspot.com/payment/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "user": "8560f85a-2416-47d7-a908-5cd2a6c51659",
  "title": "Payment Receipt test",
  "transactionDate": "2023-04-21T12:00:00Z",
  "currency": "USD",
  "amount": 74000,
  "amountUSD": 100,
  "conversionRate": 740,
  "memo": "Sale of album",
  "files": [
    "file1.pdf",
    "file2.pdf"
  ],
  "id": "8560f85a-2416-47d7-a908-5cd2a6c51659"
}'
{
  "id": "a6afa463-1073-4e14-860e-f5bbd9da0f74",
  "TenantId": 1,
  "UserId": "8560f85a-2416-47d7-a908-5cd2a6c51659",
  "title": "Payment Receipt test",
  "transactionDate": "2023-04-21",
  "currency": "USD",
  "amount": 74000,
  "amountUSD": 100,
  "conversionRate": 740,
  "memo": "Sale of album",
  "updatedAt": "2023-06-14T08:04:36.374Z",
  "createdAt": "2023-06-14T08:04:36.374Z"
}
This endpoint requires authentication. Include your Bearer token in the Authorization header.

Code Examples

const response = await fetch('https://server26-dot-royalti-project.uc.r.appspot.com/payment/', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "user": "sample-user",
    "title": "sample-title",
    "transactionDate": "2024-01-21T12:00:00Z",
    "currency": "sample-currency",
    "amount": 1,
    "amountUSD": 1,
    "conversionRate": 1,
    "memo": "sample-memo",
    "files": [
      {}
    ],
    "id": "sample-id"
  })
});

const data = await response.json();
console.log(data);

Authorizations

Authorization
string
header
required

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

Body

application/json
user
string
required

User ID 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
string[]

Array of file names associated with the payment

id
string

UserId of the user

Response

Success

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