---
title: "Ativar gateway"
method: POST
path: "/v1/marketplace/establishments/{id}/gateways"
tags: ["Estabelecimentos"]
---

# Ativar gateway

`POST /v1/marketplace/establishments/{id}/gateways`

## Path parameters

- `id` string, required

## Headers

- `integration-key` string, required
- `x-token` string, required

## Request body

- ActivateGatewayDto
  - `reference_id` union
    - string
    - number
  - `gateway_id` 2 | 4 | 6, required — ID da plataforma a ser ativada: 2 - PAGSEGURO, 4 - PAYTIME, 6 - BANKING
  - `active` boolean, required — True ativa a plataforma; false desativa a plataforma.
  - `form_receipt` 'BANKACCOUNT' | 'PAYTIME' | 'PAGBANK', required — Forma de recebimento dos valores.
  - `bank_account` BankAccountDto, required
    - `account_check_digit` string, required — Dígito verificador da conta.
    - `account_number` string, required — Número da conta bancária.
    - `bank_code` string, required — Código de três dígitos do banco.
    - `routing_number` string, required — Número da agência bancária (sem dígito).
    - `routing_check_digit` string — Dígito verificador da agência (se aplicável).
    - `type` 'CHECKING' | 'SAVINGS', required — Tipo de conta bancária.
  - `statement_descriptor` string — Nome a ser exibido na fatura. Obrigatório na ativação da plataforma Sub Paytime.
  - `plans` PlanDto[] — Planos a serem associados. Obrigatório na ativação das plataformas Sub Paytime e PagSeguro.
    - `id` number, required — ID do plano.
    - `active` boolean, required — Flag de ativação: true para ativar, false para desativar.
  - `fees_banking_id` number — Pacote de tarifas bancárias a ser associado. Obrigatório para ativação do Banking.

## Response `200`

- EstablishmentGatewayResponse
  - `id` number, required — ID da configuração do gateway.
  - `gateway` GatewayResponse, required
    - `id` number, required — ID do gateway.
    - `name` string, required — Nome de identificação.
  - `establishment_id` number, required — ID do estabelecimento.
  - `gateway_key` string, nullable, required — Chave do gateway (caso exista).
  - `status` 'PENDING' | 'WAITING' | 'ANALYZE' | 'BLOCKED' | 'CANCELED' | 'DISAPPROVED' | 'APPROVED', required — Status da configuração do gateway.
  - `active` boolean, required — Indica se está ativo.
  - `form_receipt` 'BANKACCOUNT' | 'PAYTIME' | 'PAGBANK' | 'ZOOPBANK', nullable, required — Forma de recebimento dos valores.
  - `bank_account` BankAccountType, required
    - `account_check_digit` string, required — Dígito verificador da conta.
    - `account_number` string, required — Número da conta bancária.
    - `routing_check_digit` string, required — Dígito verificador da agência (se aplicável).
    - `routing_number` string, required — Número da agência bancária (sem dígito).
    - `type` 'CHECKING' | 'SAVING', required — Tipo de conta bancária.
    - `bank` BankType, required
      - `name` string, required — Nome do banco.
      - `code` string, required — Código de três dígitos do banco.
      - `ispb` string, required — Identificador de Sistema de Pagamentos Brasileiro.
  - `spb_account` SpbAccountType, required
    - `account_check_digit` string, required — Dígito verificador da conta.
    - `account_number` string, required — Número da conta bancária.
    - `routing_check_digit` string, required — Dígito verificador da agência (se aplicável).
    - `routing_number` string, required — Número da agência bancária (sem dígito).
    - `type` 'CHECKING' | 'SAVING', required — Tipo de conta bancária.
    - `bank` BankType, required
      - `name` string, required — Nome do banco.
      - `code` string, required — Código de três dígitos do banco.
      - `ispb` string, required — Identificador de Sistema de Pagamentos Brasileiro.
  - `metadata` MetadataResponse, required
    - `code` string, required — Código.
    - `email` string, required — E-mail.
    - `token` string, required — Token.
    - `statement_descriptor` string, required — Nome a ser exibido na fatura.
  - `created_at` string, date-time, required — Data de criação.
  - `updated_at` string, date-time, nullable, required — Data da última atualização.

---

[API](https://skmtc.net/paytime/apis/api-p-blica.md) · [All operations](https://skmtc.net/paytime/apis/api-p-blica/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paytime/api-p-blica/revisions/5c818991d183/schema)