SovPay Custom Integration

Private self-hosted update and release information page for merchants who want to integrate sovpay.js directly into a custom checkout flow.

Integration Information

Quick Integration Steps

1. Identify the checkout field IDs used for your merchant ID, total amount in USD, order description, and unique intent ID.
2. Retrieve your API Key and Signature Public Key from your Digital Freedom account under Settings and Merchant Information.
3. Define the global sovpay object in your page header and map it to your checkout field IDs.
4. Implement the result_handler function to handle paid and non-paid outcomes in your own merchant flow.
5. Load the hosted sovpay.js script in the page head and keep using the hosted version instead of storing a local copy.

Required sovpay Fields

• api_key — your Digital Freedom merchant API key.
• merchant_id_field — the field ID containing your merchant ID.
• price_usd_field — the field ID containing the total amount in USD.
• desc_field — the field ID containing the order description.
• sovpay_btn_div — the DIV where the payment button will be rendered.
• intent_field — the field ID containing your unique transaction intent ID.
• public_sig_key — your Digital Freedom Signature Public Key.
• result_handler — your callback for processing the signed result returned by the hosted flow.

Required Checkout Placeholders

• merchant_id
• amount_usd
• description
• intent_id
• sovpay_btn
• sovpay_iframe

Example sovpay Configuration

const sovpay = {
  api_key: 'YOUR_API_KEY',
  merchant_id_field: 'merchant_id',
  price_usd_field: 'amount_usd',
  desc_field: 'description',
  sovpay_btn_div: 'sovpay_btn',
  intent_field: 'intent_id',
  public_sig_key: `-----BEGIN PUBLIC KEY-----
YOUR_SIGNATURE_PUBLIC_KEY
-----END PUBLIC KEY-----`,

  result_handler: function (result) {
    if (result.status === 'PAID') {
      // Handle successful payment.
      // Confirm the result in your merchant flow before fulfillment.
    } else {
      // Handle non-paid or error states.
    }

    console.log(result);
  }
};

Hosted Script Include

<script src="https://account.digitalfreedom.network/js/sovpay.js?version=3"></script>

Basic Checkout Placeholders

<input type="number" min="1" step="1" name="merchant_id" id="merchant_id" />
<input type="number" name="amount_usd" id="amount_usd" />
<input type="text" name="description" id="description" maxlength="512" />
<input type="text" id="intent_id" name="intent_id" maxlength="36" />

<div id="sovpay_btn" name="sovpay_btn"></div>
<div id="sovpay_iframe" name="sovpay_iframe"></div>

Support Contact

For technical support, release coordination, or questions about custom merchant integration, please contact support@sovran.gold.