Como proprietário de uma loja online, podes integrar o PayPal em aplicações PHP em poucos minutos. Podes aceitar pagamentos através de plugins, addons, extensões ou manualmente através de aplicações baseadas em estruturas. Com o PayPal integrado na aplicação PHP, também podes encontrar bibliotecas PHP incorporadas e pacotes de composição para reduzir o tempo de desenvolvimento.
Integração de gateway de pagamento em PHP – Uma lista de verificação rápida
Vou entrar nos detalhes da integração do PayPal no gateway de pagamento PHP, mas aqui está uma lista rápida de passos que precisas de dar para configurar o PayPal para as tuas aplicações PHP
- Começa por obter uma conta de programador PayPal e obtém credenciais de sandbox. Isto é essencial para testares a integração.
- Cria a estrutura de diretórios adequada para a integração.
- Começa por criar o ficheiro Payment.php
- Cria o payment_form.php para o formulário que o utilizador pode utilizar para introduzir informações relacionadas com o Paypal.
- Testa a integração para ver se tudo está a funcionar como deveria.
Aloja as tuas aplicações PHP connosco para um desempenho 10x mais rápido
Não deixes que os teus clientes fujam com os tempos de inatividade. Implementa connosco hoje!
O que é o PayPal?
PayPal é uma empresa de processamento de pagamentos internacionalmente aclamada que oferece métodos de pagamento online seguros e fáceis de utilizar. Podes registar facilmente o(s) teu(s) cartão(ões) de crédito/débito numa conta PayPal e podes fazer os teus pagamentos online sem esforço. Pode ser utilizado por uma variedade de empresas, incluindo freelancers, agências digitais, proprietários de lojas de comércio eletrónico e muito mais.
Algumas das melhores funcionalidades que o PayPal oferece incluem:
- Aceita cartões de crédito
- Faturação em linha
- Contas do comprador e do vendedor
- Carrinho de compras
- Pagamentos móveis
- Transferência internacional de dinheiro
Como funciona o PayPal?
Como já foi referido, utilizar o PayPal é bastante fácil. Só tens de seguir três passos para fazeres um pagamento online com sucesso.
1- Escolhe PayPal para fazer o checkout
2- Acede à tua conta
3- Confirma o teu pagamento e paga.
Parece realmente um processo fácil. No entanto, se estiveres a trabalhar com algum produto de software e precisares de aceitar pagamentos recorrentes ou únicos, tens de fazer um pouco mais. Precisas de determinadas chaves API para integrar de forma segura o PayPal em aplicações PHP, o que requer um pouco de conhecimentos técnicos.
Por isso, aqui estão os passos que te podem ajudar a integrar o PayPal em aplicações PHP.
Integração do PayPal em sites PHP
Vamos aprender como integrar o PayPal em sites PHP em apenas alguns passos:
Passo – 1 Cria uma conta PayPal e obtém as credenciais da Sandbox
Cria uma conta PayPal e obtém as credenciais da tua sandbox a partir da tua conta de programador. Receberás credenciais para contas empresariais e pessoais.
Depois, precisarás de um e-mail de teste para aceitar ou enviar pagamentos. Como se trata de um ambiente de teste, não podes utilizar e-mails activos para aceitar pagamentos online.
Passo – 2 Cria ficheiros PHP para adicionar código
Agora, cria uma pasta de diretório para adicionar arquivos PHP. Vê a estrutura na imagem abaixo.
Como podes ver, existem diferentes ficheiros na imagem acima. Vou definir o código que tens de colocar em cada um dos ficheiros. Como implementei a aplicação na Cloudways, tens de ter uma conta para carregar ficheiros. Regista-te e inicia o servidor PHP, depois liga-te ao FileZilla através de SFTP e carrega os ficheiros.
Volta ao código. Depois de criares a diretoria, tens de instalar o Omnipay através do composer. Faz login na conta SSH e navega até à tua aplicação. Executa o seguinte comando.
Omnipay é uma biblioteca de processamento de pagamentos para PHP. Foi delineada com base nas ideias da Dynamic Merchant, envolvendo também experiência na implementação de dezenas de gateways para a CI Merchant. Inclui uma API clara e estável, e é completamente testada em unidades, e de facto vem com uma aplicação de caso para te induzir a começar
o compositor requer omnipay/PayPal
Isto irá instalar o pacote e podemos configurar o PayPal facilmente. O Omnipay permite-te configurar as seguintes opções do PayPal:
- PayPal_Express (PayPal Express Checkout)
- PayPal_ExpressInContext (Checkout expresso no contexto do PayPal)
- PayPal_Pro (Pagamentos de site do PayPal Pro)
- PayPal_Rest (API Rest do PayPal)
Vou utilizar o PayPal Express com a Omnipay. Após a instalação, verás o ficheiro composer.json com o seguinte código.
{
"nome": "root/phpPayPal",
"autores": [
{
"nome": "Ahmed Khan",
"email": "[email protected]"
}
],
"requer": {
"liga/omnipay": "^3.0",
"omnipay/PayPal": "^3.0"
}
}
Se estiveres a trabalhar localmente, podes também criar este ficheiro e adicionar o código acima mencionado manualmente e depois executar `composer install` para adicionar o Omnipay ao projeto.
Passo – 3 Cria o ficheiro Payment.php
Cria uma pasta chamada src e adiciona um arquivo, payment.php, nela. Adiciona o seguinte código no ficheiro e guarda-o. O código contém comentários que são autoexplicativos.
<?php
espaço de nomes Pagamento;
usa Omnipay\Omnipay;
classe Pagamento
{
/**
* @return mixed
*/
função pública gateway()
{
$gateway = Omnipay::create('PayPal_Express');
$gateway->define o nome de utilizador ("[email protected]");
$gateway->setPassword("ARySNgUCvyU9tEBp-zsd0WbbNO_7Nxxxxoi3xxxxh2cTuDxRh7xxxxVu9W5ZkIBGYqjqfzHrjY3wta");
$gateway->setSignature("EOEwezsNWMWQM63xxxxxknr8QLoAOoC6lD_-kFqjgKxxxxxwGWIvsJO6vP3syd10xspKbx7LgurYNt9");
$gateway->defineTestMode(true);
devolve $gateway;
}
/**
* @param array $parameters
* @return mixed
*/
public function purchase(array $parameters)
{
$response = $this->gateway()
->compra($parametros)
->envia();
devolve $resposta;
}
/**
* @param array $parameters
*/
public function complete(array $parameters)
{
$response = $this->gateway()
->completePurchase($parameters)
->envia();
devolve $resposta;
}
/**
* @param $amount
*/
função pública formatAmount($amount)
{
retorna number_format($amount, 2, '.', '');
}
/**
* @param $order
*/
função pública getCancelUrl($order = "")
{
devolve $this->route('http://phpstack-275615-1077014.cloudwaysapps.com/cancel.php', $order);
}
/**
* @param $order
*/
função pública getReturnUrl($order = "")
{
devolve $this->route('http://phpstack-275615-1077014.cloudwaysapps.com/return.php', $order);
}
função pública route($name, $params)
{
return $name; // ya change hua hai
}
}
Agora, tens de adicionar o espaço de nomes Omnipay para utilizar as funções da biblioteca. Podes adicioná-lo no topo utilizando Omnipay\Omnipay.
Agora, declara o modo de pagamento PayPal que vais utilizar para aceitar pagamentos. Para este tutorial, estou a usar o PayPal Express. Por vezes, tens de adicionar credenciais da API, como nome de utilizador, palavra-passe e assinatura. Podes encontrar estas credenciais em Tools -> All Tools -> Integrate PayPal tab -> API Credentials. Vê a captura de ecrã abaixo.
Agora podes começar a utilizar métodos PayPal pré-construídos para a compra, formato do montante, URL de retorno, etc. Não te esqueças de definir esta linha como verdadeira para testar o gateway.
$gateway->defineTestMode(true);
Passo – 4 Cria o ficheiro payment_form.php
O próximo passo é criar um formulário para enviar pagamentos ao PayPal. Este formulário inclui os seguintes campos.
<?php
inclui "vendor/autoload.php";
inclui "src/Payment/payment.php";
utiliza Pagamento\Pagamento;
$payment = new Payment;
// ?>
<!DOCTYPE html>
<html lang="en">
<cabeça>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta http-equiv="X-UA-Compatible" content="ie=edge">
<título>Paga com PayPal</title>
<!-- Últimas CSS compiladas e minificadas -->
<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css">
<!-- Tema opcional -->
<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap-theme.min.css">
<!-- JavaScript compilado e minificado mais recente -->
<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js"></script>
</head>
<corpo>
<div class="contentor">
<div class="linha">
<div class="col-md-6">
<form class="form-horizontal" method="POST" action="https://www.sandbox.PayPal.com/cgi-bin/webscr ">
<conjunto de campos>
<!-- Nome do formulário -->
<lenda>Paga com PayPal</legend>
<!-- Entrada de texto-->
<div class="grupo-formulário">
<label class="col-md-4 control-label" for="amount">Montante do pagamento</label>
<div class="col-md-4">
<input id="amount" name="amount" type="text" placeholder="amount to pay" class="form-control input-md" required="">
<span class="help-block">ajuda</span>
</div>
</div>
<input type='hidden' name='business' value='[email protected]'>
<input type='hidden' name='item_name' value='Camera'>
<input type='hidden' name='item_number' value='CAM#N1'>
<!--<input type='hidden' name='amount' value='10'>-->
<input type='hidden' name='no_shipping' value='1'>
<input type='hidden' name='currency_code' value='USD'>
<input type='hidden' name='notify_url' value='<?php echo $payment->route("notify", "") ?>'>
<input type='hidden' name='cancel_return' value='<?php echo $payment->route("http://phpstack-275615-1077014.cloudwaysapps.com/cancel.php", "") ?>'>
<input type='hidden' name='return' value='<?php echo $payment->route("return", "http://phpstack-275615-1077014.cloudwaysapps.com/return.php") ?>'>
<input type="hidden" name="cmd" value="_xclick">
<!-- Botão -->
<div class="grupo-formulário">
<label class="col-md-4 control-label" for="submit"></label>
<div class="col-md-4">
<botão id="submeter" name="pagar_agora" class="btn btn-perigo">Paga com PayPal</button>
</div>
</div>
</fieldset>
</form>
</div>
</div>
</div>
</body>
</html>
O formulário acima mostrará o campo de entrada básico que pede o valor desejado para processar. Quando submeteres o montante, serás redireccionado para o site do PayPal sandbox para iniciares sessão. Podes iniciar sessão com as credenciais de teste que mostrei acima na primeira imagem deste tutorial.
Testa o PayPal para o envio de pagamentos.
Nesta fase, todos os arquivos devem ser enviados para o servidor de hospedagem web PHP da Cloudways. Encontra o URL do aplicativo na página Detalhes de acesso ao aplicativo. O URL será semelhante a:
http://phpstack-275615-1077014.cloudwaysapps.com/payment_form.php
Verás o formulário básico como o mostrado abaixo:
Introduz o montante e inicia sessão na tua conta de testes com as credenciais de teste, por exemplo:
Envia um e-mail: [email protected]
A tua palavra-passe: #qYxx$x4
Isto levará algum tempo a ser processado. Quando o processo estiver concluído, verás a janela Pagar agora. Clica nela e o montante será pago a partir da tua conta de testes.
Vê a demonstração abaixo:
Também defini o URL de redireccionamento. Se quiseres cancelar o pagamento, basta clicares na ligação de cancelamento na parte inferior e serás redireccionado para a página de cancelamento. Da mesma forma, podes criar páginas diferentes, como sucesso, notificação, etc., utilizando a mesma prática.
Cancelamento de pagamento (cancel.php)
Quando um comprador cancela um pagamento, regressa normalmente à página principal. Por outro lado, podes utilizar a função onCancel para mostrar a página de cancelamento ou ser redireccionado para o carrinho de compras.
paypal.Buttons({
onCancel: função (dados) {
// Mostra uma página de cancelamento ou regressa ao carrinho
}
}).render('#paypal-button-container');
Configura a devolução automática e a transferência de pagamento do PayPal
Segue os passos
- Acede à tua conta PayPal (Negócios)
- No separador “A minha conta”, clica em “Perfil”
- Clica em Pagamentos de sites, em “Produtos e serviços”, no lado esquerdo da página.
- Clica em “Atualizar” junto a “Preferências do site”.
- Clica em Ligar em “Retorno automático”.
- Agora, nos Serviços de pagamento alojados, clica em “Preferências de pagamentos do site”
- Seleciona o botão de rádio “Retorno automático” e introduz o URL de redireccionamento no campo URL
. Além disso, seleciona o botão de rádio “Transferência de dados de pagamento”. - Clica em “Guardar”
Aloja sites PHP com facilidade [A partir de $10 de crédito]
- Encenação gratuita
- Backup gratuito
- PHP 8.0
- Websites ilimitados
Palavras finais
Neste tutorial, demonstrei o processo de como podes integrar o PayPal numa aplicação PHP. Podes estendê-lo para uma utilização mais complexa, como lojas online, etc. Também podes guardar os pagamentos de produtos na base de dados com o estado. O PayPal faz uma verificação rigorosa das contas para detetar quaisquer actividades fraudulentas, por isso sugiro que não o utilizes para pagamentos falsos, caso contrário a tua conta será banida.
Se ainda tiveres mais perguntas sobre este artigo, não hesites em escrevê-las na secção de comentários.
Q. Como é que integro o PayPal no meu site?
A. Podes integrar o PayPal inscrevendo-te numa conta comercial, gerando credenciais de API e utilizando o SDK do PayPal ou a API REST para adicionar funcionalidades de pagamento ao teu site. Guias detalhados estão disponíveis no portal do desenvolvedor do PayPal.
Q. Como integrar um método de pagamento em PHP?
A. Para integrar um método de pagamento em PHP, escolhe um gateway de pagamento (como PayPal ou Stripe), obtém chaves de API e utiliza o SDK PHP do gateway ou a documentação da API para configurar o processamento de pagamentos no teu Web site.
Q. Como implementar o PayPal em PHP?
A. Para implementar o PayPal em PHP, usa o SDK PHP do PayPal ou a API REST. Comece obtendo as credenciais da API da sua conta do PayPal, integre o SDK ao seu projeto e siga o guia de integração do PayPal para criar fluxos de pagamento.
Q. A integração com o PayPal é gratuita?
A. Sim, o PayPal fornece ferramentas de integração e APIs gratuitas. No entanto, o PayPal cobra taxas de transação para processar pagamentos. Podes verificar a estrutura de taxas no site do PayPal.
Shahzeb Ahmed
Um criativo de dia (com uma chávena de chá) e um criativo de noite. Ahmad Kamran é um escritor de conteúdos sazonais e Executivo de Marketing Sénior na Cloudways. Podes encontrá-lo na sua secretária a escrever, a criar estratégias ou a jogar jogos. E, caso não o encontres aqui, ele estará nas montanhas ou à beira do rio.
