Partner API: deposits in pence and longer redirect URLs
Two small changes to the applications endpoint make it easier to send real-world baskets and redirect URLs.
Some of the most useful changes are the smallest. Based on feedback from partners, we’ve relaxed two validation rules on POST /v1/partner/applications that were rejecting perfectly valid applications.
What changed
Deposits in pence
loanDetails.deposit previously had to be a whole number, so a deposit of £49.99 had to be rounded before it was sent, and the totals could then fail to add up. The field now accepts any amount in pounds and pence.
Longer redirect URLs
successUrl, declineUrl and cancelUrl now accept up to 1,000 characters, up from 100. Modern checkout URLs often carry order references, session tokens and tracking parameters, and 100 characters wasn’t enough. 1,000 matches the limit on webhookUrl.
A reminder on amounts
While you’re checking your amounts, remember the rules the applications endpoint applies to loanDetails:
- loanAmount must be at least £250, the minimum for a Snap Finance credit facility.
- totalCashPrice must equal loanAmount plus deposit.
- All amounts are in pounds, with pence as decimals, for example 100.00.
Try it in the sandbox
The quickest way to check the change is to open the applications endpoint in the reference, press Try it out, and send a deposit with pence or a long successUrl to the sandbox.
Do I need to change anything?
No. Both changes are backwards compatible, so whole-number deposits and short URLs keep working. If you added workarounds, such as rounding deposits or shortening URLs, you can remove them.
As always, make sure totalCashPrice equals loanAmount plus deposit.
