Referência REST

OpenAPI reference

Esta página é derivada do OpenAPI commitado; nomes de wire permanecem inalterados. Try It no portal usa somente sandbox, token curto Trepzy e CORS exato. Exemplos live são apenas cópia.

`GET /api/v1/buyers`

operation_id: listBuyers

Permissão: buyers:read_list
Idempotência: none
CAS: none
Cursor: cursor
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "cursor": "example"
}

Exemplo de resposta

{
  "data": {
    "items": []
  }
}

`GET /api/v1/buyers/{buyer_ref}`

operation_id: retrieveBuyer

Permissão: buyers:read_retrieve
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "buyer_ref": "example"
}

Exemplo de resposta

{
  "data": {
    "buyer_ref": "buyer_0123456789AB",
    "country": "example",
    "created_at": "2026-08-15T12:00:00Z",
    "display_name": "example",
    "email_masked": "example",
    "entitlements": [],
    "last_seen_at": "2026-08-15T12:00:00Z",
    "locale": "example",
    "purchases": [],
    "status": "active",
    "subscriptions": [],
    "timezone": "example",
    "updated_at": "2026-08-15T12:00:00Z"
  }
}

`GET /api/v1/captures`

operation_id: listCaptures

Permissão: captures:read_list
Idempotência: none
CAS: none
Cursor: cursor
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "cursor": "example"
}

Exemplo de resposta

{
  "data": {
    "items": []
  }
}

`GET /api/v1/captures/{capture_ref}`

operation_id: retrieveCapture

Permissão: captures:read_retrieve
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "capture_ref": "example"
}

Exemplo de resposta

{
  "data": {
    "amount_minor": "19700",
    "capture_ref": "cap_0123456789AB",
    "captured_at": "2026-08-15T12:00:00Z",
    "created_at": "2026-08-15T12:00:00Z",
    "currency": "BRL",
    "invoice_ref": "in_0123456789AB",
    "journey_ref": "jny_0123456789AB",
    "order_ref": "order_0123456789AB",
    "payment_method": {
      "brand": "example",
      "funding": "credit",
      "last4": "example"
    },
    "payment_ref": "pay_0123456789AB",
    "subscription_ref": "sub_0123456789AB"
  }
}

`POST /api/v1/checkout-configs`

operation_id: createCheckoutConfig

Permissão: checkout_configs:write_create
Idempotência: required
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_key_required, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{
  "slug": "example"
}

Exemplo de resposta

{
  "data": {
    "config_ref": "ckt_0123456789AB",
    "created_at": "2026-08-15T12:00:00Z",
    "published_version": 1,
    "slug": "example",
    "status": "draft",
    "updated_at": "2026-08-15T12:00:00Z"
  }
}

`GET /api/v1/checkout-configs/{config_ref}`

operation_id: retrieveCheckoutConfig

Permissão: checkout_configs:read_retrieve
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "config_ref": "example"
}

Exemplo de resposta

{
  "data": {
    "config_ref": "ckt_0123456789AB",
    "created_at": "2026-08-15T12:00:00Z",
    "published_version": 1,
    "slug": "example",
    "status": "draft",
    "updated_at": "2026-08-15T12:00:00Z"
  }
}

`POST /api/v1/checkout-configs/{config_ref}/publish`

operation_id: publishCheckoutConfig

Permissão: checkout_configs:write_publish
Idempotência: required
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_key_required, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{}

Exemplo de resposta

{
  "data": {
    "config_ref": "ckt_0123456789AB",
    "created_at": "2026-08-15T12:00:00Z",
    "published_version": 1,
    "slug": "example",
    "status": "draft",
    "updated_at": "2026-08-15T12:00:00Z"
  }
}

`POST /api/v1/checkout-configs/{config_ref}/versions`

operation_id: createCheckoutConfigVersion

Permissão: checkout_configs:write_create_version
Idempotência: required
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_key_required, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{
  "copy": {
    "cta_label": "example",
    "offer_title": "example"
  },
  "currency": "BRL",
  "locale": "example",
  "price_ref": "price_0123456789AB"
}

Exemplo de resposta

{
  "data": {
    "config_ref": "ckt_0123456789AB",
    "created_at": "2026-08-15T12:00:00Z",
    "published_version": 1,
    "slug": "example",
    "status": "draft",
    "updated_at": "2026-08-15T12:00:00Z"
  }
}

`GET /api/v1/checkout-sessions`

operation_id: listCheckoutSessions

Permissão: checkout_sessions:read_list
Idempotência: none
CAS: none
Cursor: cursor
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "cursor": "example"
}

Exemplo de resposta

{
  "data": {
    "items": []
  }
}

`POST /api/v1/checkout-sessions`

operation_id: createCheckoutSession

Permissão: checkout_sessions:write_create
Idempotência: required
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_key_required, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{}

Exemplo de resposta

{
  "data": {
    "buyer_ref": "buyer_0123456789AB",
    "checkout_session_ref": "cks_0123456789AB",
    "config_ref": "ckt_0123456789AB",
    "config_version": 1,
    "conversion_mode": "catalog",
    "created_at": "2026-08-15T12:00:00Z",
    "currency": "BRL",
    "currency_source": "buyer_choice",
    "expires_at": "2026-08-15T12:00:00Z",
    "invoice_ref": "in_0123456789AB",
    "items": [],
    "journey_ref": "jny_0123456789AB",
    "locale": "example",
    "order_ref": "order_0123456789AB",
    "payment_ref": "pay_0123456789AB",
    "revision": 1,
    "status": "open",
    "total_amount_minor": "19700",
    "tracking": {
      "node_key": "example",
      "surface": "hosted"
    },
    "updated_at": "2026-08-15T12:00:00Z"
  }
}

`GET /api/v1/checkout-sessions/{checkout_session_ref}`

operation_id: retrieveCheckoutSession

Permissão: checkout_sessions:read_retrieve
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "checkout_session_ref": "example"
}

Exemplo de resposta

{
  "data": {
    "buyer_ref": "buyer_0123456789AB",
    "checkout_session_ref": "cks_0123456789AB",
    "config_ref": "ckt_0123456789AB",
    "config_version": 1,
    "conversion_mode": "catalog",
    "created_at": "2026-08-15T12:00:00Z",
    "currency": "BRL",
    "currency_source": "buyer_choice",
    "expires_at": "2026-08-15T12:00:00Z",
    "invoice_ref": "in_0123456789AB",
    "items": [],
    "journey_ref": "jny_0123456789AB",
    "locale": "example",
    "order_ref": "order_0123456789AB",
    "payment_ref": "pay_0123456789AB",
    "revision": 1,
    "status": "open",
    "total_amount_minor": "19700",
    "tracking": {
      "node_key": "example",
      "surface": "hosted"
    },
    "updated_at": "2026-08-15T12:00:00Z"
  }
}

