Array Credit Pull
Integrate third-party credit validation APIs to qualify leads with a soft-pull credit check in Pingtree.
Pingtree supports a soft-pull Credit API that validates a lead’s credit profile without impacting their credit score. Use it to improve lead quality and enforce qualification rules.
Available Products
- Base Credit (Debt)
Returns ranges of unsecured and revolving debt amounts. - Full Credit Offering
Select specific credit factors (accounts age, balances, utilization, collections, liens, bankruptcies, etc.) and apply custom IF/THEN rules per factor.
Required Lead Fields
To call the Credit API, capture and pass these seven values:
- First Name (
first_name
) - Last Name (
last_name
) - Street Address (
address
) - City (
city
) - State (
state
) — use two-letter code (e.g.,CA
) - Zip Code (
zip_code
) - Date of Birth (
date_of_birth
) — formatMM/DD/YYYY
Integration Steps
1. Internal Campaign Forms
Enable Credit Check
In your Campaign Settings, toggle Check Credit Lead Data on your form step (after all seven fields are collected).
Enable for Sources
In Source Settings, toggle Debt Amount for each traffic source to include the credit API.
Campaign Debt Toggle
In Campaign Settings, enable Debt Amount. Input a qualifying threshold if desired (optional).
2. External Offers & Clickscript
- Use Pingtree’s Source API or Clickscript to post lead data.
- Ensure all required parameters match Pingtree’s naming and formatting.
- If you collect a self‑assessed debt amount, post it as
debt_selected
to avoid conflicts.
Pingtree System Fields
After calling the Credit API, Pingtree adds these system fields to your lead record:
qualified_lead
:true
orfalse
— whether the lead met any assigned debt ruleisCreditChecked
:true
orfalse
— whether the API was invokeddebt_amount
: integer — the verified debt from the APIisDebtAmountSuccess
:true
orfalse
— whether the API response was successful
Note: Use the response data to inform downstream routing rules or business logic. **Wallet Balance needs to be greater than 0, and recharge enabled to allow for Credit API to function without issues.