Paystack · Example Payload

Paystack Initiate Transfer Example

Pay out funds from your Paystack balance to a previously created transfer recipient.

PaymentsAfricaFintechRecurring BillingMarketplacesPayoutsMobile MoneyStripe

Paystack Initiate Transfer Example is an example object payload from Paystack, with 4 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

summarydescriptionrequestresponse

Example Payload

{
  "summary": "Initiate a transfer",
  "description": "Pay out funds from your Paystack balance to a previously created transfer recipient.",
  "request": {
    "method": "POST",
    "url": "https://api.paystack.co/transfer",
    "headers": {
      "Authorization": "Bearer sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "Content-Type": "application/json"
    },
    "body": {
      "source": "balance",
      "amount": 250000,
      "recipient": "RCP_2x5j67tnnw1t98k",
      "reason": "May payout"
    }
  },
  "response": {
    "status": 200,
    "body": {
      "status": true,
      "message": "Transfer requires OTP to continue",
      "data": {
        "transfer_code": "TRF_1ptvuv321ahaa7q",
        "reference": "n7ll9pzl6b",
        "amount": 250000,
        "currency": "NGN",
        "source": "balance",
        "reason": "May payout",
        "recipient": 23645321,
        "status": "otp",
        "created_at": "2026-05-24T10:35:00.000Z"
      }
    }
  }
}