Merchants — v1 Legacy API

The v1 Legacy API is available at api.wegetfinancing.com. It is fully active for all e-commerce integrations.

Base URLs

Environment	URL
Live	https://api.wegetfinancing.com
Sandbox	https://api.sandbox.wegetfinancing.com

Authentication

All outbound-facing endpoints use HTTP Basic Auth:

Authorization: Basic <base64(username:password)>
Content-Type: application/json

Credentials are obtained from the merchant back-office under Integration → API Integration. Sandbox and production use separate credentials.

Endpoints at a Glance

Method	Path	Description
POST	/merchant/{merchant_id}/requests	Create a financing request
POST	/merchant/{merchant_id}/shipping	Update shipping information
POST	/merchant/{merchant_id}/postbacks	Create a test postback (sandbox only)

Process Flow

1. Merchant creates a request. Submit a financing request with customer and cart data to POST /merchant/{merchant_id}/requests.
2. API returns order token and URL. The response contains inv_id (unique order ID) and href (customer-facing lightbox URL).
3. Customer completes application. The merchant redirects or shows the href in a lightbox.
4. WeGetFinancing submits to lenders. After all required information is collected, the request is submitted to configured lenders.
5. Merchant receives decision via postback. After a lender decision, a POST is sent to the merchant’s configured postback URL. Only create the order when an approved postback is received. See Postbacks to Merchants for the payload format.

Common Error Response

{
  "type": "error",
  "error": "missing_parameters",
  "code": 400,
  "message": "MissingParameters",
  "subjects": ["first_name", "email"],
  "reasons": {
    "first_name": "Missing required parameter",
    "email": "Missing required parameter"
  }
}

error value	Meaning
generic	Uncategorised error
http	HTTP protocol error
missing_parameters	Required parameters absent
invalid_parameters	Parameters present but invalid