`POST /api/v1/checkout-sessions/{checkout_session_ref}/pay`

operation_id: payCheckoutSession

Permissão: checkout_sessions:write_pay
Idempotência: required
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_key_required, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{
  "credential": {
    "intent_ref": "example",
    "kind": "vault_intent"
  },
  "initiation": "customer"
}

Exemplos de resposta

`retrieve_payment_response`

{
  "data": {
    "amount_minor": "19700",
    "attempts": [],
    "buyer_ref": "buyer_0123456789AB",
    "captured_amount_minor": "19700",
    "captures": [],
    "checkout_session_ref": "cks_0123456789AB",
    "created_at": "2026-08-15T12:00:00Z",
    "currency": "BRL",
    "invoice_ref": "in_0123456789AB",
    "items": [
      {
        "currency": "BRL",
        "line_amount_minor": "19700",
        "offer_ref": "offer_0123456789AB",
        "position": 0,
        "price_ref": "price_0123456789AB",
        "product_ref": "prod_0123456789AB",
        "quantity": 1,
        "unit_amount_minor": "19700"
      }
    ],
    "journey_ref": "jny_0123456789AB",
    "payment_ref": "pay_0123456789AB",
    "status": "open",
    "updated_at": "2026-08-15T12:00:00Z"
  }
}

`subscription_setup_action_required`

{
  "data": {
    "checkout_session_ref": "cks_0123456789AB",
    "outcome": "subscription_setup_action_required"
  }
}

`subscription_started`

{
  "data": {
    "checkout_session_ref": "cks_0123456789AB",
    "order_ref": "order_0123456789AB",
    "outcome": "subscription_started",
    "subscription_ref": "sub_0123456789AB",
    "trial": false
  }
}

`POST /api/v1/credentials/{credential_ref}/revoke`

operation_id: revokeServiceAccountCredential

Permissão: credentials:manage_revoke
Idempotência: required
CAS: if_match_required
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{
  "reason_code": "example"
}

Exemplo de resposta

{
  "data": {
    "credential_ref": "credential_0123456789AB",
    "expires_at": "2026-08-15T12:00:00Z",
    "predecessor_credential_ref": "credential_0123456789AB",
    "secret_status": "issued",
    "service_account_ref": "principal_0123456789AB",
    "status": "active",
    "successor_credential_ref": "credential_0123456789AB",
    "version": 1
  }
}

`POST /api/v1/credentials/{credential_ref}/rotate`

operation_id: rotateServiceAccountCredential

Permissão: credentials:manage_rotate
Idempotência: required
CAS: if_match_required
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{
  "reason_code": "example",
  "service_account_ref": "principal_0123456789AB"
}

Exemplo de resposta

{
  "data": {
    "credential_ref": "credential_0123456789AB",
    "expires_at": "2026-08-15T12:00:00Z",
    "predecessor_credential_ref": "credential_0123456789AB",
    "secret_status": "issued",
    "service_account_ref": "principal_0123456789AB",
    "status": "active",
    "successor_credential_ref": "credential_0123456789AB",
    "version": 1
  }
}

`GET /api/v1/disputes`

operation_id: listDisputes

Permissão: disputes:read_list
Idempotência: none
CAS: none
Cursor: cursor
Quota: "none"
Erros: authentication_failed, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "cursor": "example"
}

Exemplo de resposta

{
  "data": {
    "items": []
  }
}

`GET /api/v1/disputes/{dispute_ref}`

operation_id: retrieveDispute

Permissão: disputes:read
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "dispute_ref": "dsp_0123456789AB"
}

Exemplo de resposta

{
  "data": {
    "amount": {
      "currency": "BRL",
      "unit": "minor",
      "value": "19700"
    },
    "dispute_ref": "dsp_0123456789AB",
    "evidence_due_at": "2026-08-15T12:00:00Z",
    "kind": "alert",
    "opened_at": "2026-08-15T12:00:00Z",
    "payment_intent_ref": "pay_0123456789AB",
    "reason_safe": "example",
    "resolved_at": "2026-08-15T12:00:00Z",
    "status": "received"
  }
}

`GET /api/v1/entitlements`

operation_id: listEntitlements

Permissão: entitlements:read_list
Idempotência: none
CAS: none
Cursor: cursor
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "cursor": "example"
}

Exemplo de resposta

{
  "data": {
    "items": []
  }
}

`GET /api/v1/entitlements/{entitlement_ref}`

operation_id: retrieveEntitlement

Permissão: entitlements:read_retrieve
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "entitlement_ref": "example"
}

Exemplo de resposta

{
  "data": {
    "buyer_ref": "buyer_0123456789AB",
    "created_at": "2026-08-15T12:00:00Z",
    "effective_from": "2026-08-15T12:00:00Z",
    "effective_to": "2026-08-15T12:00:00Z",
    "entitlement_ref": "etm_0123456789AB",
    "product_ref": "prod_0123456789AB",
    "status": "active",
    "updated_at": "2026-08-15T12:00:00Z"
  }
}

`GET /api/v1/environments`

operation_id: listEnvironments

Permissão: environments:read_list
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{}

Exemplo de resposta

{
  "data": {
    "items": []
  }
}

`GET /api/v1/invoices`

operation_id: listInvoices

Permissão: invoices:read_list
Idempotência: none
CAS: none
Cursor: cursor
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "cursor": "example"
}

Exemplo de resposta

{
  "data": {
    "items": []
  }
}

`GET /api/v1/invoices/{invoice_ref}`

operation_id: retrieveInvoice

Permissão: invoices:read_retrieve
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "invoice_ref": "example"
}

Exemplo de resposta

{
  "data": {
    "adjustment_minor": "19700",
    "beneficiary_buyer_ref": "buyer_0123456789AB",
    "billing_reason": "acquisition",
    "capture_ref": "cap_0123456789AB",
    "checkout_presentation": "hosted",
    "checkout_session_ref": "cks_0123456789AB",
    "created_at": "2026-08-15T12:00:00Z",
    "currency": "BRL",
    "due_at": "2026-08-15T12:00:00Z",
    "finalized_at": "2026-08-15T12:00:00Z",
    "invoice_ref": "in_0123456789AB",
    "journey_ref": "jny_0123456789AB",
    "lines": [],
    "order_ref": "order_0123456789AB",
    "origin": "checkout",
    "paid_at": "2026-08-15T12:00:00Z",
    "past_due_at": "2026-08-15T12:00:00Z",
    "purchaser_buyer_ref": "buyer_0123456789AB",
    "status": "draft",
    "subtotal_minor": "19700",
    "tax_minor": "19700",
    "total_minor": "19700",
    "updated_at": "2026-08-15T12:00:00Z",
    "version": 1,
    "void_at": "2026-08-15T12:00:00Z"
  }
}

