Orders
Pedidos de uma oferta e seus pagamentos.
- get
/v1/orders— Listar pedidos - post
/v1/orders— Criar pedido - get
/v1/orders/{id}— Consultar pedido - post
/v1/orders/{id}/cancel— Cancelar pedido - post
/v1/orders/{id}/expire— Expirar pedido - post
/v1/orders/{id}/payment-intents— Criar PaymentIntent do pedido
/v1/ordersListar pedidos (listOrders)
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. A página traz produto, método, comprador mascarado (a***@gmail.com, Ana S.), display_status (vocabulário do painel) e counts por status de exibição para os mesmos filtros, sem o status. q busca por id do pedido/pagamento, e-mail completo do comprador ou parte do nome (3+ caracteres); from/to são datas locais (inclusivas) no fuso da organização; status usa o vocabulário de exibição e ainda aceita pending_payment (status canônico do pedido).
- Autenticação: API key (
sk_test_...) ou sessão do app do seller - Escopos:
orders:read - URL:
https://api.v2.wolfpayteste.online/v1/orders
Parâmetros
| Nome | Onde | Tipo | Detalhes |
|---|---|---|---|
q | consulta | string | 1 a 120 caracteres |
status | consulta | string | "pending_payment" | |
min_amount | consulta | string | Padrão |
product_id | consulta | string | Padrão até 128 caracteres |
offer_id | consulta | string | Padrão até 128 caracteres |
method | consulta | string | Valores: |
from | consulta | string | Padrão |
to | consulta | string | Padrão |
limit | consulta | integer | de 1 a 100 Padrão: |
cursor | consulta | string | Padrão até 2048 caracteres |
wolf-organization-id | cabeçalho | string | Só para sessão do app do seller com mais de uma organização (senão Padrão |
Resposta 200
Pedidos.
Um destes formatos:
- SellerOrderPage
- object
Campo Tipo Detalhes dataobrigatórioOrder[]
{
"data": [
{
"id": "ord_0f1e2d3c4b5a69788796a5b4c3d2e1f0",
"offer_id": "off_1b2c3d4e5f60718293a4b5c6d7e8f901",
"product_id": "prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e",
"checkout_session_id": null,
"amount_minor": "9900",
"currency": "BRL",
"status": "paid",
"paid_payment_intent_id": "pi_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e",
"paid_charge_id": "chg_8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c3d",
"created_at": "2026-11-06T12:00:00.000Z",
"updated_at": "2026-11-06T12:00:05.000Z",
"paid_at": "2026-11-06T12:00:05.000Z",
"canceled_at": null,
"expired_at": null,
"items": [
{
"id": "oi_1f2e3d4c5b6a79808f7e6d5c4b3a2918",
"kind": "main",
"offer_id": "off_1b2c3d4e5f60718293a4b5c6d7e8f901",
"product_id": "prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e",
"offer_bump_id": null,
"amount_minor": "9900",
"currency": "BRL",
"position": 0,
"product_name": "Curso de fotografia"
}
],
"product_name": "Curso de fotografia",
"offer_name": null,
"payment_intent_id": "pi_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e",
"payment_method": "pix",
"buyer": {
"name": "Ana C.",
"email": "a***@example.com",
"phone": "+55 11 9****-4321"
},
"display_status": "paid",
"refunded_minor": "0"
}
],
"next_cursor": null,
"counts": {
"all": 1,
"pending": 0,
"processing": 0,
"paid": 1,
"declined": 0,
"refunded": 0,
"partially_refunded": 0,
"canceled": 0,
"expired": 0,
"disputed": 0,
"chargeback": 0,
"failed": 0
}
}Erros
- 400 —
VALIDATION_FAILED - 401 —
AUTHENTICATION_REQUIRED - 403 —
FORBIDDEN - 409 —
TENANT_SELECTION_REQUIRED - 429 —
RATE_LIMITED - 500 —
INTERNAL_ERROR
/v1/ordersCriar pedido (createOrder)
Cria um pedido pending_payment de uma oferta active. bump_ids (opcional, até 3) acrescenta order bumps ativos desta oferta: o servidor valida e precifica cada um, e o amount_minor do pedido é a soma dos items. Bump de outra oferta, inativo, repetido ou desconhecido → 409 BUMP_NOT_AVAILABLE, sem criar nada. Repetir a requisição com a mesma Idempotency-Key e o mesmo corpo devolve o mesmo resultado, sem nova cobrança; corpo diferente → 409 IDEMPOTENCY_CONFLICT.
- Autenticação: API key (
sk_test_...) ou sessão do app do seller - Escopos:
orders:write - URL:
https://api.v2.wolfpayteste.online/v1/orders
Parâmetros
| Nome | Onde | Tipo | Detalhes |
|---|---|---|---|
Idempotency-Keyobrigatório | cabeçalho | string | Chave escolhida pelo cliente (8 a 255 caracteres). Mesma chave + mesmo corpo = mesma resposta; corpo diferente = 8 a 255 caracteres |
wolf-organization-id | cabeçalho | string | Só para sessão do app do seller com mais de uma organização (senão Padrão |
Corpo da requisição
Objeto CreateOrderRequest
| Campo | Tipo | Detalhes |
|---|---|---|
offer_id obrigatório | string | Começa com |
checkout_session_id | string | null | |
bump_ids | string[] | Padrão 0 a 3 itens |
{
"offer_id": "off_1b2c3d4e5f60718293a4b5c6d7e8f901",
"bump_ids": [
"ob_7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a"
]
}Resposta 201
Pedido criado.
Objeto Order
| Campo | Tipo | Detalhes |
|---|---|---|
id obrigatório | string | Começa com |
offer_id obrigatório | string | Começa com |
product_id obrigatório | string | Começa com |
checkout_session_id obrigatório | string | null | |
amount_minor obrigatório | string | |
currency obrigatório | string | Padrão |
status obrigatório | string | Valores: |
paid_payment_intent_id obrigatório | string | null | |
paid_charge_id obrigatório | string | null | |
created_at obrigatório | string | |
updated_at obrigatório | string | |
paid_at obrigatório | string | null | |
canceled_at obrigatório | string | null | |
expired_at obrigatório | string | null | |
items obrigatório | object[] | |
items[].id obrigatório | string | Começa com |
items[].kind obrigatório | string | Valores: |
items[].offer_id obrigatório | string | Começa com |
items[].product_id obrigatório | string | Começa com |
items[].offer_bump_id obrigatório | string | null | |
items[].amount_minor obrigatório | string | |
items[].currency obrigatório | string | Padrão |
items[].position obrigatório | integer | de 0 a 3 |
{
"id": "ord_0f1e2d3c4b5a69788796a5b4c3d2e1f0",
"offer_id": "off_1b2c3d4e5f60718293a4b5c6d7e8f901",
"product_id": "prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e",
"checkout_session_id": null,
"amount_minor": "12600",
"currency": "BRL",
"status": "pending_payment",
"paid_payment_intent_id": null,
"paid_charge_id": null,
"created_at": "2026-11-06T12:00:00.000Z",
"updated_at": "2026-11-06T12:00:00.000Z",
"paid_at": null,
"canceled_at": null,
"expired_at": null,
"items": [
{
"id": "oi_1f2e3d4c5b6a79808f7e6d5c4b3a2918",
"kind": "main",
"offer_id": "off_1b2c3d4e5f60718293a4b5c6d7e8f901",
"product_id": "prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e",
"offer_bump_id": null,
"amount_minor": "9900",
"currency": "BRL",
"position": 0
},
{
"id": "oi_2a3b4c5d6e7f8091a2b3c4d5e6f70819",
"kind": "bump",
"offer_id": "off_5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d",
"product_id": "prd_3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f",
"offer_bump_id": "ob_7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a",
"amount_minor": "2700",
"currency": "BRL",
"position": 1
}
]
}Erros
/v1/orders/{id}Consultar pedido (getOrder)
O pedido com a visão da listagem e o comprador completo em buyer_details (lido do pagamento do pedido).
- Autenticação: API key (
sk_test_...) ou sessão do app do seller - Escopos:
orders:read - URL:
https://api.v2.wolfpayteste.online/v1/orders/{id}
Parâmetros
| Nome | Onde | Tipo | Detalhes |
|---|---|---|---|
idobrigatório | caminho | string | Id do pedido ( mínimo 1 caractere(s) |
wolf-organization-id | cabeçalho | string | Só para sessão do app do seller com mais de uma organização (senão Padrão |
Resposta 200
Pedido.
Objeto SellerOrderDetail
| Campo | Tipo | Detalhes |
|---|---|---|
id obrigatório | string | Começa com |
offer_id obrigatório | string | Começa com |
product_id obrigatório | string | Começa com |
checkout_session_id obrigatório | string | null | |
amount_minor obrigatório | string | |
currency obrigatório | string | Padrão |
status obrigatório | string | Valores: |
paid_payment_intent_id obrigatório | string | null | |
paid_charge_id obrigatório | string | null | |
created_at obrigatório | string | |
updated_at obrigatório | string | |
paid_at obrigatório | string | null | |
canceled_at obrigatório | string | null | |
expired_at obrigatório | string | null | |
items obrigatório | SellerOrderItem[] | |
product_name obrigatório | string | |
offer_name obrigatório | string | null | |
payment_intent_id obrigatório | string | null | |
payment_method obrigatório | string | null | |
buyer obrigatório | object | null | |
buyer.name obrigatório | string | null | |
buyer.email obrigatório | string | null | |
buyer.phone obrigatório | string | null | |
display_status obrigatório | string | Valores: |
refunded_minor obrigatório | string | Padrão |
buyer_details obrigatório | object | null | |
buyer_details.name obrigatório | string | null | |
buyer_details.email obrigatório | string | null | |
buyer_details.phone obrigatório | string | null |
{
"id": "ord_0f1e2d3c4b5a69788796a5b4c3d2e1f0",
"offer_id": "off_1b2c3d4e5f60718293a4b5c6d7e8f901",
"product_id": "prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e",
"checkout_session_id": null,
"amount_minor": "9900",
"currency": "BRL",
"status": "paid",
"paid_payment_intent_id": "pi_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e",
"paid_charge_id": "chg_8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c3d",
"created_at": "2026-11-06T12:00:00.000Z",
"updated_at": "2026-11-06T12:00:05.000Z",
"paid_at": "2026-11-06T12:00:05.000Z",
"canceled_at": null,
"expired_at": null,
"items": [
{
"id": "oi_1f2e3d4c5b6a79808f7e6d5c4b3a2918",
"kind": "main",
"offer_id": "off_1b2c3d4e5f60718293a4b5c6d7e8f901",
"product_id": "prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e",
"offer_bump_id": null,
"amount_minor": "9900",
"currency": "BRL",
"position": 0,
"product_name": "Curso de fotografia"
}
],
"product_name": "Curso de fotografia",
"offer_name": null,
"payment_intent_id": "pi_3b9f0c2d1e4a5b6c7d8e9f0a1b2c3d4e",
"payment_method": "pix",
"buyer": {
"name": "Ana C.",
"email": "a***@example.com",
"phone": "+55 11 9****-4321"
},
"display_status": "paid",
"refunded_minor": "0",
"buyer_details": {
"name": "Ana Compradora",
"email": "ana@example.com",
"phone": "+5511987654321"
}
}Erros
- 401 —
AUTHENTICATION_REQUIRED - 403 —
FORBIDDEN - 404 —
RESOURCE_NOT_FOUND - 409 —
TENANT_SELECTION_REQUIRED - 429 —
RATE_LIMITED - 500 —
INTERNAL_ERROR - 503 —
SERVICE_UNAVAILABLE
/v1/orders/{id}/cancelCancelar pedido (cancelOrder)
- Autenticação: API key (
sk_test_...) ou sessão do app do seller - Escopos:
orders:write - URL:
https://api.v2.wolfpayteste.online/v1/orders/{id}/cancel
Parâmetros
| Nome | Onde | Tipo | Detalhes |
|---|---|---|---|
idobrigatório | caminho | string | Id do pedido ( mínimo 1 caractere(s) |
Idempotency-Keyobrigatório | cabeçalho | string | Chave escolhida pelo cliente (8 a 255 caracteres). Mesma chave + mesmo corpo = mesma resposta; corpo diferente = 8 a 255 caracteres |
wolf-organization-id | cabeçalho | string | Só para sessão do app do seller com mais de uma organização (senão Padrão |
Resposta 200
Pedido cancelado.
Objeto Order
| Campo | Tipo | Detalhes |
|---|---|---|
id obrigatório | string | Começa com |
offer_id obrigatório | string | Começa com |
product_id obrigatório | string | Começa com |
checkout_session_id obrigatório | string | null | |
amount_minor obrigatório | string | |
currency obrigatório | string | Padrão |
status obrigatório | string | Valores: |
paid_payment_intent_id obrigatório | string | null | |
paid_charge_id obrigatório | string | null | |
created_at obrigatório | string | |
updated_at obrigatório | string | |
paid_at obrigatório | string | null | |
canceled_at obrigatório | string | null | |
expired_at obrigatório | string | null | |
items obrigatório | object[] | |
items[].id obrigatório | string | Começa com |
items[].kind obrigatório | string | Valores: |
items[].offer_id obrigatório | string | Começa com |
items[].product_id obrigatório | string | Começa com |
items[].offer_bump_id obrigatório | string | null | |
items[].amount_minor obrigatório | string | |
items[].currency obrigatório | string | Padrão |
items[].position obrigatório | integer | de 0 a 3 |
Erros
/v1/orders/{id}/expireExpirar pedido (expireOrder)
- Autenticação: API key (
sk_test_...) ou sessão do app do seller - Escopos:
orders:write - URL:
https://api.v2.wolfpayteste.online/v1/orders/{id}/expire
Parâmetros
| Nome | Onde | Tipo | Detalhes |
|---|---|---|---|
idobrigatório | caminho | string | Id do pedido ( mínimo 1 caractere(s) |
Idempotency-Keyobrigatório | cabeçalho | string | Chave escolhida pelo cliente (8 a 255 caracteres). Mesma chave + mesmo corpo = mesma resposta; corpo diferente = 8 a 255 caracteres |
wolf-organization-id | cabeçalho | string | Só para sessão do app do seller com mais de uma organização (senão Padrão |
Resposta 200
Pedido expirado.
Objeto Order
| Campo | Tipo | Detalhes |
|---|---|---|
id obrigatório | string | Começa com |
offer_id obrigatório | string | Começa com |
product_id obrigatório | string | Começa com |
checkout_session_id obrigatório | string | null | |
amount_minor obrigatório | string | |
currency obrigatório | string | Padrão |
status obrigatório | string | Valores: |
paid_payment_intent_id obrigatório | string | null | |
paid_charge_id obrigatório | string | null | |
created_at obrigatório | string | |
updated_at obrigatório | string | |
paid_at obrigatório | string | null | |
canceled_at obrigatório | string | null | |
expired_at obrigatório | string | null | |
items obrigatório | object[] | |
items[].id obrigatório | string | Começa com |
items[].kind obrigatório | string | Valores: |
items[].offer_id obrigatório | string | Começa com |
items[].product_id obrigatório | string | Começa com |
items[].offer_bump_id obrigatório | string | null | |
items[].amount_minor obrigatório | string | |
items[].currency obrigatório | string | Padrão |
items[].position obrigatório | integer | de 0 a 3 |
Erros
/v1/orders/{id}/payment-intentsCriar PaymentIntent do pedido (createOrderPaymentIntent)
Cria um PaymentIntent com o valor e a moeda do pedido, ligado a ele (order_id). Um pedido tem no máximo um PaymentIntent vivo.
- Autenticação: API key (
sk_test_...) ou sessão do app do seller - Escopos:
payments:write - URL:
https://api.v2.wolfpayteste.online/v1/orders/{id}/payment-intents
Parâmetros
| Nome | Onde | Tipo | Detalhes |
|---|---|---|---|
idobrigatório | caminho | string | Id do pedido ( mínimo 1 caractere(s) |
Idempotency-Keyobrigatório | cabeçalho | string | Chave escolhida pelo cliente (8 a 255 caracteres). Mesma chave + mesmo corpo = mesma resposta; corpo diferente = 8 a 255 caracteres |
wolf-organization-id | cabeçalho | string | Só para sessão do app do seller com mais de uma organização (senão Padrão |
Resposta 201
PaymentIntent criado para o pedido.
Objeto PaymentIntent
| Campo | Tipo | Detalhes |
|---|---|---|
id obrigatório | string | Começa com |
order_id obrigatório | string | null | |
amount_minor obrigatório | string | |
currency obrigatório | string | Padrão |
status obrigatório | string | Valores: |
provider_id obrigatório | string | |
latest_provider_attempt_id obrigatório | string | null | |
failure_code obrigatório | string | null | |
payment_method_types obrigatório | string[] | Valores: 1 a n itens |
payment_method_type obrigatório | string | null | |
description obrigatório | string | null | |
metadata obrigatório | mapa de string | |
payer obrigatório | PayerView | null | |
next_action obrigatório | PaymentNextAction | null | |
expires_at obrigatório | string | null | |
cancellation_reason obrigatório | string | null |