Como configurar um gateway de pagamento personalizado
Guia do desenvolvedor para integração de um gateway de pagamento personalizado com Tilda
Tilda está integrado a sistemas de pagamento populares como Stripe, PayPal e 2Checkout. Veja como integrar um sistema de pagamento personalizado ao seu site usando o Custom Payment Gateway.
Todos os modelos de integração aprovados e testados estão disponíveis na lista pública de modelos. Todas as integrações foram criadas pelos desenvolvedores de sistemas de pagamento. Ao selecionar um modelo, você encontrará um link para a documentação do sistema de pagamento e o endereço de e-mail dos desenvolvedores para perguntas sobre a integração. Tilda O suporte não poderá ajudar com nenhuma pergunta relacionada a integrações de terceiros.
- ArsenalPay https://arsenalpay.ru/
- Best2Pay - https://best2pay.net
- PSCB - https://pscb.ru
- ENOTio - https://enot.io
- Express-pay - https://express-pay.by
- Prodamus - https://payform.ru
- CapustaSpace - https://capusta.space
- EPAY Halyk Bank - https://epay.kkb.kz
- UCS - https://ucscards.ru
- Paymo - https://paymo.ru
- PayOnline - https://www.payonline.ru
- Remuneração líquida - https://netpay.ru
- Intercards - https://intercards.ru
- Contador - https://paykeeper.ru/
- IPS - https://ips.su/ru_RU/
- Unitpay https://unitpay.ru/
- Invoicebox https://www.invoicebox.ru/ru/
- Express-pay - https://express-pay.by
- Modulbank - https://modulbank.ru
- Fondy - https://fondy.ru/
- Concordpay - https://pay.concord.ua/
- Monopay https://monobank.ua/
- Payboxmoney https://paybox.money/
Para configurar uma integração completa com um gateway de pagamento personalizado, vá para Configurações do site → Sistemas de pagamento e selecione "Gateway de pagamento personalizado".
Importante: Se não houver um modelo adequado entre os modelos de solução de pagamento, entre em contato com a equipe de desenvolvedores do sistema de pagamento e envie a eles um link para este guia. A criação de um novo modelo requer a participação dos desenvolvedores.
Você pode selecionar um modelo de integração ou criar um modelo personalizado.
Os modelos são as predefinições de parâmetros para a integração de um sistema específico. Eles podem incluir configurações inalteráveis, como o URL da API ou o campo do número do pedido, e configurações alteráveis ("Configurações avançadas").
Se você vir um modelo para sua solução de pagamento entre as opções, isso significa que os desenvolvedores entraram em contato conosco, para que você possa configurar facilmente uma integração com seu sistema de pagamento.
Os modelos são as predefinições de parâmetros para a integração de um sistema específico. Eles podem incluir configurações inalteráveis, como o URL da API ou o campo do número do pedido, e configurações alteráveis ("Configurações avançadas").
Se você vir um modelo para sua solução de pagamento entre as opções, isso significa que os desenvolvedores entraram em contato conosco, para que você possa configurar facilmente uma integração com seu sistema de pagamento.
Observe que a Tilda Publishing não se responsabiliza pela operação e segurança de qualquer integração de sistema de pagamento de terceiros.
Leia o aviso oficial de isençãode responsabilidade →
Leia o aviso oficial de isençãode responsabilidade →
ISENÇÃO DE RESPONSABILIDADE
Ao expressar sua intenção de se integrar ao serviço Custom Payment Gateway (doravante - CP Gateway) e/ou ao realizar as ações para conexão e uso posterior do recurso de pagamento selecionado (doravante - Sistema de pagamento), a pessoa jurídica ou empresário individual que enviou uma solicitação de integração (doravante - Solicitante) e o Usuário da Plataforma de Publicação Tilda (doravante - Usuário) confirmam, por meio deste, sua concordância com o seguinte:
1. A Administração da Plataforma de Publicação Tilda (doravante - a Administração) faz o possível para fornecer aos Usuários informações precisas e confiáveis.
1.1. A Administração não será responsável por controlar a legitimidade das informações fornecidas pelos Candidatos, bem como por determinar seus direitos e/ou obrigações legais.
1.2. Ao enviar uma solicitação de integração, o Solicitante garante e confirma que possui o status legal necessário e suficiente para realizar as atividades de fornecimento da execução de transações de pagamento, conforme especificado na solicitação, incluindo as permissões necessárias exigidas pela legislação nacional.
1.3. O Requerente garante a legitimidade do uso do sistema de pagamento reivindicado e confirma que sua integração e uso posterior não infringem os direitos e interesses legítimos de terceiros, incluindo os direitos aos resultados do esforço intelectual.
2. De acordo com a lei aplicável, a Administração renuncia a quaisquer garantias, cuja provisão pode estar implícita, e responsabilidade com relação ao uso de sistemas de pagamento integrados ao CP Gateway.
2.1. A Administração da Plataforma não garante a segurança do uso dos Sistemas de Pagamento e seu funcionamento contínuo.
2.2. A Administração da Plataforma fornece apenas as capacidades computacionais necessárias que permitem integrar um ou outro sistema de Pagamento com o CP Gateway com a finalidade de sua posterior utilização pelos Usuários da Plataforma em seus projetos.
2.3. A Administração não é sujeito ou parte interessada nas relações que surjam entre o Solicitante, o Usuário da Plataforma e terceiros.
2.4. A Administração da Plataforma não se responsabiliza por:
a) quaisquer ações e/ou inações dos provedores de serviços, redes, software ou equipamentos;
b) quaisquer danos (danos diretos/indiretos, lucros cessantes) que possam ocorrer como resultado do uso dos sistemas de pagamento, incluindo, mas não se limitando a, danos aos dispositivos e mídias de armazenamento de informações e/ou software de qualquer Usuário, bem como à suspensão de suas atividades comerciais.
3.O Usuário é o único responsável por sua escolha e uso posterior de um sistema de Pagamento, bem como por quaisquer atividades associadas ao comércio eletrônico.
3.1. O Usuário é responsável por garantir a conformidade com quaisquer leis aplicáveis a ele e suas atividades por conta própria.
3.2. O Usuário concorda que o uso do sistema de pagamento selecionado por ele pode estar sujeito a taxas adicionais.
3.3. O Usuário usa o sistema de Pagamento selecionado exclusivamente por sua conta e risco, levando em consideração que ele pode estar sujeito a termos e condições legais e financeiros que regulam as atividades dos candidatos e com os quais se recomenda que o Usuário se familiarize antes de usar o sistema de Pagamento selecionado.
4. Agindo em conformidade com os requisitos da lei/exigências (notificações, reivindicações) das autoridades competentes e/ou seus funcionários, a Administração da Plataforma tem o direito de, a qualquer momento, suspender ou bloquear o acesso a qualquer sistema de pagamento ou excluí-lo do CP Gateway - independentemente de o sistema de pagamento relevante estar conectado no projeto do usuário em um determinado momento, sem obrigações decorrentes para o próprio usuário e/ou seus clientes.
1. A Administração da Plataforma de Publicação Tilda (doravante - a Administração) faz o possível para fornecer aos Usuários informações precisas e confiáveis.
1.1. A Administração não será responsável por controlar a legitimidade das informações fornecidas pelos Candidatos, bem como por determinar seus direitos e/ou obrigações legais.
1.2. Ao enviar uma solicitação de integração, o Solicitante garante e confirma que possui o status legal necessário e suficiente para realizar as atividades de fornecimento da execução de transações de pagamento, conforme especificado na solicitação, incluindo as permissões necessárias exigidas pela legislação nacional.
1.3. O Requerente garante a legitimidade do uso do sistema de pagamento reivindicado e confirma que sua integração e uso posterior não infringem os direitos e interesses legítimos de terceiros, incluindo os direitos aos resultados do esforço intelectual.
2. De acordo com a lei aplicável, a Administração renuncia a quaisquer garantias, cuja provisão pode estar implícita, e responsabilidade com relação ao uso de sistemas de pagamento integrados ao CP Gateway.
2.1. A Administração da Plataforma não garante a segurança do uso dos Sistemas de Pagamento e seu funcionamento contínuo.
2.2. A Administração da Plataforma fornece apenas as capacidades computacionais necessárias que permitem integrar um ou outro sistema de Pagamento com o CP Gateway com a finalidade de sua posterior utilização pelos Usuários da Plataforma em seus projetos.
2.3. A Administração não é sujeito ou parte interessada nas relações que surjam entre o Solicitante, o Usuário da Plataforma e terceiros.
2.4. A Administração da Plataforma não se responsabiliza por:
a) quaisquer ações e/ou inações dos provedores de serviços, redes, software ou equipamentos;
b) quaisquer danos (danos diretos/indiretos, lucros cessantes) que possam ocorrer como resultado do uso dos sistemas de pagamento, incluindo, mas não se limitando a, danos aos dispositivos e mídias de armazenamento de informações e/ou software de qualquer Usuário, bem como à suspensão de suas atividades comerciais.
3.O Usuário é o único responsável por sua escolha e uso posterior de um sistema de Pagamento, bem como por quaisquer atividades associadas ao comércio eletrônico.
3.1. O Usuário é responsável por garantir a conformidade com quaisquer leis aplicáveis a ele e suas atividades por conta própria.
3.2. O Usuário concorda que o uso do sistema de pagamento selecionado por ele pode estar sujeito a taxas adicionais.
3.3. O Usuário usa o sistema de Pagamento selecionado exclusivamente por sua conta e risco, levando em consideração que ele pode estar sujeito a termos e condições legais e financeiros que regulam as atividades dos candidatos e com os quais se recomenda que o Usuário se familiarize antes de usar o sistema de Pagamento selecionado.
4. Agindo em conformidade com os requisitos da lei/exigências (notificações, reivindicações) das autoridades competentes e/ou seus funcionários, a Administração da Plataforma tem o direito de, a qualquer momento, suspender ou bloquear o acesso a qualquer sistema de pagamento ou excluí-lo do CP Gateway - independentemente de o sistema de pagamento relevante estar conectado no projeto do usuário em um determinado momento, sem obrigações decorrentes para o próprio usuário e/ou seus clientes.
Se o seu sistema de pagamento não estiver na lista, você precisará entrar em contato com os desenvolvedores da solução de pagamento para que eles solicitem a criação de uma.
Para iniciar o procedimento, você precisa especificar o nome e o URL do sistema de pagamento para o qual o usuário deve ser redirecionado com uma solicitação POST para concluir o pagamento, um e-mail de contato e qualquer informação adicional que possa ajudar na integração, como links para a documentação do sistema de pagamento.
Para iniciar o procedimento, você precisa especificar o nome e o URL do sistema de pagamento para o qual o usuário deve ser redirecionado com uma solicitação POST para concluir o pagamento, um e-mail de contato e qualquer informação adicional que possa ajudar na integração, como links para a documentação do sistema de pagamento.
Importante: A criação de um novo modelo requer conhecimento profundo de integração e programação de gateway de pagamento. Para criar um modelo, você precisa ser um desenvolvedor de soluções de pagamento ou ter conhecimento profundo dos detalhes da integração.
Assim que a equipe de moderação aprovar o modelo, ele ficará disponível na lista para um projeto específico. Depois disso, você poderá modificar as configurações adicionais, alterar os nomes das variáveis transmitidas com os pedidos dos clientes e depurar a integração.
Primeiro, você precisa especificar os nomes de todos os campos críticos e obrigatórios cujos dados devem ser transmitidos junto com os pedidos dos clientes e modificar as configurações adicionais, como caso, formato e comprimento do campo.
Primeiro, você precisa especificar os nomes de todos os campos críticos e obrigatórios cujos dados devem ser transmitidos junto com os pedidos dos clientes e modificar as configurações adicionais, como caso, formato e comprimento do campo.
Depois de configurar os campos obrigatórios, talvez seja necessário especificar outras variáveis transmitidas quando um pedido é criado. É possível adicioná-las na seção "Lista de campos adicionais". O número de itens da lista depende das necessidades de integração.
Você também precisa configurar a assinatura da ordem e especificar as regras para sua formação (os campos excluídos, o princípio de classificação, o delimitador e o algoritmo de criptografia).
Primeiro, você precisa selecionar as regras de assinatura ou selecionar "All fields" (Todos os campos) e especificar os campos excluídos, o princípio de classificação e o delimitador. Se você precisar de um formato de dados personalizado, selecione "Special rules" (Regras especiais) e defina as regras do formato personalizado.
Primeiro, você precisa selecionar as regras de assinatura ou selecionar "All fields" (Todos os campos) e especificar os campos excluídos, o princípio de classificação e o delimitador. Se você precisar de um formato de dados personalizado, selecione "Special rules" (Regras especiais) e defina as regras do formato personalizado.
Depois disso, você precisa configurar o indicador de pagamento bem-sucedido (o nome e o valor do parâmetro) e especificar o que o sistema deve retornar em resposta a pagamentos bem-sucedidos ou recusados.
Formato de interação
1. O comprador adiciona um produto ao carrinho de compras, preenche o formulário e clica em Checkout.
2. O site Tilda recebe uma solicitação para salvar o novo pedido e retorna um conjunto de parâmetros que serão incluídos na solicitação para o sistema de pagamento, seguindo a lista de campos de mapeamento e a lista de campos adicionais das configurações de integração avançadas.
2. O site Tilda recebe uma solicitação para salvar o novo pedido e retorna um conjunto de parâmetros que serão incluídos na solicitação para o sistema de pagamento, seguindo a lista de campos de mapeamento e a lista de campos adicionais das configurações de integração avançadas.
Importante: entre os parâmetros, deve haver sempre um campo contendo a assinatura do pedido. A assinatura é gerada a partir dos valores dos outros campos usando um algoritmo específico e a chave de pagamento. É possível configurar esse algoritmo na seção "Order signature" (Assinatura do pedido) das configurações de integração avançadas.
O usuário é redirecionado para o URL da API do modelo. Os parâmetros são transferidos usando o método POST.
O sistema de pagamento processa os parâmetros e, se a assinatura estiver correta, exibe o formulário de pagamento, processa o pagamento e se comunica com outros sistemas, se necessário.
O sistema de pagamento pode redirecionar o usuário para a página de sucesso após o pagamento bem-sucedido (se especificado nas configurações) ou enviar uma notificação.
O sistema de pagamento também deve enviar uma solicitação para o URL de notificação, um URL dedicado do servidor Tilda . Essa solicitação também deve transferir parâmetros e a assinatura usando o método POST (os algoritmos de assinatura podem ser diferentes). Nas configurações avançadas, você também precisa adicionar um campo (e especificar seu valor) usado na verificação do status do pagamento, que será um indicador de pagamento bem-sucedido.
O pedido será marcado como pago em Tilda somente depois que uma solicitação com a assinatura, o número do pedido, o valor e o indicador de pagamento bem-sucedido corretos forem enviados ao URL de notificação.
O sistema de pagamento processa os parâmetros e, se a assinatura estiver correta, exibe o formulário de pagamento, processa o pagamento e se comunica com outros sistemas, se necessário.
O sistema de pagamento pode redirecionar o usuário para a página de sucesso após o pagamento bem-sucedido (se especificado nas configurações) ou enviar uma notificação.
O sistema de pagamento também deve enviar uma solicitação para o URL de notificação, um URL dedicado do servidor Tilda . Essa solicitação também deve transferir parâmetros e a assinatura usando o método POST (os algoritmos de assinatura podem ser diferentes). Nas configurações avançadas, você também precisa adicionar um campo (e especificar seu valor) usado na verificação do status do pagamento, que será um indicador de pagamento bem-sucedido.
O pedido será marcado como pago em Tilda somente depois que uma solicitação com a assinatura, o número do pedido, o valor e o indicador de pagamento bem-sucedido corretos forem enviados ao URL de notificação.
Como personalizar campos
Para que os usuários entendam mais facilmente a quais campos do sistema de pagamento Tilda correspondem, oferecemos a opção de renomear alguns campos e dicas de ferramentas na seção "Form Settings" (Configurações do formulário) nas configurações avançadas.
Como depurar uma integração
Para depurar uma integração, crie uma página e configure-a de acordo com o guia How to Set Up a Shopping Cart (Como configurar um carrinho de compras): Adicione o carrinho de compras e o bloco de produtos à página e publique-a.
Sugerimos que você faça um pagamento de teste e verifique se o pagamento foi concluído. Se estiver tudo certo, entre em contato com a equipe de moderação e seu modelo será adicionado à lista pública.
Sugerimos que você faça um pagamento de teste e verifique se o pagamento foi concluído. Se estiver tudo certo, entre em contato com a equipe de moderação e seu modelo será adicionado à lista pública.