`GET /api/v1/journeys`

operation_id: listJourneys

Permissão: journeys:read_list
Idempotência: none
CAS: none
Cursor: cursor
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "cursor": "example"
}

Exemplo de resposta

{
  "data": {
    "items": []
  }
}

`GET /api/v1/journeys/{journey_ref}`

operation_id: retrieveJourney

Permissão: journeys:read_retrieve
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "journey_ref": "example"
}

Exemplo de resposta

{
  "data": {
    "checkout_session_ref": "cks_0123456789AB",
    "completed_at": "2026-08-15T12:00:00Z",
    "created_at": "2026-08-15T12:00:00Z",
    "decisions": [],
    "funnel_slug": "example",
    "funnel_version": 1,
    "journey_ref": "jny_0123456789AB",
    "root_order_ref": "order_0123456789AB",
    "status": "open",
    "surface": "hosted"
  }
}

`GET /api/v1/offers`

operation_id: listOffers

Permissão: offers:read_list
Idempotência: none
CAS: none
Cursor: cursor
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "cursor": "example"
}

Exemplo de resposta

{
  "data": {
    "items": []
  }
}

`GET /api/v1/offers/{offer_ref}`

operation_id: retrieveOffer

Permissão: offers:read_retrieve
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "offer_ref": "example"
}

Exemplo de resposta

{
  "data": {
    "created_at": "2026-08-15T12:00:00Z",
    "offer_ref": "offer_0123456789AB",
    "price_ref": "price_0123456789AB",
    "product_ref": "prod_0123456789AB",
    "status": "draft",
    "updated_at": "2026-08-15T12:00:00Z"
  }
}

`POST /api/v1/offers/{offer_ref}/reprice`

operation_id: repriceOffer

Permissão: products:reprice
Idempotência: required
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_key_required, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{
  "amount_minor": "19700"
}

Exemplo de resposta

{
  "data": {
    "amount_minor": "19700",
    "created_at": "2026-08-15T12:00:00Z",
    "currency": "BRL",
    "price_ref": "price_0123456789AB",
    "product_ref": "prod_0123456789AB",
    "recurrence_interval": "day",
    "recurrence_interval_count": 1,
    "status": "draft",
    "trial_days": 1,
    "updated_at": "2026-08-15T12:00:00Z"
  }
}

`GET /api/v1/orders`

operation_id: listOrders

Permissão: orders:read_list
Idempotência: none
CAS: none
Cursor: cursor
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "cursor": "example"
}

Exemplo de resposta

{
  "data": {
    "items": []
  }
}

`GET /api/v1/orders/{order_ref}`

operation_id: retrieveOrder

Permissão: orders:read_retrieve
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "order_ref": "example"
}

Exemplo de resposta

{
  "data": {
    "adjustment_minor": "19700",
    "beneficiary_buyer_ref": "buyer_0123456789AB",
    "capture_ref": "cap_0123456789AB",
    "checkout_session_ref": "cks_0123456789AB",
    "created_at": "2026-08-15T12:00:00Z",
    "currency": "BRL",
    "invoice_ref": "in_0123456789AB",
    "journey_ref": "jny_0123456789AB",
    "lines": [],
    "order_ref": "order_0123456789AB",
    "purchaser_buyer_ref": "buyer_0123456789AB",
    "root_order_ref": "order_0123456789AB",
    "source_kind": "hosted",
    "subtotal_minor": "19700",
    "tax_minor": "19700",
    "total_minor": "19700"
  }
}

`GET /api/v1/participations`

operation_id: listParticipations

Permissão: participations:read_list
Idempotência: none
CAS: none
Cursor: cursor
Quota: "none"
Erros: authentication_failed, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "cursor": "example"
}

Exemplo de resposta

{
  "data": {
    "items": []
  }
}

`GET /api/v1/participations/{participation_ref}`

operation_id: retrieveParticipation

Permissão: participations:read
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "participation_ref": "ptc_0123456789AB"
}

Exemplo de resposta

{
  "data": {
    "accepted_at": "2026-08-15T12:00:00Z",
    "beneficiary_business_ref": "biz_0123456789AB",
    "invited_at": "2026-08-15T12:00:00Z",
    "participation_ref": "ptc_0123456789AB",
    "status": "invited",
    "terms_digest": "example",
    "terms_version": 1
  }
}

`GET /api/v1/payment_methods`

operation_id: listStoredPaymentMethods

Permissão: payment_methods:read_list
Idempotência: none
CAS: none
Cursor: cursor
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "cursor": "example"
}

Exemplo de resposta

{
  "data": {
    "items": []
  }
}

`GET /api/v1/payment_methods/{stored_payment_method_ref}`

operation_id: retrieveStoredPaymentMethod

Permissão: payment_methods:read_retrieve
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "stored_payment_method_ref": "example"
}

Exemplo de resposta

{
  "data": {
    "brand": "example",
    "consents": [],
    "created_at": "2026-08-15T12:00:00Z",
    "funding": "example",
    "last4": "example",
    "replaced_by_stored_payment_method_ref": "spm_0123456789AB",
    "revoked_at": "2026-08-15T12:00:00Z",
    "source_checkout_session_ref": "cks_0123456789AB",
    "status": "active",
    "stored_payment_method_ref": "spm_0123456789AB",
    "updated_at": "2026-08-15T12:00:00Z"
  }
}

`GET /api/v1/payments`

operation_id: listPayments

Permissão: payments:read_list
Idempotência: none
CAS: none
Cursor: cursor
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "cursor": "example"
}

Exemplo de resposta

{
  "data": {
    "items": []
  }
}

`GET /api/v1/payments/{payment_ref}`

operation_id: retrievePayment

Permissão: payments:read_retrieve
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "payment_ref": "example"
}

Exemplo de resposta

