Primeiros passos

Intro

Use a Seller API por HTTP, SDK ou MCP. Toda face chama a mesma operação pública com a mesma autenticação, permissão, idempotência e erros.

Crie uma service account com raiz humana no Dashboard.
Conceda só as actions necessárias e revele a credencial uma vez.
Chame retrieveRefund no sandbox com refund_ref.

Exemplos live são apenas cópia. O Try It deste portal pede um token curto Trepzy, chama o sandbox diretamente e nunca usa proxy Mintlify. Siga para auth ou a referência REST.

Quickstarts

Os sete SDKs candidatos compartilham o mesmo formato de cliente: sandbox ou live explícito, uma credencial e um timeout. Os snippets em snippets/ compilam contra esse overlay e o sandbox de conformance.

const operationId: string = 'retrieveRefund'
const refund_ref: string = 'ref_0123456789AB'

Os nomes de wire permanecem refund_ref e operation_id em todos os idiomas.

Checkout embutido

Crie a sessão no servidor para que a credencial de máquina nunca chegue ao navegador:

const response = await fetch(`${process.env.TREPZY_BASE_URL}/api/v1/checkout-sessions`, {
  method: 'POST',
  headers: {
    authorization: `Bearer ${process.env.TREPZY_API_KEY}`,
    'content-type': 'application/json',
    'idempotency-key': crypto.randomUUID(),
  },
  body: JSON.stringify({ config_ref: 'ckt_0123456789AB', locale: 'pt-BR', currency: 'BRL' }),
})
const { data } = await response.json()
// Retorne somente data.checkout_session_ref ao navegador.

Monte o iframe controlado pela Trepzy na página do vendedor:

<div id="trepzy-checkout"></div>
<script src="https://checkout.trepzy.com/trepzy-checkout-v1.js"></script>
<script>
  const checkout = TrepzyCheckout.create({
    sessionId: 'cks_0123456789AB',
    mount: '#trepzy-checkout',
    onSuccess(event) {
      // Callback só de apresentação. Consulte sessão/order para verdade comercial.
      console.log(event.checkoutSessionRef)
    },
  })
  checkout.mount()
</script>

Antes de montar, um operador deve propor, aprovar e ativar a origem HTTPS exata do vendedor com a CLI governada product-catalog. Não existe origem padrão. O iframe é recusado quando a versão ativa do tenant/environment não contém location.origin. Registre tanto a origem top-level do vendedor quanto a origem do checkout Trepzy como Stripe Payment Method Domains; wallets cross-origin no Safari também exigem a permissão allow="payment" que o SDK já aplica ao iframe. Os botões Apple Pay e Google Pay são renderizados pelo Stripe somente quando ele reporta o wallet disponível naquele browser, aparelho, merchant, moeda e domínio. Botão ausente é resultado de disponibilidade, não motivo para desenhar um substituto. PAN/CVC permanecem nos Hosted Fields Basis Theory aninhados no iframe Trepzy, preservando a fronteira SAQ-A do vendedor.

Início

Ferramentas

Operação

Primeiros passos

Primeiros passos

Intro

Quickstarts

Checkout embutido

​Primeiros passos

​Intro

​Quickstarts

​Checkout embutido

Primeiros passos

Intro

Quickstarts

Checkout embutido