Offers

Sem parâmetros de consulta a resposta é a lista completa legada ({data}); com qualquer parâmetro ela é paginada por cursor ({data, next_cursor}). Parâmetro desconhecido → 400 VALIDATION_FAILED.

• Autenticação: API key (sk_test_...) ou sessão do app do seller
• Escopos: offers:read
• URL: https://api.v2.wolfpayteste.online/v1/offers

Parâmetros

Resposta 200

Ofertas.

Um destes formatos:

• OfferPage
• object

  Campo	Tipo	Detalhes
  data obrigatório	Offer[]

{
  "data": [
    {
      "id": "off_1b2c3d4e5f60718293a4b5c6d7e8f901",
      "product_id": "prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e",
      "amount_minor": "9900",
      "currency": "BRL",
      "status": "active",
      "created_at": "2026-11-06T12:00:00.000Z",
      "accepted_methods": [
        "pix",
        "card"
      ]
    }
  ],
  "next_cursor": null
}

Erros

• 400 — VALIDATION_FAILED
• 401 — AUTHENTICATION_REQUIRED
• 403 — FORBIDDEN
• 409 — TENANT_SELECTION_REQUIRED
• 429 — RATE_LIMITED
• 500 — INTERNAL_ERROR

Cria uma oferta em draft para um produto do seller; ela aceita Pix e cartão de teste até PATCH /v1/offers/{id} mudar accepted_methods. Repetir a requisição com a mesma Idempotency-Key e o mesmo corpo devolve a mesma resposta com idempotent-replayed: true; corpo diferente → 409 IDEMPOTENCY_CONFLICT.

• Autenticação: API key (sk_test_...) ou sessão do app do seller
• Escopos: offers:read,offers:write
• URL: https://api.v2.wolfpayteste.online/v1/offers

Parâmetros

Corpo da requisição

Objeto CreateOfferRequest

{
  "product_id": "prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e",
  "amount_minor": "9900",
  "currency": "BRL"
}

Resposta 201

Oferta criada.

Objeto Offer

{
  "id": "off_1b2c3d4e5f60718293a4b5c6d7e8f901",
  "product_id": "prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e",
  "amount_minor": "9900",
  "currency": "BRL",
  "status": "draft",
  "created_at": "2026-11-06T12:00:00.000Z",
  "accepted_methods": [
    "pix",
    "card"
  ]
}

Erros

• 400 — IDEMPOTENCY_KEY_REQUIRED,VALIDATION_FAILED
• 401 — AUTHENTICATION_REQUIRED
• 403 — FORBIDDEN
• 404 — RESOURCE_NOT_FOUND
• 409 — IDEMPOTENCY_CONFLICT,IDEMPOTENCY_IN_PROGRESS,TENANT_SELECTION_REQUIRED
• 429 — RATE_LIMITED
• 500 — INTERNAL_ERROR

• Autenticação: API key (sk_test_...) ou sessão do app do seller
• Escopos: offers:read
• URL: https://api.v2.wolfpayteste.online/v1/offers/{id}

Parâmetros

Resposta 200

Oferta.

Objeto Offer

{
  "id": "off_1b2c3d4e5f60718293a4b5c6d7e8f901",
  "product_id": "prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e",
  "amount_minor": "9900",
  "currency": "BRL",
  "status": "active",
  "created_at": "2026-11-06T12:00:00.000Z",
  "accepted_methods": [
    "pix",
    "card"
  ]
}

Erros

• 401 — AUTHENTICATION_REQUIRED
• 403 — FORBIDDEN
• 404 — RESOURCE_NOT_FOUND
• 409 — TENANT_SELECTION_REQUIRED
• 429 — RATE_LIMITED
• 500 — INTERNAL_ERROR

accepted_methods define os métodos que o checkout da oferta oferece: pix, card (cartão de teste) ou ambos (padrão). O checkout mostra só esses métodos e pagar com outro → 409 PAYMENT_METHOD_NOT_ACCEPTED. Repetir a lista atual não muda nada; toda mudança é auditada.

• Autenticação: API key (sk_test_...) ou sessão do app do seller
• Escopos: offers:read,offers:write
• URL: https://api.v2.wolfpayteste.online/v1/offers/{id}

Parâmetros

Corpo da requisição

Objeto UpdateOfferRequest

{
  "accepted_methods": [
    "pix"
  ]
}

Resposta 200

Oferta atualizada.

Objeto Offer

{
  "id": "off_1b2c3d4e5f60718293a4b5c6d7e8f901",
  "product_id": "prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e",
  "amount_minor": "9900",
  "currency": "BRL",
  "status": "active",
  "created_at": "2026-11-06T12:00:00.000Z",
  "accepted_methods": [
    "pix"
  ]
}

Erros

• 400 — VALIDATION_FAILED
• 401 — AUTHENTICATION_REQUIRED
• 403 — FORBIDDEN
• 404 — RESOURCE_NOT_FOUND
• 409 — TENANT_SELECTION_REQUIRED
• 429 — RATE_LIMITED
• 500 — INTERNAL_ERROR

Order bumps da oferta principal, na ordem de position, com o preço atual da oferta de cada bump.

• Autenticação: API key (sk_test_...) ou sessão do app do seller
• Escopos: offers:read
• URL: https://api.v2.wolfpayteste.online/v1/offers/{id}/bumps

Parâmetros

Resposta 200

Order bumps.

Objeto OfferBumpList