{
  "data": {
    "amount_minor": "19700",
    "attempts": [],
    "buyer_ref": "buyer_0123456789AB",
    "captured_amount_minor": "19700",
    "captures": [],
    "checkout_session_ref": "cks_0123456789AB",
    "created_at": "2026-08-15T12:00:00Z",
    "currency": "BRL",
    "invoice_ref": "in_0123456789AB",
    "items": [
      {
        "currency": "BRL",
        "line_amount_minor": "19700",
        "offer_ref": "offer_0123456789AB",
        "position": 0,
        "price_ref": "price_0123456789AB",
        "product_ref": "prod_0123456789AB",
        "quantity": 1,
        "unit_amount_minor": "19700"
      }
    ],
    "journey_ref": "jny_0123456789AB",
    "payment_ref": "pay_0123456789AB",
    "status": "open",
    "updated_at": "2026-08-15T12:00:00Z"
  }
}

`GET /api/v1/payouts`

operation_id: listPayouts

Permissão: payouts:read_list
Idempotência: none
CAS: none
Cursor: cursor
Quota: "none"
Erros: authentication_failed, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "cursor": "example"
}

Exemplo de resposta

{
  "data": {
    "items": []
  }
}

`GET /api/v1/payouts/{payout_ref}`

operation_id: retrievePayout

Permissão: payouts:read
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "payout_ref": "wd_0123456789AB"
}

Exemplo de resposta

{
  "data": {
    "amount": {
      "currency": "BRL",
      "unit": "minor",
      "value": "19700"
    },
    "completed_at": "2026-08-15T12:00:00Z",
    "destination_label": "example",
    "destination_last4": "example",
    "fee": {
      "currency": "BRL",
      "unit": "minor",
      "value": "19700"
    },
    "method_key": "example",
    "net": {
      "currency": "BRL",
      "unit": "minor",
      "value": "19700"
    },
    "payout_ref": "wd_0123456789AB",
    "requested_at": "2026-08-15T12:00:00Z",
    "status": "requested"
  }
}

`GET /api/v1/prices`

operation_id: listPrices

Permissão: prices:read_list
Idempotência: none
CAS: none
Cursor: cursor
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "cursor": "example"
}

Exemplo de resposta

{
  "data": {
    "items": []
  }
}

`POST /api/v1/prices`

operation_id: createPrice

Permissão: prices:write_create
Idempotência: required
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_key_required, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{
  "amount_minor": "19700",
  "currency": "BRL",
  "free_mode": "none",
  "product_ref": "prod_0123456789AB"
}

Exemplo de resposta

{
  "data": {
    "amount_minor": "19700",
    "created_at": "2026-08-15T12:00:00Z",
    "currency": "BRL",
    "price_ref": "price_0123456789AB",
    "product_ref": "prod_0123456789AB",
    "recurrence_interval": "day",
    "recurrence_interval_count": 1,
    "status": "draft",
    "trial_days": 1,
    "updated_at": "2026-08-15T12:00:00Z"
  }
}

`GET /api/v1/prices/{price_ref}`

operation_id: retrievePrice

Permissão: prices:read_retrieve
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "price_ref": "example"
}

Exemplo de resposta

{
  "data": {
    "amount_minor": "19700",
    "created_at": "2026-08-15T12:00:00Z",
    "currency": "BRL",
    "price_ref": "price_0123456789AB",
    "product_ref": "prod_0123456789AB",
    "recurrence_interval": "day",
    "recurrence_interval_count": 1,
    "status": "draft",
    "trial_days": 1,
    "updated_at": "2026-08-15T12:00:00Z"
  }
}

`POST /api/v1/prices/{price_ref}/publish`

operation_id: publishPrice

Permissão: prices:write_publish
Idempotência: required
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_key_required, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{}

Exemplo de resposta

{
  "data": {
    "amount_minor": "19700",
    "created_at": "2026-08-15T12:00:00Z",
    "currency": "BRL",
    "price_ref": "price_0123456789AB",
    "product_ref": "prod_0123456789AB",
    "recurrence_interval": "day",
    "recurrence_interval_count": 1,
    "status": "draft",
    "trial_days": 1,
    "updated_at": "2026-08-15T12:00:00Z"
  }
}

`GET /api/v1/products`

operation_id: listProducts

Permissão: products:read_list
Idempotência: none
CAS: none
Cursor: cursor
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "cursor": "example"
}

Exemplo de resposta

{
  "data": {
    "items": []
  }
}

`POST /api/v1/products`

operation_id: createProduct

Permissão: products:write_create
Idempotência: required
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_key_required, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{
  "format": "digital",
  "name": "example",
  "slug": "example",
  "type": "produto"
}

Exemplo de resposta

{
  "data": {
    "created_at": "2026-08-15T12:00:00Z",
    "name": "example",
    "product_ref": "prod_0123456789AB",
    "status": "draft",
    "updated_at": "2026-08-15T12:00:00Z"
  }
}

`GET /api/v1/products/{product_ref}`

operation_id: retrieveProduct

Permissão: products:read_retrieve
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "product_ref": "example"
}

Exemplo de resposta

{
  "data": {
    "created_at": "2026-08-15T12:00:00Z",
    "name": "example",
    "product_ref": "prod_0123456789AB",
    "status": "draft",
    "updated_at": "2026-08-15T12:00:00Z"
  }
}

`POST /api/v1/products/{product_ref}/publish`

operation_id: publishProduct

Permissão: products:write_publish
Idempotência: required
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_key_required, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{}

Exemplo de resposta

{
  "data": {
    "created_at": "2026-08-15T12:00:00Z",
    "name": "example",
    "product_ref": "prod_0123456789AB",
    "status": "draft",
    "updated_at": "2026-08-15T12:00:00Z"
  }
}

`POST /api/v1/promotions/apply`

operation_id: applyPromotion

Permissão: promotion:manage_apply
Idempotência: required
CAS: if_match_required
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_key_required, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{
  "confirmed": true,
  "plan_digest": "abababababababababababababababababababababababababababababababab"
}

Exemplo de resposta

{
  "data": {
    "ok": false,
    "operations": [],
    "outcome_class": "example",
    "plan_digest": "abababababababababababababababababababababababababababababababab"
  }
}

`POST /api/v1/promotions/plan`

operation_id: planPromotion

Permissão: promotion:read_plan
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, semantic_error, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "destination": "live",
  "resources": [],
  "schema_version": 1,
  "source": "sandbox"
}

Exemplo de resposta

{
  "data": {
    "destination_environment": "live",
    "mapping": [],
    "operations": [],
    "plan_digest": "abababababababababababababababababababababababababababababababab",
    "schema_version": "1",
    "source_environment": "sandbox"
  }
}

`GET /api/v1/refunds`

operation_id: listRefunds

Permissão: refunds:read_list
Idempotência: none
CAS: none
Cursor: cursor
Quota: "none"
Erros: authentication_failed, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "cursor": "example"
}

Exemplo de resposta

