Você pode começar sem site e sem desenvolvedor e passar para a API mais tarde, sem alterar contas ou se inscrever novamente. Cada rota abaixo usa o mesmo checkout hospedado, o mesmo painel e os mesmos pagamentos.
Links de pagamento
Crie um link no seu painel e compartilhe-o por e-mail, WhatsApp, mensagem ou post. O cliente paga na página de checkout seguro e o pagamento aparece no seu painel com nome, endereço de e-mail e número de celular.
Nada para instalar e nenhum código. Um link para um produto recorrente inicia uma assinatura em vez de um pagamento único, e a página de finalização da compra mostra os termos de renovação antes que o cliente pague.
Sessões de checkout hospedadas
Seu servidor cria uma sessão de checkout com o que o cliente está comprando e depois envia para o endereço da sessão. Eles pagam na página hospedada e voltam para o endereço de retorno que você escolher.
Uma sessão é válida por 24 horas. Um webhook assinado informa ao servidor o resultado, para que você possa liberar o pedido mesmo que o cliente nunca mais volte ao seu site.
A API REST
JSON sobre HTTPS em utopia-payments.com/api/v1, com uma chave secreta que você cria em Dashboard → Desenvolvedores. Os recursos são produtos, clientes, sessões de checkout, pagamentos, assinaturas, endpoints de webhook, eventos e sua própria conta.
- Os valores são unidades inteiras menores: 34.900 é AED 349,00.
- As listas são paginadas com um cursor, portanto, um longo histórico é lido em ordem, sem lacunas.
- Um POST com uma chave de idempotência reproduz sua primeira resposta por 24 horas, portanto, uma nova tentativa após um tempo limite não pode ser cobrada duas vezes.
- As chaves são limitadas a 240 solicitações por minuto.
As chaves de teste podem criar produtos e clientes hoje, mas um checkout de teste hospedado precisa de credenciais de sandbox que ainda não estão habilitadas e não há números de cartão de teste. Até que isso aconteça, experimente o fluxo com uma chave ativa e um pequeno pagamento real – nunca com os detalhes do cartão de alguém como substitutos.
Bibliotecas Node e PHP
Ambas as bibliotecas cobrem a mesma API, carregam recursos digitados e verificam assinaturas de webhook para você em uma chamada.
npm install @utopia-payments/nodecomposer require utopia-payments/utopia-phpWooCommerce
Um plug-in do WordPress adiciona Utopia como método de pagamento na finalização da compra do WooCommerce: o comprador paga na página hospedada e o pedido é marcado como pago no webhook e não no navegador do cliente.
Baixe o zip da documentação e instale-o em Plugins → Adicionar Novo → Carregar Plugin. Ele ainda não está listado no WordPress.org, então é atualizado substituindo o zip.
Ainda não existe um aplicativo Shopify nativo. As lojas Shopify usam um link de pagamento Utopia junto com um método de pagamento manual até que haja um.
Documentação
Não tem certeza de qual rota se encaixa? Descreva sua configuração para sales@utopia-payments.com.