Initiate Payment

POST

https://stageapi.partake.ng/api/v2/payments/initiate

Last modified:2026-07-10 13:15:30

Maintainer:Not configured

Creates a pending transaction and returns a gateway redirect URL. Public — JWT optional. Rate-limited to 20 requests per 10 minutes per IP.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200

application/json

Bodyapplication/json

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://stageapi.partake.ng/api/v2/payments/initiate' \
--header 'Content-Type: application/json' \
--data-raw '{
    "contestId": "{{contestId}}",
    "entryId": "{{entryId}}",
    "numberOfVotes": 3,
    "gateway": "paystack",
    "email": "voter@example.ng"
}'

Response Example

200 - 200 – Payment URL returned

{
  "success": true,
  "data": {
    "transactionId": "txn_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "paymentUrl": "https://checkout.paystack.com/0peioxfhpn"
  },
  "message": "Payment initiated successfully."
}

Modified at 2026-07-10 13:15:30

Payout Webhook (Payouts)

Get Transaction Status