{
  "data": {
    "items": []
  }
}

`POST /api/v1/refunds`

operation_id: createRefund

Permissão: refunds:write_create
Idempotência: required
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_key_required, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{
  "amount_minor": "19700",
  "currency": "BRL"
}

Exemplo de resposta

{
  "data": {
    "access_effect": "revoke",
    "amount": {
      "currency": "BRL",
      "unit": "minor",
      "value": "19700"
    },
    "cancelable": false,
    "canceled_at": "2026-08-15T12:00:00Z",
    "capture_ref": "cap_0123456789AB",
    "executed_at": "2026-08-15T12:00:00Z",
    "payment_intent_ref": "pay_0123456789AB",
    "reason": "example",
    "refund_ref": "ref_0123456789AB",
    "requested_at": "2026-08-15T12:00:00Z",
    "scheduled_at": "2026-08-15T12:00:00Z",
    "scope": "total",
    "status": "requested"
  }
}

`GET /api/v1/refunds/{refund_ref}`

operation_id: retrieveRefund

Permissão: refunds:read
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "refund_ref": "ref_0123456789AB"
}

Exemplo de resposta

{
  "data": {
    "access_effect": "revoke",
    "amount": {
      "currency": "BRL",
      "unit": "minor",
      "value": "19700"
    },
    "cancelable": false,
    "canceled_at": "2026-08-15T12:00:00Z",
    "capture_ref": "cap_0123456789AB",
    "executed_at": "2026-08-15T12:00:00Z",
    "payment_intent_ref": "pay_0123456789AB",
    "reason": "example",
    "refund_ref": "ref_0123456789AB",
    "requested_at": "2026-08-15T12:00:00Z",
    "scheduled_at": "2026-08-15T12:00:00Z",
    "scope": "total",
    "status": "requested"
  }
}

`GET /api/v1/request_logs`

operation_id: listPublicRequestLogs

Permissão: request_logs:read_list
Idempotência: none
CAS: none
Cursor: cursor
Quota: "none"
Erros: authentication_failed, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "cursor": "example"
}

Exemplo de resposta

{
  "data": {
    "items": []
  }
}

`GET /api/v1/service_accounts`

operation_id: listServiceAccounts

Permissão: service_accounts:read_list
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{}

Exemplo de resposta

{
  "data": {
    "items": []
  }
}

`POST /api/v1/service_accounts`

operation_id: createServiceAccount

Permissão: service_accounts:manage_create
Idempotência: required
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{
  "display_name": "example"
}

Exemplo de resposta

{
  "data": {
    "display_name": "example",
    "principal_ref": "principal_0123456789AB",
    "status": "active",
    "version": 1
  }
}

`GET /api/v1/service_accounts/{principal_ref}`

operation_id: retrieveServiceAccount

Permissão: service_accounts:read_retrieve
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "principal_ref": "principal_0123456789AB"
}

Exemplo de resposta

{
  "data": {
    "display_name": "example",
    "principal_ref": "principal_0123456789AB",
    "status": "active",
    "version": 1
  }
}

`GET /api/v1/service_accounts/{principal_ref}/credentials`

operation_id: listServiceAccountCredentials

Permissão: credentials:read_list
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "principal_ref": "principal_0123456789AB"
}

Exemplo de resposta

{
  "data": {
    "items": []
  }
}

`POST /api/v1/service_accounts/{principal_ref}/credentials`

operation_id: issueServiceAccountCredential

Permissão: credentials:manage_issue
Idempotência: required
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{
  "restriction_allowlist": [
    "example"
  ]
}

Exemplo de resposta

{
  "data": {
    "credential_ref": "credential_0123456789AB",
    "expires_at": "2026-08-15T12:00:00Z",
    "predecessor_credential_ref": "credential_0123456789AB",
    "secret_status": "issued",
    "service_account_ref": "principal_0123456789AB",
    "status": "active",
    "successor_credential_ref": "credential_0123456789AB",
    "version": 1
  }
}

`GET /api/v1/service_accounts/{principal_ref}/grants`

operation_id: listServiceAccountGrants

Permissão: grants:read_list
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "principal_ref": "principal_0123456789AB"
}

Exemplo de resposta

{
  "data": {
    "available_actions": [],
    "items": []
  }
}

`POST /api/v1/service_accounts/{principal_ref}/grants`

operation_id: grantServiceAccountPermission

Permissão: grants:manage_grant
Idempotência: required
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{
  "permission_action": "example",
  "reason_code": "example"
}

Exemplo de resposta

{
  "data": {
    "effect": "allow",
    "permission_action": "example",
    "version": 1
  }
}

`POST /api/v1/service_accounts/{principal_ref}/grants/{permission_action}/revoke`

operation_id: revokeServiceAccountPermission

Permissão: grants:manage_revoke
Idempotência: required
CAS: if_match_required
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{
  "reason_code": "example"
}

Exemplo de resposta

{
  "data": {
    "effect": "allow",
    "permission_action": "example",
    "version": 1
  }
}

`POST /api/v1/service_accounts/{principal_ref}/resume`

operation_id: resumeServiceAccount

Permissão: service_accounts:manage_resume
Idempotência: required
CAS: if_match_required
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{
  "reason_code": "example"
}

Exemplo de resposta

{
  "data": {
    "display_name": "example",
    "principal_ref": "principal_0123456789AB",
    "status": "active",
    "version": 1
  }
}

`POST /api/v1/service_accounts/{principal_ref}/retire`

operation_id: retireServiceAccount

Permissão: service_accounts:manage_retire
Idempotência: required
CAS: if_match_required
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{
  "reason_code": "example"
}

Exemplo de resposta

{
  "data": {
    "display_name": "example",
    "principal_ref": "principal_0123456789AB",
    "status": "active",
    "version": 1
  }
}

`POST /api/v1/service_accounts/{principal_ref}/suspend`

operation_id: suspendServiceAccount

Permissão: service_accounts:manage_suspend
Idempotência: required
CAS: if_match_required
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{
  "reason_code": "example"
}

Exemplo de resposta

{
  "data": {
    "display_name": "example",
    "principal_ref": "principal_0123456789AB",
    "status": "active",
    "version": 1
  }
}

`GET /api/v1/subscription-changes`

operation_id: listSubscriptionChanges

Permissão: subscription_changes:read_list
Idempotência: none
CAS: none
Cursor: cursor
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "cursor": "example"
}

Exemplo de resposta

{
  "data": {
    "items": []
  }
}

`GET /api/v1/subscription-changes/{subscription_change_ref}`

operation_id: retrieveSubscriptionChange