{
  "data": [
    {
      "id": "ob_7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a",
      "offer_id": "off_1b2c3d4e5f60718293a4b5c6d7e8f901",
      "bump_offer_id": "off_5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d",
      "headline": "Adicionar à compra: Guia bônus",
      "description": "Checklist em PDF com 40 poses para ensaios.",
      "position": 0,
      "status": "active",
      "bump_offer": {
        "product_id": "prd_3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f",
        "amount_minor": "2700",
        "currency": "BRL",
        "status": "active"
      },
      "created_at": "2026-11-06T12:00:00.000Z",
      "updated_at": "2026-11-06T12:00:00.000Z"
    }
  ]
}

Erros

• 401 — AUTHENTICATION_REQUIRED
• 403 — FORBIDDEN
• 404 — RESOURCE_NOT_FOUND
• 409 — TENANT_SELECTION_REQUIRED
• 429 — RATE_LIMITED
• 500 — INTERNAL_ERROR

Oferece outra oferta do seller (bump_offer_id) como adicional no checkout desta oferta. Regras: mesma moeda; um bump active (padrão) exige a oferta do bump active; no máximo 3 bumps ativos por oferta e sem bump dentro de bump (409 INVALID_STATE_TRANSITION); a mesma oferta não entra duas vezes como bump (400). Auditado (offer_bump.created). Repetir a requisição com a mesma Idempotency-Key e o mesmo corpo devolve a mesma resposta com idempotent-replayed: true; corpo diferente → 409 IDEMPOTENCY_CONFLICT.

• Autenticação: API key (sk_test_...) ou sessão do app do seller
• Escopos: offers:read,offers:write
• URL: https://api.v2.wolfpayteste.online/v1/offers/{id}/bumps

Parâmetros

Corpo da requisição

Objeto CreateOfferBumpRequest

{
  "bump_offer_id": "off_5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d",
  "headline": "Adicionar à compra: Guia bônus",
  "description": "Checklist em PDF com 40 poses para ensaios.",
  "position": 0
}

Resposta 201

Order bump criado.

Objeto OfferBump

{
  "id": "ob_7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a",
  "offer_id": "off_1b2c3d4e5f60718293a4b5c6d7e8f901",
  "bump_offer_id": "off_5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d",
  "headline": "Adicionar à compra: Guia bônus",
  "description": "Checklist em PDF com 40 poses para ensaios.",
  "position": 0,
  "status": "active",
  "bump_offer": {
    "product_id": "prd_3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f",
    "amount_minor": "2700",
    "currency": "BRL",
    "status": "active"
  },
  "created_at": "2026-11-06T12:00:00.000Z",
  "updated_at": "2026-11-06T12:00:00.000Z"
}

Erros

• 400 — IDEMPOTENCY_KEY_REQUIRED,VALIDATION_FAILED
• 401 — AUTHENTICATION_REQUIRED
• 403 — FORBIDDEN
• 404 — RESOURCE_NOT_FOUND
• 409 — IDEMPOTENCY_CONFLICT,IDEMPOTENCY_IN_PROGRESS,INVALID_STATE_TRANSITION,TENANT_SELECTION_REQUIRED
• 429 — RATE_LIMITED
• 500 — INTERNAL_ERROR

Muda headline, description, position e/ou status (active ↔ inactive; bumps nunca são apagados). Ativar respeita as mesmas regras da criação. Repetir os valores atuais não muda nada. Auditado (offer_bump.updated).

• Autenticação: API key (sk_test_...) ou sessão do app do seller
• Escopos: offers:read,offers:write
• URL: https://api.v2.wolfpayteste.online/v1/offers/{id}/bumps/{bumpId}

Parâmetros

Corpo da requisição

Objeto UpdateOfferBumpRequest

{
  "status": "inactive"
}

Resposta 200

Order bump atualizado.

Objeto OfferBump

{
  "id": "ob_7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a",
  "offer_id": "off_1b2c3d4e5f60718293a4b5c6d7e8f901",
  "bump_offer_id": "off_5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d",
  "headline": "Adicionar à compra: Guia bônus",
  "description": "Checklist em PDF com 40 poses para ensaios.",
  "position": 0,
  "status": "inactive",
  "bump_offer": {
    "product_id": "prd_3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f",
    "amount_minor": "2700",
    "currency": "BRL",
    "status": "active"
  },
  "created_at": "2026-11-06T12:00:00.000Z",
  "updated_at": "2026-11-06T12:00:00.000Z"
}

Erros

• 400 — VALIDATION_FAILED
• 401 — AUTHENTICATION_REQUIRED
• 403 — FORBIDDEN
• 404 — RESOURCE_NOT_FOUND
• 409 — INVALID_STATE_TRANSITION,TENANT_SELECTION_REQUIRED
• 429 — RATE_LIMITED
• 500 — INTERNAL_ERROR

Ativar uma oferta exige o produto active (409 PRODUCT_NOT_ACTIVE).

• Autenticação: API key (sk_test_...) ou sessão do app do seller
• Escopos: offers:read,offers:write
• URL: https://api.v2.wolfpayteste.online/v1/offers/{id}/status

Parâmetros

Corpo da requisição

Objeto CatalogStatusRequest

{
  "status": "active"
}

Resposta 200

Oferta atualizada.

Objeto Offer

{
  "id": "off_1b2c3d4e5f60718293a4b5c6d7e8f901",
  "product_id": "prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e",
  "amount_minor": "9900",
  "currency": "BRL",
  "status": "active",
  "created_at": "2026-11-06T12:00:00.000Z",
  "accepted_methods": [
    "pix",
    "card"
  ]
}

Erros

• 400 — VALIDATION_FAILED
• 401 — AUTHENTICATION_REQUIRED
• 403 — FORBIDDEN
• 404 — RESOURCE_NOT_FOUND
• 409 — INVALID_STATE_TRANSITION,PRODUCT_NOT_ACTIVE,TENANT_SELECTION_REQUIRED
• 429 — RATE_LIMITED
• 500 — INTERNAL_ERROR