---
title: "Add provider"
method: POST
path: "/providers/"
tags: ["Payments"]
---

# Add provider

`POST /providers/`

## Headers

- `x-simple-workspace` string, required
- `x-piriod-test-mode` boolean

## Request body

- Provider — Account-level configuration that connects a payment gateway to the workspace (e.g. credentials, commerce code).
  - `gateway` string, required — Gateway ID (e.g. `transbank`, `getnet`, `stripe`, `mercadopago`, ...).
  - `commerce_code` string, required
  - `extra_data` object — Gateway-specific configuration payload.
  - `created` string, date-time

## Response `201`

Provider created.

- Provider — Account-level configuration that connects a payment gateway to the workspace (e.g. credentials, commerce code).
  - `gateway` string, required — Gateway ID (e.g. `transbank`, `getnet`, `stripe`, `mercadopago`, ...).
  - `commerce_code` string, required
  - `extra_data` object — Gateway-specific configuration payload.
  - `created` string, date-time

## Other responses

- `400` — Request body or query parameters failed validation.

---

[API](https://skmtc.net/piriod/apis/piriod-api.md) · [All operations](https://skmtc.net/piriod/apis/piriod-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/piriod/piriod-api/revisions/70cbc827dc7b/schema)