GET /api/v1/sdk/organizations/:orgId/discounts/:id

Retorna os detalhes de um desconto específico de uma sub-organização filha.

Retorna os detalhes de um desconto específico de uma sub-organização filha. A organização autenticada deve ser a organização pai da orgId informada, e o desconto deve pertencer à orgId.

Autenticação

Requer Organization Access Token (OAT) da organização pai via header Authorization: Bearer.

Parâmetros de Path

orgId · string · required

Identificador único da sub-organização filha.

id · string · required

Identificador único do desconto.

Resposta

Retorna o objeto do desconto. Veja os campos em Listar Descontos.

Exemplo

cURL

curl -X GET "https://api.chargefy.io/api/v1/sdk/organizations/org_01j9abc333/discounts/disc_01j9xyz111" \
  -H "Authorization: Bearer $CHARGEFY_ACCESS_TOKEN"

Resposta de Exemplo

{
  "id": "disc_01j9xyz111",
  "organization_id": "org_01j9abc333",
  "name": "Desconto de Lançamento 20%",
  "type": "percentage",
  "code": "LANCAMENTO20",
  "duration": "once",
  "duration_in_months": null,
  "basis_points": 2000,
  "max_redemptions": 100,
  "redemptions_count": 12,
  "starts_at": null,
  "ends_at": "2024-12-31T23:59:59Z",
  "created_at": "2024-10-15T10:00:00Z",
  "modified_at": "2024-10-15T10:00:00Z",
  "deleted_at": null
}

Erros

Status	Descrição
403	Token não pertence à organização pai da orgId
404	Desconto não encontrado ou não pertence à orgId