Gates2b
Planos

Consultar plano

Devolve um plano da conta pelo id, com as opções de Pix Automático já preenchidas.

GET
/plan/{id}

Authorization

apiKey
headerAuthorizationBearer <token>

Chave de API da conta: Authorization: Bearer <chave de API>.

Path Parameters

id*string

Id do plano.

Response Body

O plano.

application/json
  1. response
id?string

Id do plano (ULID).

name?string

Nome do plano.

comment?|

Anotação interna.

amountCents?integer

Valor de cada ciclo em centavos.

currency?string

Moeda. Sempre BRL.

dayDue?|

Dias até a cobrança de cada ciclo vencer (Pix).

type?PlanType

PIX_RECURRING para Pix Automático; RECURRENT para cartão.

Valores aceitos"PIX_RECURRING""RECURRENT"
frequency?PlanFrequency

Periodicidade: semanal, mensal, semestral ou anual.

Valores aceitos"WEEKLY""MONTHLY""SEMIANNUALLY""ANNUALLY"
installmentCount?|

Número de ciclos. null = contínua.

paymentMethods?array<>

Meio de pagamento do plano.

pixRecurringOptions?|

Opções do Pix Automático, já com os padrões aplicados. null em plano de cartão.

passthroughFees?boolean

Se o repasse de tarifa está ligado.

isArchived?boolean

Se o plano está arquivado. Plano arquivado não aceita assinatura nova nem edição.

createdAt?string

Criação, em UTC.

Formatodate-time
updatedAt?string

Última alteração, em UTC.

Formatodate-time
Example Request
curl -X GET 'https://api.gates2b.com/plan/string'
Example Response
{  "id": "01JB7Y2M3N4P5Q6R7S8T9V0W1X",  "name": "Plano Mensal Premium",  "comment": null,  "amountCents": 9990,  "currency": "BRL",  "dayDue": null,  "type": "PIX_RECURRING",  "frequency": "MONTHLY",  "installmentCount": null,  "paymentMethods": [    "PIX"  ],  "pixRecurringOptions": {    "journey": "ONLY_RECURRENCY",    "retryPolicy": "THREE_RETRIES_7_DAYS"  },  "passthroughFees": false,  "isArchived": false,  "createdAt": "2026-05-28T13:00:00.000Z",  "updatedAt": "2026-05-28T13:00:00.000Z"}

Responde 404 se o plano não existe ou é de outra conta. Planos arquivados também são devolvidos, com isArchived: true.