Wallets

Your account holds one or more wallets: a main wallet where payments settle by default, and others you open to keep money apart (a building fund, a youth account, school fees). Each has its own balance and history; each payment method takes a wallet_id to say where money goes.

Open a wallet

curl https://api.catholicpay.example/api/v1/merchant/wallets \
  -H "Authorization: Bearer $CATHOLICPAY_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Building fund" }'

name is up to 100 characters. A new live wallet is PRIVATE: payers are not offered it until an admin publishes it in the portal.

Find a wallet by account number

curl "https://api.catholicpay.example/api/v1/merchant/wallets/lookup?account_number=0123456789" \
  -H "Authorization: Bearer $CATHOLICPAY_SECRET_KEY"

Your organisation’s number gives your main wallet; a wallet’s own number gives that wallet.

List your wallets and their balances with GET /merchant/account.