Partner program

curl https://partners.socialmatterspay.com/v1/partners/application-fee

HTTP 200
Cache-Control: no-store

{
  "object": "partner_application_fee",
  "required": true,
  "amount_cents": 29900,
  "currency": "USD",
  "refundable": false,
  "program_terms": {
    "pool_bps": 2500,
    "window_months": 24,
    "payouts": "monthly on the 1st for the prior calendar month"
  }
}

curl -X POST https://partners.socialmatterspay.com/v1/partners/apply \
  -H 'Content-Type: application/json' \
  -d '{
  "legal_name": "Ridgeline Advisory LLC",
  "display_name": "Ridgeline",
  "entity_type": "business",
  "contact_name": "Morgan Ellis",
  "email": "morgan@ridgeline.example",
  "password": "correct horse battery staple",
  "website_url": "https://ridgeline.example",
  "acquisition_description": "Bookkeeping clients that bill by invoice",
  "fee_debit_account": {
    "account_number": "000222333444",
    "routing_number": "110000000",
    "account_type": "checking",
    "account_holder_name": "Ridgeline Advisory LLC"
  },
  "fee_debit_authorization": {
    "accepted": true,
    "signer_name": "Morgan Ellis",
    "signer_title": "Managing member",
    "text_sha256": "e34143589ec46d06db50db75854f9699b7e796f6db518f607ed6da17da6aa42f"
  }
}'

HTTP 201
Cache-Control: no-store

{
  "partner_id": "1506590a-fda8-428f-8ed1-cf5a8e52f8f5",
  "status": "pending",
  "application_fee": {
    "provider": "whop",
    "amount_cents": 29900,
    "currency": "USD",
    "status": "awaiting_payment",
    "checkout_url": "https://whop.com/checkout/ch_e2e000001",
    "paid_at": null
  },
  "fee_debit_authorization": {
    "entry_code": "CCD",
    "account_last4": "3444",
    "text_sha256": "e34143589ec46d06db50db75854f9699b7e796f6db518f607ed6da17da6aa42f"
  }
}

curl -X POST https://partners.socialmatterspay.com/v1/partners/fee-debit-authorization/preview \
  -H 'Content-Type: application/json' \
  -d '{
  "entity_type": "business",
  "account_holder_name": "Ridgeline Advisory LLC",
  "account_last4": "3444"
}'

HTTP 200
Cache-Control: no-store

{
  "entry_code": "CCD",
  "authorization_text": "Ridgeline Advisory LLC authorizes Social Matter Payments LLC to initiate ACH debit entries (CCD) to the business bank account ending in 3444 for fees and other amounts Ridgeline Advisory LLC owes Social Matter Payments LLC under the partner agreement that its commission payouts from Social Matter Payments LLC do not cover. The amount of each debit appears on Ridgeline Advisory LLC's statement before the debit is made. This authorization stays in effect until Social Matter Payments LLC receives written notice of revocation at work@socialmatters.pro in time to act on it. Revoking it does not cancel amounts already owed.",
  "text_sha256": "e34143589ec46d06db50db75854f9699b7e796f6db518f607ed6da17da6aa42f"
}

curl -X POST https://partners.socialmatterspay.com/webhooks/whop \
  -H 'webhook-id: msg_example0001' \
  -H 'webhook-timestamp: 1793146957' \
  -H 'webhook-signature: v1,W91vY9SBykVSPcYxzEaNNkLw1oORzuTwYRP4R41ldY0=' \
  -H 'Content-Type: application/json' \
  -d '{
  "type": "payment.succeeded",
  "api_version": "v1",
  "data": {
    "id": "pay_example0001"
  }
}'

HTTP 200
Cache-Control: no-store

{
  "received": true,
  "confirmed": 1
}

curl -X POST https://partners.socialmatterspay.com/webhooks/finix \
  -H 'Finix-Signature: timestamp=1793146958, sig=d9bb260b9f14fffb1c74f6b8920fefe47876c3c921f94c34b781a4902e847049' \
  -H 'Content-Type: application/json' \
  -d '{
  "id": "event_example1",
  "type": "created",
  "entity": "transfer_attempt",
  "occurred_at": "2026-10-28T00:22:38.515Z",
  "_embedded": {
    "transfer_attempts": [
      {
        "id": "transfer_attempt_example1"
      }
    ]
  }
}'

HTTP 200
Cache-Control: no-store

{
  "received": true,
  "confirmed": 1
}

curl -X POST https://partners.socialmatterspay.com/v1/partners/login \
  -H 'Content-Type: application/json' \
  -d '{
  "email": "morgan@ridgeline.example",
  "password": "correct horse battery staple"
}'

HTTP 200
Cache-Control: no-store

