Step 1

Getting started with Merchant Collections

From invitation to your first sandbox collection in a few steps.

  1. 1. Accept your merchant invitation

    NexuzPayz merchants are onboarded by invitation. Open the secure link sent to your business email (valid for 72 hours), set your password, and log in to the merchant portal.

  2. 2. Complete profile, settlement & KYC

    In the portal, add your business details, configure a GHS settlement account, and upload KYC documents. Sandbox API keys are available immediately; live keys require KYC approval and an active merchant account.

  3. 3. Create a sandbox API key

    Go to API keys in the merchant portal and create a sk_test_ key. Copy the secret immediately — it is shown only once.

  4. 4. Make your first collection

    Call the Collections API from your server. Replace the API key with your sandbox secret:

    curl -X POST https://api.nexuzpayz.com/api/v1/merchant/collections \
  -H "Authorization: Bearer sk_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "10.00",
    "method": "payment_link",
    "merchantReference": "TEST-001",
    "payerEmail": "test@example.com"
  }'

    The response includes a paymentUrl. Redirect your customer there to complete payment in sandbox mode.

  5. 5. Register webhooks & go live

    Register an HTTPS webhook endpoint to receive collection.succeeded events. After KYC approval, create a sk_live_ key and switch your integration to live collections.

    Read the integration guides → · Browse the full API reference →