Permissão: subscription_changes:read_retrieve
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "subscription_change_ref": "example"
}

Exemplo de resposta

{
  "data": {
    "capture_ref": "cap_0123456789AB",
    "created_at": "2026-08-15T12:00:00Z",
    "currency": "BRL",
    "effective_at": "2026-08-15T12:00:00Z",
    "effective_mode": "immediate",
    "invoice_ref": "in_0123456789AB",
    "payment_ref": "pay_0123456789AB",
    "replaced_by_subscription_change_ref": "subchange_0123456789AB",
    "state": "pending_payment",
    "subscription_change_ref": "subchange_0123456789AB",
    "subscription_ref": "sub_0123456789AB",
    "total_amount_minor": "19700",
    "updated_at": "2026-08-15T12:00:00Z",
    "version": 1
  }
}

`GET /api/v1/subscriptions`

operation_id: listSubscriptions

Permissão: subscriptions:read_list
Idempotência: none
CAS: none
Cursor: cursor
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "cursor": "example"
}

Exemplo de resposta

{
  "data": {
    "items": []
  }
}

`GET /api/v1/subscriptions/{subscription_ref}`

operation_id: retrieveSubscription

Permissão: subscriptions:read_retrieve
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "subscription_ref": "example"
}

Exemplo de resposta

{
  "data": {
    "anchor_day_of_month": 1,
    "beneficiary_buyer_ref": "buyer_0123456789AB",
    "cadence_interval": "day",
    "cadence_interval_count": 1,
    "created_at": "2026-08-15T12:00:00Z",
    "currency": "BRL",
    "current_cycle": {
      "amount_minor": "19700",
      "currency": "BRL",
      "period_end": "2026-08-15T12:00:00Z",
      "period_start": "2026-08-15T12:00:00Z",
      "status": "scheduled"
    },
    "current_period_end": "2026-08-15T12:00:00Z",
    "current_period_start": "2026-08-15T12:00:00Z",
    "dunning": {
      "access_applied": "none",
      "closed_at": "2026-08-15T12:00:00Z",
      "grace_ends_at": "2026-08-15T12:00:00Z",
      "opened_at": "2026-08-15T12:00:00Z",
      "status": "open"
    },
    "first_charge_amount_minor": "19700",
    "first_charge_at": "2026-08-15T12:00:00Z",
    "first_charge_currency": "BRL",
    "items": [],
    "origin_order_ref": "order_0123456789AB",
    "original_anchor_at": "2026-08-15T12:00:00Z",
    "purchaser_buyer_ref": "buyer_0123456789AB",
    "status": "trialing",
    "stored_payment_method_ref": "spm_0123456789AB",
    "subscription_ref": "sub_0123456789AB",
    "trial_ends_at": "2026-08-15T12:00:00Z",
    "updated_at": "2026-08-15T12:00:00Z",
    "version": 1
  }
}

`GET /api/v1/webhook_deliveries/{delivery_ref}`

operation_id: retrieveWebhookDelivery

Permissão: webhooks:read_retrieve_delivery
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "delivery_ref": "whd_0123456789AB"
}

Exemplo de resposta

{
  "data": {
    "attempt_count": 0,
    "created_at": "2026-08-15T12:00:00Z",
    "dead_lettered_at": "2026-08-15T12:00:00Z",
    "delivery_ref": "whd_0123456789AB",
    "diagnostic": false,
    "dto_version": 1,
    "endpoint_ref": "whep_0123456789AB",
    "generation": 0,
    "public_event_type": "example",
    "retry_expires_at": "2026-08-15T12:00:00Z",
    "status": "pending"
  }
}

`GET /api/v1/webhook_deliveries/{delivery_ref}/attempts`

operation_id: listWebhookDeliveryAttempts

Permissão: webhooks:read_list_attempts
Idempotência: none
CAS: none
Cursor: cursor
Quota: "none"
Erros: authentication_failed, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "cursor": "example",
  "delivery_ref": "whd_0123456789AB"
}

Exemplo de resposta

{
  "data": {
    "items": []
  }
}

`GET /api/v1/webhook_deliveries/{delivery_ref}/body`

operation_id: retrieveWebhookDeliveryBody

Permissão: webhooks:read_delivery_body
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "delivery_ref": "whd_0123456789AB"
}

Exemplo de resposta

{
  "data": {
    "body_status": "redacted",
    "delivery_ref": "whd_0123456789AB",
    "match_reasons": [],
    "payload": null
  }
}

`POST /api/v1/webhook_deliveries/{delivery_ref}/redrive`

operation_id: redriveWebhookDelivery

Permissão: webhooks:redrive_unit
Idempotência: required
CAS: if_match_required
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_key_required, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{
  "reason": "example"
}

Exemplo de resposta

{
  "data": {
    "delivery_ref": "whd_0123456789AB",
    "outcome": "accepted"
  }
}

`POST /api/v1/webhook_deliveries/redrive`

operation_id: batchRedriveWebhookDeliveries

Permissão: webhooks:redrive_batch
Idempotência: required
CAS: if_match_required
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_key_required, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{
  "delivery_refs": [
    "whd_0123456789AB"
  ],
  "reason": "example"
}

Exemplo de resposta

{
  "data": {
    "results": []
  }
}

`GET /api/v1/webhook_endpoints`

operation_id: listWebhookEndpoints

Permissão: webhooks:read_list_endpoints
Idempotência: none
CAS: none
Cursor: cursor
Quota: "none"
Erros: authentication_failed, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "cursor": "example",
  "status": "active"
}

Exemplo de resposta

{
  "data": {
    "items": []
  }
}

`POST /api/v1/webhook_endpoints`

operation_id: createWebhookEndpoint

Permissão: webhooks:manage_create_endpoint
Idempotência: required
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_key_required, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{
  "url": "example"
}

Exemplo de resposta

{
  "data": {
    "created_at": "2026-08-15T12:00:00Z",
    "endpoint_ref": "whep_0123456789AB",
    "secret_versions": [],
    "status": "active",
    "updated_at": "2026-08-15T12:00:00Z",
    "url": "example",
    "url_immutable": false
  }
}

`GET /api/v1/webhook_endpoints/{endpoint_ref}`

operation_id: retrieveWebhookEndpoint

Permissão: webhooks:read_retrieve_endpoint
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "endpoint_ref": "whep_0123456789AB"
}

Exemplo de resposta

{
  "data": {
    "created_at": "2026-08-15T12:00:00Z",
    "endpoint_ref": "whep_0123456789AB",
    "secret_versions": [],
    "status": "active",
    "updated_at": "2026-08-15T12:00:00Z",
    "url": "example",
    "url_immutable": false
  }
}

