Skip to main content

Your First Payout in 5 Minutes

Get started with NextAPI by sending your first payout in just a few minutes. This quickstart will walk you through the essential steps to make a successful payment.

Prerequisites​

  • NextAPI account and API keys
  • Basic understanding of REST APIs
  • A test wallet or bank account for receiving payments

Step 1: Set Up Your Authentication​

First, authenticate your requests using your API keys:

curl -X POST "https://api.nextapi.com/v1/auth" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Step 2: Create a Payout​

Send your first payout with minimal parameters:

curl -X POST "https://api.nextapi.com/v1/payouts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 1000,
    "currency": "PHP",
    "recipient": {
      "type": "wallet",
      "id": "test_wallet_123"
    }
  }'

Step 3: Verify the Transaction​

Check the status of your payout:

curl -X GET "https://api.nextapi.com/v1/payouts/payout_123" \
  -H "Authorization: Bearer YOUR_API_KEY"

What's Next?​

Congratulations! You've sent your first payout. Next, explore:

  • [Creating payment links](./create-your-first-payment-link
  • [Setting up sub-merchant wallets](./your-first-sub-merchant-wallet
  • [Understanding the payout lifecycle](../guides/core-concepts/the-lifecycle-of-a-payout

Troubleshooting​

If you encounter issues, check our [troubleshooting guide](../guides/how-to/handle-payout-failures-retries or verify your API credentials in the dashboard.