---
title: "Connect to personal merchant account"
method: POST
path: "/v2/merchant-accounts"
---

# Connect to personal merchant account

`POST /v2/merchant-accounts`

## Request

- Base URL: `https://api.signnow.com`
- URL: `https://api.signnow.com/v2/merchant-accounts`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/signnow/apis/signnow-api/docs/v2/merchant-accounts/post.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows API users to connect their personal SignNow account to the payment service.

For more information, see the [Request payments guide](/docs/request-payments-guide).

Currently, users can connect to Stripe and Stripe Connect. To receive payments, you'll need a valid payment system account.

<details>
<summary>Use additional attributes to customize the request</summary>

| Parameter | Description | Example |
| --- | --- | --- |
| `display_credit_card_form` | Boolean indicating whether to display the credit card form by Stripe to the recipient. Must be `true` if `account_type` is `Stripe`. | <img src="/reference-assets/images/Request_payments/payment_form_card.png" alt="Make Payment dialog with the credit card form">  |


</details>

## Request body

- object
  - `currency` string: The currency used for recipient transactions.
  - `secure_key` string: Secure API key (secret) given by Stripe. Required if `account_type` is `Stripe`.
  - `account_name` string, required: Name of the new merchant account.
  - `account_type` string, required: The type of payment service. Allowed values: `Stripe`, `StripeConnect`.
  - `publishable_key` string: Publishable API key given by Stripe. Required if `account_type` is `Stripe`.
  - `display_ach_form` boolean: Deprecated. Boolean indicating whether to display the ACH payment form by Stripe. If `account_type` is `Stripe`, the only accepted value is `false`. Omit this parameter.
  - `display_credit_card_form` boolean: Boolean indicating whether to display the credit card form by Stripe. Required if `account_type` is `Stripe`, and the only accepted value is `true`. Other account types ignore this parameter.

## Response `201`

Successful response.

- object
  - `data` object: Connected merchant account.
    - `id` string: ID of the merchant account.

## Other responses

- `400`: - `account_type` is incorrect or empty. - `account_name` is empty. - `publishable_key` is empty. - `secure_key` is empty. - `account_type` is `Stripe` and `display_ach_form` is `true`. - `account_type` is `Stripe` and `display_credit_card_form` is `false`.
- `403`: Too many active accounts.

---

[API](https://skmtc.dev/signnow/apis/signnow-api.md) - [All operations](https://skmtc.dev/signnow/apis/signnow-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signnow/apis/signnow-api/revisions/1c9c30a6142b?raw)