{
  "object": "sign_in_challenge",
  "challenge": "sign_in_challenge",
  "step": "enroll",
  "expires_at": "2026-10-28T00:32:38.030Z",
  "secret": "authenticator_secret",
  "otpauth_uri": "otpauth://totp/Social%20Matter%20Payments%3Amorgan%40ridgeline.example?secret=authenticator_secret&issuer=Social%20Matter%20Payments&algorithm=SHA1&digits=6&period=30",
  "role": "owner"
}

curl -X POST https://partners.socialmatterspay.com/v1/partners/logout \
  -H 'Authorization: Bearer partner_session_token'

HTTP 200
Cache-Control: no-store

{
  "logged_out": true
}

curl https://partners.socialmatterspay.com/v1/partners/session \
  -H 'Authorization: Bearer partner_session_token'

HTTP 200
Cache-Control: no-store

{
  "user": {
    "userId": "1e0cc508-9983-4120-8228-3fcea3caf9b2",
    "role": "owner",
    "partnerId": "1506590a-fda8-428f-8ed1-cf5a8e52f8f5",
    "agentId": null,
    "email": "morgan@ridgeline.example"
  }
}

curl https://partners.socialmatterspay.com/v1/agents/session \
  -H 'Authorization: Bearer agent_session_token'

HTTP 200
Cache-Control: no-store

{
  "user": {
    "userId": "1c9fbf65-7fbb-4262-89d9-bb7ab50525a6",
    "role": "agent",
    "partnerId": "1506590a-fda8-428f-8ed1-cf5a8e52f8f5",
    "agentId": "62a14022-b94b-4d55-b7d7-bd0eb19611c2",
    "email": "sam@ridgeline.example"
  }
}

curl -X POST https://partners.socialmatterspay.com/v1/agents/accept-invite \
  -H 'Content-Type: application/json' \
  -d '{
  "token": "agent_invite_token",
  "password": "correct horse battery staple"
}'

HTTP 200
Cache-Control: no-store

{
  "agent_id": "62a14022-b94b-4d55-b7d7-bd0eb19611c2",
  "status": "active",
  "sign_in": {
    "object": "sign_in_challenge",
    "challenge": "sign_in_challenge",
    "step": "enroll",
    "expires_at": "2026-10-28T00:32:38.090Z",
    "secret": "authenticator_secret",
    "otpauth_uri": "otpauth://totp/Social%20Matter%20Payments%3Asam%40ridgeline.example?secret=authenticator_secret&issuer=Social%20Matter%20Payments&algorithm=SHA1&digits=6&period=30",
    "role": "agent"
  }
}

curl https://partners.socialmatterspay.com/r/z8cg3sg5mr

HTTP 302
Location: https://socialmatterspay.test/apply?ref=z8cg3sg5mr
Set-Cookie: smp_ref=z8cg3sg5mr; Max-Age=2592000; Path=/; Secure; SameSite=Lax
Cache-Control: no-store

curl -X POST https://partners.socialmatterspay.com/v1/partners/login/verify \
  -H 'Content-Type: application/json' \
  -d '{
  "challenge": "sign_in_challenge",
  "code": "123456"
}'

HTTP 200
Cache-Control: no-store

{
  "token": "partner_session_token",
  "expires_at": "2026-10-28T12:22:38.033Z",
  "role": "owner",
  "partner_id": "1506590a-fda8-428f-8ed1-cf5a8e52f8f5",
  "agent_id": null,
  "backup_codes": [
    "backup_code_11",
    "backup_code_12",
    … 8 more
  ]
}

curl -X POST https://partners.socialmatterspay.com/v1/partners/password/set \
  -H 'Content-Type: application/json' \
  -d '{
  "token": "one_time_link_token",
  "password": "the agent password, set again"
}'

HTTP 200
Cache-Control: no-store

{
  "object": "sign_in_challenge",
  "challenge": "sign_in_challenge",
  "step": "enroll",
  "expires_at": "2026-10-28T00:32:38.433Z",
  "secret": "authenticator_secret",
  "otpauth_uri": "otpauth://totp/Social%20Matter%20Payments%3Asam%40ridgeline.example?secret=authenticator_secret&issuer=Social%20Matter%20Payments&algorithm=SHA1&digits=6&period=30",
  "role": "agent"
}

curl -X POST https://partners.socialmatterspay.com/v1/partners/password/forgot \
  -H 'Content-Type: application/json' \
  -d '{
  "email": "sam@ridgeline.example"
}'

HTTP 202
Cache-Control: no-store

{
  "sent_if_known": true
}

curl -X POST https://partners.socialmatterspay.com/v1/partners/password/reset \
  -H 'Content-Type: application/json' \
  -d '{
  "token": "one_time_link_token",
  "password": "a new long agent password"
}'

HTTP 200
Cache-Control: no-store

{
  "password_reset": true,
  "next": "sign_in"
}