PayPal

Configurando um Perfil Paypal Rest

No menu Ferramentas > API é possível criar perfis da API para utilização em seus projetos, desta forma, será necessário informar suas credenciais uma única vez para utilização da API no projeto.

Acesse a documentação oficial para obter as credenciais necessárias para esse perfil.

Configuração de pagamento utilizando API Paypal

Ao realizar a publicação do seu projeto será necessário configurar as credenciais da API no Prod, acessando o menu API.

Nome

Define o nome para identificação do perfil da API. Este nome é único e será utilizado para referenciar o perfil da API nas aplicações do seu projeto.

Modo

O modo define a disponibilidade de uso do Perfil no Scriptcase.

Público - Os usuários de todos os projetos poderão visualizar e utilizar o perfil criado.
Projeto - Os usuários poderão visualizar e utilizar o perfil no projeto em que foi configurado.
Usuário - Apenas o usuário criador do perfil poderá visualizar e utilizar nas aplicações.

Gateway

Define a API que será utilizada na criação do perfil.

Auth ClientID

Client id da conta Paypal;

Auth Secret

chave de autenticação da conta paypal;

Modo de teste

Permite utilizar a API como modo de teste.

Exemplo de pagamento via PayPal

// Exemplo de uso no Scriptcase para criar um pagamento PayPal via API

// Primeiro, chama a API com o perfil configurado
$gateway = sc_call_api('nome_do_perfil_paypal');  // substitua pelo nome que você deu no Scriptcase

// Define os dados do pagamento
$payment = $gateway->create();

// Valor da transação
$payment->amount = '50.00';           // valor a ser pago (ex: USD ou outra moeda conforme configuração)
$payment->currency = 'USD';           // moeda
$payment->description = 'Compra de produto X';

// Dados do comprador (payer)
$payment->payer = array(
    'first_name' => 'João',
    'last_name'  => 'Silva',
    'email'      => 'joao.silva@exemplo.com'
);

// URLs para redirecionamento após pagamento
$payment->return_url = 'https://seusite.com/retorno_paypal';
$payment->cancel_url = 'https://seusite.com/cancelar_paypal';

// Cria a transação no PayPal
$response = $payment->save();

// Opcional: redireciona o usuário para o PayPal para ele aprovar o pagamento
if (isset($response->approval_url)) {
    header('Location: ' . $response->approval_url);
    exit;
}

// Para depuração, pode exibir a resposta
echo '<pre>';
print_r($response);
exit;

Exemplo de retorno esperado da API PayPal

{
  "id": "5O190127TN364715T",
  "status": "CREATED",
  "links": [
    {
      "href": "https://api.sandbox.paypal.com/v2/checkout/orders/5O190127TN364715T",
      "rel": "self",
      "method": "GET"
    },
    {
      "href": "https://www.sandbox.paypal.com/checkoutnow?token=5O190127TN364715T",
      "rel": "approve",
      "method": "GET"
    },
    {
      "href": "https://api.sandbox.paypal.com/v2/checkout/orders/5O190127TN364715T/capture",
      "rel": "capture",
      "method": "POST"
    }
  ],
  "payer": {
    "name": {
      "given_name": "João",
      "surname": "Silva"
    },
    "email_address": "joao.silva@exemplo.com",
    "payer_id": "PAYERID12345",
    "address": {
      "country_code": "BR"
    }
  },
  "purchase_units": [
    {
      "reference_id": "default",
      "amount": {
        "currency_code": "USD",
        "value": "50.00"
      },
      "payee": {
        "email_address": "vendedor@exemplo.com"
      }
    }
  ]
}