`GET /api/v1/webhook_endpoints/{endpoint_ref}/data_profile_grants`

operation_id: listWebhookDataProfileGrants

Permissão: webhooks:read_list_data_profile
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "endpoint_ref": "whep_0123456789AB"
}

Exemplo de resposta

{
  "data": {
    "items": []
  }
}

`POST /api/v1/webhook_endpoints/{endpoint_ref}/data_profile_grants`

operation_id: createWebhookDataProfileGrant

Permissão: webhooks:manage_create_data_profile
Idempotência: required
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_key_required, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{
  "custom_field_refs": [],
  "data_classes": [],
  "purpose": "example",
  "reason": "example"
}

Exemplo de resposta

{
  "data": {
    "created_at": "2026-08-15T12:00:00Z",
    "custom_field_refs": [],
    "data_classes": [],
    "endpoint_ref": "whep_0123456789AB",
    "purpose": "example",
    "revoked_at": "2026-08-15T12:00:00Z",
    "status": "active"
  }
}

`POST /api/v1/webhook_endpoints/{endpoint_ref}/data_profile_grants/revoke`

operation_id: revokeWebhookDataProfileGrant

Permissão: webhooks:manage_revoke_data_profile
Idempotência: required
CAS: if_match_required
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_key_required, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{
  "reason": "example"
}

Exemplo de resposta

{
  "data": {
    "created_at": "2026-08-15T12:00:00Z",
    "custom_field_refs": [],
    "data_classes": [],
    "endpoint_ref": "whep_0123456789AB",
    "purpose": "example",
    "revoked_at": "2026-08-15T12:00:00Z",
    "status": "active"
  }
}

`GET /api/v1/webhook_endpoints/{endpoint_ref}/deliveries`

operation_id: listWebhookDeliveries

Permissão: webhooks:read_list_deliveries
Idempotência: none
CAS: none
Cursor: cursor
Quota: "none"
Erros: authentication_failed, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "cursor": "example",
  "endpoint_ref": "whep_0123456789AB"
}

Exemplo de resposta

{
  "data": {
    "items": []
  }
}

`GET /api/v1/webhook_endpoints/{endpoint_ref}/health`

operation_id: retrieveWebhookEndpointHealth

Permissão: webhooks:read_health
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "endpoint_ref": "whep_0123456789AB"
}

Exemplo de resposta

{
  "data": {
    "endpoint_ref": "whep_0123456789AB",
    "health": "ok",
    "last_delivery_status": "pending"
  }
}

`POST /api/v1/webhook_endpoints/{endpoint_ref}/pause`

operation_id: pauseWebhookEndpoint

Permissão: webhooks:manage_pause_endpoint
Idempotência: required
CAS: if_match_required
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_key_required, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{}

Exemplo de resposta

{
  "data": {
    "created_at": "2026-08-15T12:00:00Z",
    "endpoint_ref": "whep_0123456789AB",
    "secret_versions": [],
    "status": "active",
    "updated_at": "2026-08-15T12:00:00Z",
    "url": "example",
    "url_immutable": false
  }
}

`POST /api/v1/webhook_endpoints/{endpoint_ref}/resume`

operation_id: resumeWebhookEndpoint

Permissão: webhooks:manage_resume_endpoint
Idempotência: required
CAS: if_match_required
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_key_required, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{}

Exemplo de resposta

{
  "data": {
    "created_at": "2026-08-15T12:00:00Z",
    "endpoint_ref": "whep_0123456789AB",
    "secret_versions": [],
    "status": "active",
    "updated_at": "2026-08-15T12:00:00Z",
    "url": "example",
    "url_immutable": false
  }
}

`POST /api/v1/webhook_endpoints/{endpoint_ref}/secret/confirm`

operation_id: confirmWebhookSecret

Permissão: webhooks:rotate_confirm
Idempotência: required
CAS: if_match_required
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_key_required, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{
  "reason": "example"
}

Exemplo de resposta

{
  "data": {
    "created_at": "2026-08-15T12:00:00Z",
    "endpoint_ref": "whep_0123456789AB",
    "secret_versions": [],
    "status": "active",
    "updated_at": "2026-08-15T12:00:00Z",
    "url": "example",
    "url_immutable": false
  }
}

`POST /api/v1/webhook_endpoints/{endpoint_ref}/secret/revoke`

operation_id: revokeWebhookSecret

Permissão: webhooks:rotate_revoke
Idempotência: required
CAS: if_match_required
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_key_required, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{
  "reason": "example"
}

Exemplo de resposta

{
  "data": {
    "created_at": "2026-08-15T12:00:00Z",
    "endpoint_ref": "whep_0123456789AB",
    "secret_versions": [],
    "status": "active",
    "updated_at": "2026-08-15T12:00:00Z",
    "url": "example",
    "url_immutable": false
  }
}

`POST /api/v1/webhook_endpoints/{endpoint_ref}/secret/rotate`

operation_id: rotateWebhookSecret

Permissão: webhooks:rotate_secret
Idempotência: required
CAS: if_match_required
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_key_required, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{
  "reason": "example"
}

Exemplo de resposta

{
  "data": {
    "created_at": "2026-08-15T12:00:00Z",
    "endpoint_ref": "whep_0123456789AB",
    "secret_versions": [],
    "status": "active",
    "updated_at": "2026-08-15T12:00:00Z",
    "url": "example",
    "url_immutable": false
  }
}

`GET /api/v1/webhook_endpoints/{endpoint_ref}/subscriptions`

operation_id: listWebhookSubscriptions

Permissão: webhooks:read_list_subscriptions
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{
  "endpoint_ref": "whep_0123456789AB"
}

Exemplo de resposta

{
  "data": {
    "items": []
  }
}

`POST /api/v1/webhook_endpoints/{endpoint_ref}/subscriptions`

operation_id: createWebhookSubscription

Permissão: webhooks:manage_create_subscription
Idempotência: required
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_key_required, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{
  "dto_version": 1,
  "public_event_type": "example",
  "scope_ref": "example",
  "scope_type": "tenant"
}

Exemplo de resposta

{
  "data": {
    "created_at": "2026-08-15T12:00:00Z",
    "custom_field_refs": [],
    "dto_version": 1,
    "endpoint_ref": "whep_0123456789AB",
    "public_event_type": "example",
    "scope_ref": "example",
    "scope_type": "tenant"
  }
}

`POST /api/v1/webhook_endpoints/{endpoint_ref}/test_send`

operation_id: sendWebhookTest

