# Onboard the currently authenticated merchant to IPS

`POST https://api.leapa.co/v2/ips/onboard-merchant`

Self-service IPS onboarding triggered from the merchant portal — for example after the merchant adds their first payout account. Resolves the merchant from the bearer token. Idempotent on merchantId.

Send your API key as a bearer token in the `Authorization` header.

## Response 200

- `merchant_id` · _string_
- `status` · _string_
  Allowed values: `success`, `partial`, `failed`
- `message` · _string_
- `ips_customer_id` · _string_
- `ips_alias_id` · _string_
- `ips_account_id` · _string_
- `ips_account_id_test` · _string_
- `mobile` · _string_
- `leapa_balance_account_id` · _string_

```json
{
  "merchant_id": "mer_1b47d0e9ca",
  "status": "success",
  "message": "Request sent to the payer",
  "ips_customer_id": "cus_3d8e51fa20",
  "ips_alias_id": "+25779123456",
  "ips_account_id": "acc_62f3a8d15b",
  "ips_account_id_test": "00012345678901",
  "mobile": "string",
  "leapa_balance_account_id": "acc_62f3a8d15b"
}
```

## Status codes

- `200` OK
- `400` Bad request
- `401` Unauthorized
- `402` Payment required
- `403` Forbidden
- `404` Not found
- `428` Precondition required
- `500` Server error

## Example

```bash
curl -X POST "https://api.leapa.co/v2/ips/onboard-merchant" \
  -H "Authorization: Bearer $LEAPA_API_KEY" \
  -H "Accept: application/json"
```

---

_Generated from the Leapa documentation at leapa.co/docs._