Wallet Settings

Create wallet settings

POST/api/v1/wallet-settings

Sets the mobile money number a seller's payouts are sent to — required before any withdrawal can be requested.

Requires Authorization

SELLER only

Authenticated action

Body parameters

`payoutPhoneNumber`stringrequired
`payoutProvider`stringrequired	Mobile money provider code.
`payoutCountry`stringrequired
`minimumPayoutAmounts`object	Per-currency minimum withdrawal amount, e.g. { "USD": 20 }.

Request

curl --request POST \
  --url https://api.swiftgoma.com/api/v1/wallet-settings \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "payoutPhoneNumber": "<payoutPhoneNumber>",
  "payoutProvider": "<payoutProvider>",
  "payoutCountry": "<payoutCountry>",
  "minimumPayoutAmounts": {}
}'

201Example response

{
  "success": true,
  "data": {
    "id": "ws_1a2b3c",
    "sellerProfileId": "sp_2b3c4d",
    "payoutPhoneNumber": "243812345678",
    "payoutProvider": "MTN_MOMO_COD",
    "payoutCountry": "CD",
    "minimumPayoutAmounts": {
      "USD": 20,
      "CDF": 50000
    }
  }
}