Issuers

Set payout addresses

PUT/v1/issuers/{id}/payout-addresses

Replaces the identity's payout-address set.

API key · or dashboard session.

Request

Shell
curl -fsS -X PUT "$API/v1/issuers/iss_0198f80c-…/payout-addresses" \
  -H "Authorization: Bearer $PAYDAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "payout_address_ids": ["pa_0198f80c-4444-7dc1-a369-90556a64f700"] }'

Response

200 OK
{
  "id": "iss_0198f80c-2222-7dc1-a369-90556a64f700",
  "name": "Acme LLC",
  "contact_email": "billing@acme.example",
  "details": null,
  "email_verified": true,
  "email_verified_at": "2026-09-06T12:05:00Z",
  "payout_addresses": [ {
      "id": "pa_0198f80c-4444-7dc1-a369-90556a64f700",
      "address": "0x1111111111111111111111111111111111111111",
      "label": "Treasury",
      "created_at": "2026-09-06T12:00:00Z"
    } ],
  "created_at": "2026-09-06T12:00:00Z",
  "updated_at": "2026-09-06T12:00:00Z"
}

Path parameters

idiss_ idrequired

Body

payout_address_idspa_ id[]required
≤25. Ordered; the first is the default for issuer_id-only creates. Empty clears.

Response

Issuer.

Status codes

  • 404payout_address_not_found