Update an account

​

Create a new account

Path Parameters
  • id
    Type: string
    max length:  
    100
    required
Body·
required
application/json

Request to update an Account

  • Type: object
    • type
      Type: string enum

      The type of account to create. May be one of custom, express or standard.

      values
      • standard
      • custom
      • express
    • country
      Type: string
      max length:  
      100

      The account's country.

    • default_currency
      Type: string ·

      Three-letter ISO currency code representing the default currency for the account.

    • email
      Type: string | null

      The email address of the account holder. This is only to make the account easier to identify to you.

    • details_submitted
      Type: boolean

      Whether account details have been submitted. Accounts with Paypercut Dashboard access, which includes Standard accounts, cannot receive payouts before this is true. Accounts where this is false should be directed to an onboarding flow to finish submitting account details.

    • requirements
      Type: object ·
    • business_profile
      Type: object ·
    • business_type
      Type: string | null · enum

      The business type.

      values
      • company
      • individual
      • non_profit
    • company
      Type: object ·

      Information about the company or business.

    • tos_acceptance
      Type: object ·

      Details on the account's acceptance of the Paypercut Services Agreement.

    • metadata

      Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to metadata.

      Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to metadata.

      • propertyName
        Type: string
    • capabilities
      Type: object | null ·

      Each key of the dictionary represents a capability, and each capability maps to its settings (for example, whether it has been requested or not). Each capability is inactive until you have provided its specific requirements and Paypercut has verified them. An account might have some of its requested capabilities be active and some be inactive.

    • documents
      Type: object ·

      Documents that may be submitted to satisfy various informational requests.

Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for put/v1/accounts/{id}
curl 'https://api.paypercut.io/v1/accounts/{id}' \
  --request PUT \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "type": "standard",
  "country": "GB",
  "default_currency": "EUR",
  "email": "john.smith@example.com",
  "details_submitted": true,
  "requirements": {
    "current_deadline": null,
    "currently_due": [
      ""
    ],
    "disabled_reason": "action_required.requested_capabilities",
    "errors": [
      {
        "code": "external_request",
        "reason": "",
        "requirement": ""
      }
    ],
    "eventually_due": [
      ""
    ],
    "past_due": [],
    "pending_verification": [
      ""
    ]
  },
  "business_profile": {
    "name": null,
    "support_email": null,
    "support_phone": null,
    "support_url": null,
    "mcc": 5411,
    "url": "https://www.example.com",
    "annual_revenue": {
      "amount": 1,
      "currency": "EUR",
      "fiscal_year_end": ""
    },
    "support_address": {
      "city": null,
      "country": null,
      "line1": null,
      "line2": null,
      "postal_code": null,
      "state": null
    },
    "monthly_estimated_revenue": {
      "amount": 1,
      "currency": "EUR"
    },
    "product_description": null,
    "estimated_worker_count": null
  },
  "business_type": "company",
  "company": {
    "address": {
      "city": null,
      "country": null,
      "line1": null,
      "line2": null,
      "postal_code": null,
      "state": null
    },
    "directors_provided": true,
    "executives_provided": true,
    "name": null,
    "owners_provided": true,
    "phone": null,
    "structure": "multi_member_llc",
    "tax_id": null,
    "tax_id_provided": true,
    "tax_id_registrar": "",
    "vat_id": null,
    "vat_id_provided": true,
    "directorship_declaration": {
      "date": "",
      "ip": "",
      "user_agent": ""
    },
    "ownership_declaration": {
      "date": "",
      "ip": "",
      "user_agent": ""
    },
    "representative_declaration": {
      "date": "",
      "ip": "",
      "user_agent": ""
    }
  },
  "tos_acceptance": {
    "date": "",
    "ip": "",
    "user_agent": "",
    "service_agreement": ""
  },
  "metadata": {
    "additionalProperty": ""
  },
  "capabilities": {
    "card_payments": {
      "requested": true
    }
  },
  "documents": {
    "bank_account_ownership_verification": {
      "files": [
        ""
      ]
    },
    "company_license": {
      "files": [
        ""
      ]
    },
    "company_memorandum_of_association": {
      "files": [
        ""
      ]
    },
    "company_ministerial_decree": {
      "files": [
        ""
      ]
    },
    "company_registration_verification": {
      "files": [
        ""
      ]
    },
    "company_tax_id_verification": {
      "files": [
        ""
      ]
    },
    "proof_of_address": {
      "files": [
        ""
      ]
    },
    "proof_of_registration": {
      "files": [
        ""
      ]
    },
    "proof_of_ultimate_beneficial_ownership": {
      "files": [
        ""
      ]
    }
  }
}'

{
  "id": "01KAKB228G3K4E98NFVE2MGHW4",
  "created": "2026-07-08T08:02:27.783Z",
  "external_accounts": {
    "items": [
      {
        "default_for_currency": true,
        "metadata": {
          "additionalProperty": "string"
        },
        "external_account": {
          "id": "ba_123",
          "object": "bank_account",
          "country": "DE",
          "currency": "EUR",
          "bank_name": "Example Bank",
          "holder_name": "Acme GmbH",
          "holder_type": "individual",
          "account_number": "**** 5678",
          "routing_number": "BNBGBGSF",
          "last4": "5678"
        }
      }
    ],
    "last_key": null
  },
  "type": "standard",
  "country": "GB",
  "default_currency": "EUR",
  "email": "john.smith@example.com",
  "details_submitted": true,
  "requirements": {
    "current_deadline": null,
    "currently_due": [
      "string"
    ],
    "disabled_reason": "action_required.requested_capabilities",
    "errors": [
      {
        "code": "external_request",
        "reason": "string",
        "requirement": "string"
      }
    ],
    "eventually_due": [
      "string"
    ],
    "past_due": [],
    "pending_verification": [
      "string"
    ]
  },
  "business_profile": {
    "name": null,
    "support_email": null,
    "support_phone": null,
    "support_url": null,
    "mcc": 5411,
    "url": "https://www.example.com",
    "annual_revenue": {
      "amount": 1,
      "currency": "EUR",
      "fiscal_year_end": "string"
    },
    "support_address": {
      "city": null,
      "country": null,
      "line1": null,
      "line2": null,
      "postal_code": null,
      "state": null
    },
    "monthly_estimated_revenue": {
      "amount": 1,
      "currency": "EUR"
    },
    "product_description": null,
    "estimated_worker_count": null
  },
  "business_type": "company",
  "company": {
    "address": {
      "city": null,
      "country": null,
      "line1": null,
      "line2": null,
      "postal_code": null,
      "state": null
    },
    "directors_provided": true,
    "executives_provided": true,
    "name": null,
    "owners_provided": true,
    "phone": null,
    "structure": "multi_member_llc",
    "tax_id": null,
    "tax_id_provided": true,
    "tax_id_registrar": "string",
    "vat_id": null,
    "vat_id_provided": true,
    "directorship_declaration": {
      "date": "2026-07-08T08:02:27.783Z",
      "ip": "string",
      "user_agent": "string"
    },
    "ownership_declaration": {
      "date": "2026-07-08T08:02:27.783Z",
      "ip": "string",
      "user_agent": "string"
    },
    "representative_declaration": {
      "date": "2026-07-08T08:02:27.783Z",
      "ip": "string",
      "user_agent": "string"
    }
  },
  "tos_acceptance": {
    "date": "2026-07-08T08:02:27.783Z",
    "ip": "string",
    "user_agent": "string",
    "service_agreement": "string"
  },
  "metadata": {
    "additionalProperty": "string"
  }
}

Account updated successfully