Uma Store. Uma API. Vários rails de pagamento.
Este é o quick-start visual da XPayments. A documentação técnica canónica, OpenAPI, onboarding de Stores, credenciais, routing, webhooks, exemplos e payment-method matrix está publicada em docs.xpayments.digital.
Onboarding
Preparar uma integração em quatro passos
Store
Crie/selecione a Store, moeda e domínio. Novas Stores começam em draft até o routing ser ativado.
API Key
Crie uma xp_test_* ou xp_live_* Store-scoped com payments_write. Nunca a exponha no browser.
Merchant Webhook
Configure HTTPS e guarde o signing secret. Verifique x-nexflowx-signature sobre o raw body.
TEST → LIVE
Certifique routing, idempotência e webhook em TEST antes de habilitar tráfego LIVE.
Payment APIs
Escolha a superfície adequada ao produto
API 01 · Native
Native S2S
Merchant controla a UI e consome actions de métodos como PIX, MB WAY, Multibanco e Bizum em Stores habilitadas.
API 02 · Checkout
Checkout XPay
Hosted/Embedded provider-neutral. A Store define branding, métodos e routing; a finalização continua webhook-driven.
API 03 · Stripe-compatible
Stripe Direct + Elements
PaymentIntents via XPayments e Stripe.js/Payment Element no browser. Fluxo de cartão certificado em TEST e LIVE.
Payment methods
Métodos por Store, surface e provider eligibility.
A disponibilidade real depende de moeda, país, capabilities e routing. Stripe Direct pode usar automatic payment methods; Checkout expõe apenas métodos configurados na Store.
Rails D0 · Premium
Rails operacionais acelerados podem ser disponibilizados a Merchants Premium elegíveis, sujeitos a limites, risco, moeda, funding e configuração específica.
Falar sobre D0 / infraestrutura avançadaAI-ready
Entregue o contrato XPayments diretamente ao seu agente de desenvolvimento.
Os playbooks oficiais separam server/browser secrets, idempotência, Store binding, Payment Element, raw-body webhook verification e financial finality.
Regra de confirmação
01
Store
02
API Key
03
Payment / Session
04
Transaction
05
Webhook
pending, requires_action, redirects, QR generation e retorno ao site não são liquidação. O Order deve ser finalizado pelo estado autoritativo da Transaction / Merchant webhook XPayments.