To integrate FoxyPay into your website, simply follow these simple steps:

1. Obtain your store's API key. To do this, log in to your personal account and navigate to the "My Stores" section.
2. Add your store and undergo moderation.
3. After moderation, you will receive your API key in the store editing section.
4. Your store will operate in the currency you have selected. If your store's currency is EUR, invoices will be issued via the API in EUR.

Once you have obtained the key, you can make an API request to create a payment link.

Endpoint for creating a payment link: https://foxypay.net/api/payment

Fields:

amount - The amount, specified in cents. For example, if you want to create an invoice for $10, you should specify 10 * 100 = 1000.
description - Description of your invoice on the payment page.
webhook_url - Callback address to receive notifications of successful payment.
success_url - The address to return to your website in case of successful payment.
fail_url - The address to return to your website in case of unsuccessful payment.
info - A hidden block with data that comes with the webhook; you can pass your own data here.

PHP (curl) integration code example

<?php $post = [ "amount" => 10000, // 100 USD "description" => 'Payment', //Description "webhook_url" => 'https://mysite.com/foxy_webhook.php', //My WebHook url "success_url" => 'https://mysite.com/success', //My success url "fail_url" => 'https://mysite.com/fail', //My fail url "info" => 'userid=17' //My hidden data for callback ]; $post = http_build_query($post); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, "https://foxypay.net/api/payment"); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, $post); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_HTTPHEADER, [ 'token: STORE_API_KEY' ]); $response = curl_exec($ch); curl_close($ch); $response = json_decode($response); print_r($response);

Python (requests) integration code example

import requests data = { "amount": 10000, # 100 USD "description": 'Payment', # Description "webhook_url": 'https://mysite.com/foxy_webhook', # My WebHook url "success_url": 'https://mysite.com/success', # My success url "fail_url": 'https://mysite.com/fail', # My fail url "info": 'userid=17' # My hidden data for callback } headers = { 'token': 'STORE_API_KEY' } response = requests.post("https://foxypay.net/api/payment", data=data, headers=headers) print(response.json())

Successful Response

Status code: 200 { "success": true, "redirect_url": "PAYMENT_URL" }

status - true, successful response
redirect_url - link for redirection to the payment page

Unsuccessful Response

Status code: 422 { "success": false, "err": "Some error text..." }

status - false, unsuccessful response
err - field containing an error with an explanation of the cause

WebHook

Sent via POST request to your webhook_url that you specified when generating the payment link

{ "code": "PAY_CODE", "amount": 7540, "currency": "USD", "info": "YOUR_INFO", "sign": "SHA256_SIGN" }

Поля

• 1. code - transaction code
• 2. amount - amount (specified in kopecks)
• 3. currency - currency
• 4. info - your field that you provided when generating the payment link
• 5. sign - request signature, HMAC SHA256

Check sign (PHP example)

<?php $data = '{ "code": "PAY_CODE", "amount": 7540, "currency": "USD", "info": "YOUR_INFO", "sign": "SHA256_SIGN" }'; $data = json_decode($data, true); $payload = $data["code"].'.'.$data["amount"].'.'.$data["currency"].'.'.$data["info"]; $signature = hash_hmac('sha256', $payload, STORE_API_KEY); if($data["sign"] == $signature) { echo 'Success'; }