Partner Program

Set your payout details

curl -X PUT https://api.subscriby.net/v1/me/partner/payout-details \
  -H "Authorization: Bearer $SUBSCRIBY_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "paypal",
    "details": "ada@example.com",
    "legal_name": "Ada Lovelace",
    "tax_country": "GB",
    "us_person": false,
    "accept_terms": true
  }'

Writes how you are paid: the rail, what it pays to, and the tax declaration every cash rail needs. paypal and crypto take their one details (the PayPal email, the USDT TRC20 wallet address); wise and remitly take the bank account (bank_holder, bank_name, bank_country, bank_account_number, and bank_swift, bank_branch_code, bank_address when the transfer needs them); credit takes nothing and is accepted while that rail is open. Only the destination the chosen rail uses is kept, encrypted; a rail you leave behind keeps nothing on file. The response is the partner object with payout_method and payout_details_complete updated and the destination absent.

The terms come first. A rail cannot be saved until you have accepted the Partner Program Terms: send accept_terms: true here, or call the terms endpoint before.

put/v1/me/partner/payout-details

Request

  • Base URL: https://api.subscriby.net
  • URL: https://api.subscriby.net/v1/me/partner/payout-details
  • Auth: HTTP bearer

Headers

Idempotency-Keystring uuid required

A key unique to this operation, such as a fresh UUID. The same key replays the original 2xx response for 24 hours (with Idempotent-Replay: true), so a retry after a timeout never repeats the write; the same key with a different body is refused with 409.

Request body

method'credit' | 'paypal' | 'wise' | 'remitly' | 'crypto' required

How a partner takes what the Partner Program owes them. Credit needs nothing typed: an approved commission is applied to the partner's own Stripe balance and offsets their next invoices. The four cash rails are paid by the owner by hand: PayPal and USDT to one typed detail (an email, a wallet address), Wise and Remitly into a bank account (the holder, the bank, its country, the account number, and the codes some transfers need). Either is the partner's money, so it is stored encrypted and never announced. Whatever a rail charges to carry the money comes out of the payout, which the terms say in so many words.

detailsstring nullable

What a single-detail rail pays to: the PayPal email for paypal, the wallet address for crypto. Required on those rails, ignored on the others. At most 190 characters.

bank_holderstring nullable

The name on the bank account, for wise and remitly. At most 120 characters.

bank_namestring nullable

The bank, for wise and remitly. At most 120 characters.

bank_countrystring nullable

Where the bank is, as an ISO 3166-1 alpha-2 code, for wise and remitly.

bank_account_numberstring nullable

The account number or IBAN, for wise and remitly: letters, digits, spaces and dashes, at most 40 characters.

bank_swiftstring nullable

The SWIFT or BIC code, when the bank has one: 8 or 11 characters.

bank_branch_codestring nullable

The branch, routing, sort or IFSC code, when the transfer needs one: letters, digits, spaces and dashes, at most 20 characters.

bank_addressstring nullable

The account holder's address, when the transfer needs one. At most 200 characters.

legal_namestring nullable

The name a payment is made out to. Required on every cash rail. At most 120 characters.

tax_countrystring nullable

The country of tax residence, as an ISO 3166-1 alpha-2 code. Required on every cash rail.

us_personboolean nullable

Whether you are a US person for tax purposes.

accept_termsboolean

Send true to accept the Partner Program Terms with this save. A rail cannot be saved until the terms are accepted, here or through the terms endpoint.

Response

The partner object after the change.

Example response

{
  "data": {
    "id": "4b7e2d19-5c3a-4f80-9e6b-1d2c3b4a5f60",
    "status": "active",
    "code": "ADA7Q2X",
    "links": {
      "web": "https://app.subscriby.net/r/ADA7Q2X",
      "connectors": [
        {
          "connector": "telegram",
          "name": "Telegram",
          "url": "https://t.me/SubscribyBot?start=partner_ADA7Q2X"
        }
      ]
    },
    "commission_percent": "15.00",
    "base_percent": 5,
    "max_percent": 30,
    "commitment_points": 10,
    "paying_referrals": 3,
    "next_tier_at": 10,
    "next_tier_points": 5,
    "commission_months": 12,
    "hold_days": 30,
    "minimum_cash_payout": "50",
    "friend_discount_percent": 20,
    "friend_discount_months": 3,
    "currency": "USD",
    "clicks": 412,
    "referrals": {
      "total": 7,
      "signed_up": 3,
      "converted": 3,
      "expired": 1
    },
    "balance": {
      "pending": "11.7000",
      "payable": "52.6500",
      "credited": "0.0000",
      "paid": "117.0000",
      "earned": "181.3500"
    },
    "payout_method": "paypal",
    "payout_details_complete": true,
    "legal_name": "Ada Lovelace",
    "tax_country": "GB",
    "terms_accepted_at": "2026-10-02T09:14:02+00:00",
    "terms_version": "2026-10-10",
    "applied_at": "2026-10-01T09:14:02+00:00",
    "joined_at": "2026-10-02T09:14:02+00:00",
    "created_at": "2026-10-01T09:14:02+00:00",
    "updated_at": "2026-10-21T08:00:00+00:00"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.