Set up the MassPay wallet

Set up the account's MassPay payout wallet from the same profile the dashboard's setup form collects, and make it the default payout method.

Required: firstName, lastName, email, country, address1, city, stateProvince, postalCode, plus businessName when accountType is BUSINESS. Optional: middleName, mobileNumber, language, dateOfBirth, address2. Enter everything as on the payee's government-issued ID. Every field is checked before anything is sent to MassPay; a refused profile answers 400 invalid_profile naming the first bad field, with all of them in errors.

• No payee yet → the payee is created at MassPay with the full profile (201).
• Payee exists but lacks required details (see missingFields on GET /payouts/masspay/profile) → the fields you send fill them in. country, email and businessName stay as MassPay has them; send at least the missing fields.
• Payee complete → the body is not needed; the wallet is (re)attached.

Activation: before the first payout to the wallet, the payee must open activationUrl once in a browser (a MassPay requirement). The link expires — get a fresh one from GET /payouts/masspay/activation when you send the payee there. Payout requests to a wallet that is not activated are refused (masspay_not_activated).

Safe to retry: there is one MassPay payee and one wallet per account. The key's own account only, after the ID check.

{
  "accountType": "INDIVIDUAL",
  "firstName": "Jane",
  "lastName": "Doe",
  "email": "jane@example.com",
  "country": "SWE",
  "address1": "Storgatan 1",
  "city": "Stockholm",
  "stateProvince": "Stockholm County",
  "postalCode": "111 22",
  "dateOfBirth": "1994-05-17",
  "language": "sv"
}

{
  "address1": "Storgatan 1",
  "city": "Stockholm",
  "stateProvince": "Stockholm County",
  "postalCode": "111 22"
}

{
  "method": {
    "id": "clxpm0001method",
    "type": "MASSPAY",
    "isDefault": true,
    "nickname": null,
    "label": "Payout wallet · SWE",
    "holderType": "INDIVIDUAL",
    "createdAt": "2026-10-30T10:00:00.000Z",
    "paxum": null,
    "masspay": {
      "country": "SWE",
      "currency": null,
      "payerName": null,
      "activated": false
    },
    "bank": null
  },
  "activationUrl": "https://payee.masspay.io/activate/…",
  "created": true,
  "completed": false
}

curl -X POST "https://www.dropfans.io/api/external/v1/payouts/masspay/profile" \
  -H "Authorization: Bearer $DROPFANS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "accountType": "INDIVIDUAL",
  "firstName": "Jane",
  "lastName": "Doe",
  "email": "jane@example.com",
  "country": "SWE",
  "address1": "Storgatan 1",
  "city": "Stockholm",
  "stateProvince": "Stockholm County",
  "postalCode": "111 22",
  "dateOfBirth": "1994-05-17",
  "language": "sv"
}'

const res = await fetch(`https://www.dropfans.io/api/external/v1/payouts/masspay/profile`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DROPFANS_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "accountType": "INDIVIDUAL",
    "firstName": "Jane",
    "lastName": "Doe",
    "email": "jane@example.com",
    "country": "SWE",
    "address1": "Storgatan 1",
    "city": "Stockholm",
    "stateProvince": "Stockholm County",
    "postalCode": "111 22",
    "dateOfBirth": "1994-05-17",
    "language": "sv"
  }),
});
console.log(await res.json());

import os
import requests

res = requests.post(
    "https://www.dropfans.io/api/external/v1/payouts/masspay/profile",
    headers={"Authorization": f"Bearer {os.environ['DROPFANS_API_KEY']}"},
    json={
        "accountType": "INDIVIDUAL",
        "firstName": "Jane",
        "lastName": "Doe",
        "email": "jane@example.com",
        "country": "SWE",
        "address1": "Storgatan 1",
        "city": "Stockholm",
        "stateProvince": "Stockholm County",
        "postalCode": "111 22",
        "dateOfBirth": "1994-05-17",
        "language": "sv",
    },
)
print(res.json())