Permissão: webhooks:manage_test_send
Idempotência: required
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, dependency_unavailable, forbidden, idempotency_key_required, idempotency_mismatch, not_found, precondition_failed, precondition_required, semantic_error, validation_failed, version_conflict

Continue em erros e SDKs.

Exemplo de requisição

{
  "public_event_type": "example"
}

Exemplo de resposta

{
  "data": {
    "attempt_count": 0,
    "created_at": "2026-08-15T12:00:00Z",
    "dead_lettered_at": "2026-08-15T12:00:00Z",
    "delivery_ref": "whd_0123456789AB",
    "diagnostic": false,
    "dto_version": 1,
    "endpoint_ref": "whep_0123456789AB",
    "generation": 0,
    "public_event_type": "example",
    "retry_expires_at": "2026-08-15T12:00:00Z",
    "status": "pending"
  }
}

`GET /api/v1/webhook_event_types`

operation_id: listWebhookEventTypes

Permissão: webhooks:read_event_catalog
Idempotência: none
CAS: none
Cursor: none
Quota: "none"
Erros: authentication_failed, forbidden, not_found, validation_failed

Continue em erros e SDKs.

Exemplo de requisição

{}

Exemplo de resposta

{
  "data": {
    "items": []
  }
}

​Referência REST

​OpenAPI reference

​GET /api/v1/buyers

​Exemplo de requisição

​Exemplo de resposta

​GET /api/v1/buyers/{buyer_ref}

​Exemplo de requisição

​Exemplo de resposta

​GET /api/v1/captures

​Exemplo de requisição

​Exemplo de resposta

​GET /api/v1/captures/{capture_ref}

​Exemplo de requisição

​Exemplo de resposta

​POST /api/v1/checkout-configs

​Exemplo de requisição

​Exemplo de resposta

​GET /api/v1/checkout-configs/{config_ref}

​Exemplo de requisição

​Exemplo de resposta

​POST /api/v1/checkout-configs/{config_ref}/publish

​Exemplo de requisição

​Exemplo de resposta

​POST /api/v1/checkout-configs/{config_ref}/versions

​Exemplo de requisição

​Exemplo de resposta

​GET /api/v1/checkout-sessions

​Exemplo de requisição

​Exemplo de resposta

​POST /api/v1/checkout-sessions

​Exemplo de requisição

​Exemplo de resposta

​GET /api/v1/checkout-sessions/{checkout_session_ref}

​Exemplo de requisição

​Exemplo de resposta

​POST /api/v1/checkout-sessions/{checkout_session_ref}/pay

​Exemplo de requisição

​Exemplos de resposta

​retrieve_payment_response

​subscription_setup_action_required

​subscription_started

​POST /api/v1/credentials/{credential_ref}/revoke

​Exemplo de requisição

​Exemplo de resposta

​POST /api/v1/credentials/{credential_ref}/rotate

​Exemplo de requisição

​Exemplo de resposta

​GET /api/v1/disputes

​Exemplo de requisição

​Exemplo de resposta

​GET /api/v1/disputes/{dispute_ref}

​Exemplo de requisição

​Exemplo de resposta

​GET /api/v1/entitlements

​Exemplo de requisição

​Exemplo de resposta

​GET /api/v1/entitlements/{entitlement_ref}

​Exemplo de requisição

​Exemplo de resposta

​GET /api/v1/environments

​Exemplo de requisição

​Exemplo de resposta

​GET /api/v1/invoices

​Exemplo de requisição

​Exemplo de resposta

​GET /api/v1/invoices/{invoice_ref}

​Exemplo de requisição

​Exemplo de resposta

​GET /api/v1/journeys

​Exemplo de requisição

​Exemplo de resposta

​GET /api/v1/journeys/{journey_ref}

​Exemplo de requisição

​Exemplo de resposta

​GET /api/v1/offers

​Exemplo de requisição

​Exemplo de resposta

​GET /api/v1/offers/{offer_ref}

​Exemplo de requisição

​Exemplo de resposta

Referência REST

OpenAPI reference

`GET /api/v1/buyers`

Exemplo de requisição

Exemplo de resposta

`GET /api/v1/buyers/{buyer_ref}`

Exemplo de requisição

Exemplo de resposta

`GET /api/v1/captures`

Exemplo de requisição

Exemplo de resposta

`GET /api/v1/captures/{capture_ref}`

Exemplo de requisição

Exemplo de resposta

`POST /api/v1/checkout-configs`

Exemplo de requisição

Exemplo de resposta

`GET /api/v1/checkout-configs/{config_ref}`

Exemplo de requisição

Exemplo de resposta

`POST /api/v1/checkout-configs/{config_ref}/publish`

Exemplo de requisição

Exemplo de resposta

`POST /api/v1/checkout-configs/{config_ref}/versions`

Exemplo de requisição

Exemplo de resposta

`GET /api/v1/checkout-sessions`

Exemplo de requisição

Exemplo de resposta

`POST /api/v1/checkout-sessions`

Exemplo de requisição

Exemplo de resposta

`GET /api/v1/checkout-sessions/{checkout_session_ref}`

Exemplo de requisição

Exemplo de resposta

`POST /api/v1/checkout-sessions/{checkout_session_ref}/pay`

Exemplo de requisição

Exemplos de resposta

`retrieve_payment_response`

`subscription_setup_action_required`

`subscription_started`

`POST /api/v1/credentials/{credential_ref}/revoke`

Exemplo de requisição

Exemplo de resposta

`POST /api/v1/credentials/{credential_ref}/rotate`

Exemplo de requisição

Exemplo de resposta

`GET /api/v1/disputes`

Exemplo de requisição

Exemplo de resposta

`GET /api/v1/disputes/{dispute_ref}`

Exemplo de requisição

Exemplo de resposta

`GET /api/v1/entitlements`

Exemplo de requisição

Exemplo de resposta

`GET /api/v1/entitlements/{entitlement_ref}`

Exemplo de requisição

Exemplo de resposta

`GET /api/v1/environments`

Exemplo de requisição

Exemplo de resposta

`GET /api/v1/invoices`

Exemplo de requisição

Exemplo de resposta

`GET /api/v1/invoices/{invoice_ref}`

Exemplo de requisição

Exemplo de resposta

`GET /api/v1/journeys`

Exemplo de requisição

Exemplo de resposta

`GET /api/v1/journeys/{journey_ref}`

Exemplo de requisição

Exemplo de resposta

`GET /api/v1/offers`

Exemplo de requisição

Exemplo de resposta

`GET /api/v1/offers/{offer_ref}`

Exemplo de requisição

Exemplo de resposta