Pular para o conteúdo principal

Nossa coleção de API

Conheça um pouco mais e explore nosso listado API para começar a ter idéia do que é possível

Obter os códigos da API

Suas solicitações de APIs são autenticadas usando códigos de API "Bearer Token", o método de autenticação é compatível, utilizando o "TokenApi" fornecido ao comerciante como token.

Além disso, os dados que são enviados devem estar sempre assinados com uma "SecretKey", nossa plataforma verifica que os dados enviados pertencem ao comerciante e não foram adulterados durante o envio através da rede.

Qualquer pedido que não inclua um código API retornará um erro. Tanto o TokenApi como o SecretKey serão fornecidos ao comerciante pela administração.

info

Esta seção é muito importante, no caso de não completar os primeiros passos, a comunicação da nossa API com o seu projeto não será possível.

Como assinar com a sua SecretKey?

Todos os parâmetros devem estar na assinatura exceto o parâmetro "sign", que é onde vai a assinatura. Primeiro, os parâmetros devem ser classificados por ordem alfabética ascendente, de acordo com o nome do parâmetro.

Uma vez ordenados, os parâmetros devem concatenar-se em uma cadeia, por exemplo, se seus parâmetros são.


    # Parâmetros para assinar.
$data = [
'currency' => 'CLP',
'country' => 'CL',
'amount' => 45000,
'clientName' => 'Demo',
'clientEmail' => '[email protected]',
'clientPhone' => '999999999',
'clientDocument' => '999999999',
'paymentMethod' => 'webpay_payment',
'urlConfirmation' => 'https://www. example.com/payment-responses/param/55',
'urlFinal' => 'https://www.example.com/payment-responses/param/55',
'urlRejected' => 'https://www.example.com/payment-reject/param/55',
'order' => 3000001
];

A string ordenada para a assinatura deve ficar assim:

// Corda para assinar.
$keys = array_keys($data);
sort($keys);
$toSign = '';
foreach ($keys as $key) {
$toSign .= $key . $data[$key];
}
info

Aviso: esta seção é muito importante, pois se você não concluir as primeiras etapas, não conseguirá se comunicar com nossa API em seu projeto.

Por fim, a string concatenada deve ser assinada com a função hmac usando sha256 e SecretKey como chave.

 // Obtenção da assinatura.
$sign = hash_hmac('sha256', $toSign, $secretKey);