Link / Front-end Integration
The Link Integration (also called Simple Loan Form) allows merchants on hosted platforms to direct customers to a WeGetFinancing-hosted form without making a server-side API call. Cart and customer data are passed as URL query parameters.
Loan Form URL
Section titled “Loan Form URL”| Environment | Base URL |
|---|---|
| Live | https://partner.wegetfinancing.com/partner/loan/{merchant_id} |
| Sandbox | https://partner.sandbox.wegetfinancing.com/partner.sandbox/loan/{merchant_id} |
Replace {merchant_id} with your numeric merchant ID (e.g. 1234).
Query String Parameters
Section titled “Query String Parameters”Append parameters to the URL to pre-fill the form. At a minimum, pass cart_items and shipping_amount.
| Parameter | Type | Description |
|---|---|---|
cart_items | JSON array | Cart items — see Cart Item Format |
shipping_amount | decimal(2) | Shipping cost |
first_name | string | Customer first name |
last_name | string | Customer last name |
email | string | Customer email |
billing_address | string | Street address |
billing_city | string | City |
billing_state | string (2) | State abbreviation |
billing_zipcode | string | ZIP code |
tax_amount | integer | Total tax in dollars |
merchant_transaction_id | string | Your order ID — echoed back in postbacks |
success_url | string | Redirect after successful approval |
failure_url | string | Redirect if the customer cancels |
software_name | string | Shopping cart software name (tracking only) |
Cart Item Format
Section titled “Cart Item Format”cart_items is a URL-encoded JSON array:
[ {"sku": "ref43", "display_name": "TV Samsung 30\"", "quantity": 2, "unit_price": 2500, "unit_tax": 250.00}, {"sku": "ref342", "display_name": "Training Course", "quantity": 1, "unit_price": 1500, "unit_tax": 150.00}]| Field | Type | Required | Description |
|---|---|---|---|
sku | string | Yes | Internal product reference |
display_name | string | Yes | Human-readable product name |
unit_price | decimal | Yes | Price per unit |
quantity | integer | Yes | Number of units |
unit_tax | decimal | No | Tax amount per unit |
Example URL
Section titled “Example URL”https://partner.sandbox.wegetfinancing.com/partner.sandbox/loan/1234? first_name=John& last_name=Doe& email=john%40example.com& billing_address=15th+Fantasy+Street& billing_city=New+York& billing_state=NY& billing_zipcode=10007& shipping_amount=50.00& merchant_transaction_id=ORDER-123& success_url=https%3A//your-shop.com/success& failure_url=https%3A//your-shop.com/cart& cart_items=%5B%7B%22sku%22%3A%22tv01%22%2C%22display_name%22%3A%22TV%22%2C%22quantity%22%3A1%2C%22unit_price%22%3A1370%7D%5DEmbedded iframe
Section titled “Embedded iframe”The loan form can also be embedded directly in your page as an iframe:
<iframe id="wgf_iframe" src="https://partner.wegetfinancing.com/partner/loan/1234?shipping_amount=50&cart_items=[...]" frameborder="0" width="100%" height="900px"></iframe>Include the wegetfinancing.js widget to enable the lightbox-style interaction alongside the iframe:
<script src="https://cdn.wegetfinancing.com/libs/1.0/wegetfinancing.js"></script>See Lightbox Widget for the full widget integration guide.
Manual PPE Installation
Section titled “Manual PPE Installation”For custom HTML pages or platform templates where the PPE widget is not installed via an app, add the estimator manually:
<!-- In <head> --><link href="https://ppe.wegetfinancing.com/index.css" rel="stylesheet" /><script>window.ppeConfiguration = { priceSelector: ".price", // adjust to match your theme's price element token: "YOUR_ACCESS_TOKEN", minAmount: 500, branded: true};</script>
<!-- Before </body> --><script src="https://ppe.wegetfinancing.com/index.js"></script>See PPE Widget for the full configuration reference.