Payment

Payment Gateway For Marvelly App

Initialize a Live Payment

get

This endpoint initiates a payment transaction in the live environment.

Query parameters

emailstring · emailRequired

Customer's email address.

Example: [email protected]

amountintegerRequired

The amount to be paid in the lowest currency unit (e.g., kobo for NGN).

Example: 500000

callback_urlstring · urlRequired

The URL to redirect to after the transaction is complete.

Example: https://your-domain.com/payment/callback

first_namestringOptional

Customer's first name.

Example: John

last_namestringOptional

Customer's last name.

Example: Doe

phonestringOptional

Customer's phone number.

Example: 08012345678

redbooleanOptional

If set to 'true', the user will be automatically redirected to the payment page.

Example: false

Responses

200

Payment initialized successfully.

application/json

statusbooleanOptionalExample: true

messagestringOptionalExample: Authorization URL created

302

Redirecting to Paystack's payment page (occurs when red query parameter is 'true').

500

Payment initialization failed.

application/json

get

/live/paystack/init

HTTPcURLJavaScriptPython

GET /live/paystack/init?email=user%40example.com&amount=500000&callback_url=https%3A%2F%2Fyour-domain.com%2Fpayment%2Fcallback HTTP/1.1
Host: pay.marvelly.com.ng
Accept: */*

{
  "status": true,
  "message": "Authorization URL created",
  "data": {
    "authorization_url": "https://checkout.paystack.com/...",
    "access_code": "a1b2c3d4e5",
    "reference": "T123456789012345"
  }
}

Verify a Live Payment

get

This endpoint verifies the status of a transaction in the live environment using the transaction reference.

Query parameters

referencestringRequired

The transaction reference obtained after initialization.

Example: T123456789012345

Responses

200

Transaction verified successfully.

application/json

statusbooleanOptionalExample: true

messagestringOptionalExample: Transaction verified and logged

400

Bad request, such as a missing reference or failed verification.

application/json

500

Internal server error, including database issues.

application/json

get

/live/paystack/verify

HTTPcURLJavaScriptPython

GET /live/paystack/verify?reference=T123456789012345 HTTP/1.1
Host: pay.marvelly.com.ng
Accept: */*

{
  "status": true,
  "message": "Transaction verified and logged",
  "data": {
    "email": "[email protected]",
    "amount": 5000,
    "reference": "T123456789012345",
    "status": "success",
    "fees": 75,
    "paid_at": "2025-08-18T14:30:00.000Z",
    "channel": "card",
    "currency": "NGN",
    "ip_address": "192.168.1.1",
    "service": "paystack"
  }
}

Initialize a Test Payment

get

This endpoint initiates a payment transaction in the test environment.

Query parameters

emailstring · emailRequired

Customer's email address.

Example: [email protected]

amountintegerRequired

The amount to be paid in the lowest currency unit (e.g., kobo for NGN).

Example: 500000

callback_urlstring · urlRequired

The URL to redirect to after the transaction is complete.

Example: https://your-domain.com/payment/callback

first_namestringOptional

Customer's first name.

Example: John

last_namestringOptional

Customer's last name.

Example: Doe

phonestringOptional

Customer's phone number.

Example: 08012345678

redbooleanOptional

If set to 'true', the user will be automatically redirected to the payment page.

Example: false

Responses

200

Payment initialized successfully.

application/json

statusbooleanOptionalExample: true

messagestringOptionalExample: Authorization URL created

302

Redirecting to Paystack's payment page (occurs when red query parameter is 'true').

500

Payment initialization failed.

application/json

get

/test/paystack/init

HTTPcURLJavaScriptPython

GET /test/paystack/init?email=user%40example.com&amount=500000&callback_url=https%3A%2F%2Fyour-domain.com%2Fpayment%2Fcallback HTTP/1.1
Host: pay.marvelly.com.ng
Accept: */*

{
  "status": true,
  "message": "Authorization URL created",
  "data": {
    "authorization_url": "https://checkout.paystack.com/...",
    "access_code": "a1b2c3d4e5",
    "reference": "T123456789012345"
  }
}

Verify a Test Payment

get

This endpoint verifies the status of a transaction in the test environment using the transaction reference.

Query parameters

referencestringRequired

The transaction reference obtained after initialization.

Example: T123456789012345

Responses

200

Transaction verified successfully.

application/json

statusbooleanOptionalExample: true

messagestringOptionalExample: Transaction verified and logged

400

Bad request, such as a missing reference or failed verification.

application/json

500

Internal server error, including database issues.

application/json

get

/test/paystack/verify

HTTPcURLJavaScriptPython

GET /test/paystack/verify?reference=T123456789012345 HTTP/1.1
Host: pay.marvelly.com.ng
Accept: */*

{
  "status": true,
  "message": "Transaction verified and logged",
  "data": {
    "email": "[email protected]",
    "amount": 5000,
    "reference": "T123456789012345",
    "status": "success",
    "fees": 75,
    "paid_at": "2025-08-18T14:30:00.000Z",
    "channel": "card",
    "currency": "NGN",
    "ip_address": "192.168.1.1",
    "service": "paystack"
  }
}