Add Payment Method

​

Endpoint

POST /wallets/{id}/payment-method

​

Description

​

Path Parameters

​

Request Body

{
  "type": "bank_account"
}

​

Request Fields

​

Supported Payment Method Types

Additional payment method types may be supported depending on your integration and region.

​

Response

​

Success Response (200 OK)

{
  "data": {
    "id": "3d2e3f3e-3b3c-4907-a4fd-e241203440d7",
    "status": "active",
    "payment_methods": [
      {
        "account_name": "Prosacco Erdman",
        "account_number": "3515200757",
        "account_type": "savings",
        "address": null,
        "bank_address": "9896 Bulah Roads, Suite 256, North Carolina, Kansas, 09819, US",
        "bank_code": "035",
        "bank_name": "Wema Bank"
      }
    ],

    "balance": {
      "amount": 0,
      "currency": "NGN"
    }
  }
}

​

Response Fields

The payment_methods array may initially be empty if additional verification or setup is required before activation.

​

Example cURL Request

curl -X POST https://api.yourdomain.com/wallets/{id}/payment-method \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "bank_account"
  }'

​

Common Errors

​

Notes & Best Practices

• Ensure the wallet exists and is active before adding a payment method.
• Some payment methods may require additional verification steps before they become usable.
• Always store and reference the wallet ID securely.
• Use sandbox mode to test payment method creation before moving to production.

​

Next Steps

• Fund the wallet
• Initiate payouts
• Retrieve wallet details
• Monitor wallet activity via webhooks