API

Criar pagamento

Para iniciar um pagamento usando uma única forma de pagamento, basta direcionar o usuário para um URL especial.

You can specify the Callback URL in the merchant settings in the panel

Um exemplo de geração de uma assinatura digital PHP

function getFormSignature($id, $currency, $amount, $external_invoice, $secretKey) { $hashStr = $id.'{up}'.$currency.'{up}'.$amount.'{up}'.$external_invoice.'{up}'.$secretKey; return hash('sha256', $hashStr); } $signature = getFormSignature($id, $currency, $amount, $external_invoice, $secretKey);

A assinatura digital é formada como sha256 (os parâmetros de inicialização do pagamento são descritos acima com secretKey = ACCESS KEY nas configurações do comerciante de pagamento). Ao criar uma assinatura digital, todas as variáveis ​​listadas no exemplo devem ser indicadas.

Exemplo de inicialização do pagamento

https://cryptokick.app/api/merchant.php?

act=request_payment

test=Y

form=Y

coin=BTC

id=Identificador das configurações do comerciante de pagamento

amount=0.01

currency=BTC

external_invoice=1000

message=Test Invoice

signature=Assinatura digital

callback_url=http://example.com/pay.php

Modo de teste

Se o valor do parâmetro for test = Y, a solicitação será executada no modo de teste. A fatura terá o status Pago sem pagamento real e creditará o pagamento. Uma notificação de pagamento por e-mail não será enviada. Se o URL do manipulador for transmitido ( callback_url), o resultado será enviado a ele.

Saída do resultado

Success

Parâmetro	Valor	Descrição
status	String	Return success
amount	Número	Valor do pagamento na criptomoeda selecionada
invoice	Número	Número da conta interna usada no sistema
external_invoice	String	Número da conta externa usada em sua loja
link	String	Link to QR code
address	String	Endereço gerado da carteira (BTC / USDT)
message	String	Descrição da conta que foi transmitida quando a conta foi gerada

Error

Parâmetro	Valor	Descrição
status	String	Return error
message	String	Error message

Processador de pagamento

Após o recebimento do pagamento da fatura, notificamos o site da loja sobre o status do pagamento enviando uma solicitação GET para o URL do manipulador (parâmetro callback_url).

Parâmetro	Descrição
id	Identificador das configurações do comerciante de pagamento
key	Chave de confirmação das configurações do comerciante de pagamento
coin	Qual criptomoeda pagou a conta
currency	Em que moeda é a conta gerada de acordo com a ISO 4217
invoice	Número da conta interna usada no sistema
external_invoice	Número da conta externa usada em sua loja
amount	Valor do pagamento recebido em criptomoeda
amount_in_currency	Valor da conta na moeda da conta gerada
message	Descrição da conta que foi transmitida quando a conta foi gerada
signature	Assinatura digital gerada

Um exemplo da formação e verificação de uma assinatura digital em PHP

function getSignature($id, $currency, $amount_in_currency, $external_invoice, $secretKey) { $hashStr = $id.'{up}'.$currency.'{up}'.$amount_in_currency.'{up}'.$external_invoice.'{up}'.$secretKey; return hash('sha256', $hashStr); } $signature = getSignature($_GET["id"], $_GET["currency"], $_GET["amount_in_currency"], $_GET["external_invoice"], $secretKey); if ($_GET["signature"] != $signature) exit('Incorrect Digital Signature');

No processador de pagamento, você deve gerar uma assinatura digital usando as variáveis ​​recebidas e compará-la com a assinatura digital recebida. Use a tecla ACCESS nas configurações do comerciante de pagamento para o valor secretKey.

Verifique sempre a conformidade de todos os parâmetros recebidos, bem como os endereços IP dos quais as solicitações são enviadas ao processador de pagamentos.

Formato de resposta da notificação de pagamento

É aplicável se o URL do manipulador for especificado durante a formação do pagamento (parâmetro callback_url)

Como resultado do processamento de uma solicitação GET contendo dados de pagamento, o site da loja deve retornar uma resposta com o código 200 como uma string:

• A resposta é igual à linha 'ok'- significa que os dados do pagamento foram recebidos, as notificações para este pagamento não são mais necessárias.
• Qualquer outra resposta - isso significa que a loja não recebeu os dados e continuará a ser notificada.

Nota: o número máximo de notificações para receber uma resposta bem-sucedida do site da loja:

Nota: todas as novas notificações serão tentadas a cada 5

Se a resposta não corresponder à sequência 'ok', os primeiros 255 caracteres da resposta da loja à solicitação serão salvos e disponíveis para visualização em sua conta.

Nota: se a solicitação for executada no modo de teste e a notificação de pagamento falhar, o código de resposta e a linha de resposta estarão disponíveis na página de pagamento da fatura. Para visualizar, clique no status da notificação do destinatário. No modo normal, é exibido somente status.

Banners recomendados para veiculação

<a href="https://cryptokick.app/index.php"><img src="https://cryptokick.app/images/banner_320x100.png" alt="Aceitamos pagamentos em BTC / CryptoKick.app" height="50" width="160">

Você pode redimensionar o banner com os parâmetros height e width, mantendo a proporção do seu tamanho total

50x160 px