Create Payment Link (New)

POST

/users/payment/create

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Examples

Responses

🟢201

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/users/payment/create' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "fromDate": "2025-01-11",
    "toDate": "2025-01-12",
    "price": 50,
    "amount": 135,
    "roomsTaken": 3,
    "reference": "1711484572341",
    "currency": "NGN",
    "roomId": "671d6b4620e8ec15cbf304e2",
    "channel": "card",
    "reservation": {
        "type": "self"
    },
    "isDiscount": true,
    "coupon": "SUJE08"
}'

Response Example

{
    "status": true,
    "message": "Payment Initiation is successful",
    "data": {
        "payment": {
            "userId": "66084391607d43e029086221",
            "roomId": "6573321e44101bc6039a4ba4",
            "currency": "NGN",
            "amount": 117500,
            "roomsTaken": 1,
            "reservation": {
                "type": "self",
                "_id": "66ed96f538fe2f6dd54ef68c"
            },
            "isDiscount": false,
            "nights": 2,
            "fromDate": "2024-09-20",
            "toDate": "2024-09-22",
            "status": false,
            "reference": "aessnwd2yg",
            "_id": "66ed96f538fe2f6dd54ef68b",
            "createdAt": "2024-09-20T15:38:29.843Z",
            "updatedAt": "2024-09-20T15:38:29.843Z",
            "__v": 0
        },
        "paystack": {
            "status": true,
            "message": "Authorization URL created",
            "data": {
                "authorization_url": "https://checkout.paystack.com/qcikpu3got5lcuc",
                "access_code": "qcikpu3got5lcuc",
                "reference": "aessnwd2yg"
            }
        }
    }
}

Modified at 2026-03-12 16:47:55

Payment For Reservation

Confirm Payment (New)