With Custom Banking
This guide walks you through everything needed to integrate Unit's Ready-to-Launch Bill Pay product when you already have Custom Banking.
To get started, make sure you've signed up for Unit's Sandbox environment - if you haven't yet, please do so before proceeding.
Applications API
When creating an application via the Applications API, add BillPay to the requestedProducts array in your request.
The requestedProducts field is available for sole proprietorship and business applications.
See the Create Sole Proprietor Application and Create Business Application endpoints for details.
Application Form
When creating an application form via the Application form, add BillPay to the requestedProducts array in your request.
The requestedProducts field is available for SoleProprietorship, SingleMemberBusiness, or MultipleMemberBusiness application types.
See the Create Application Form endpoint for details.
Embedding the White-Label App
After the application is approved, you can embed the White-Label App using a customer token for bill pay.
For details on customer authentication see the Authentication guide.
Customer token
Bill Pay required scopes:
| Resource | Read Scope | Write Scope |
|---|---|---|
| Vendors | billpay-vendors | |
| Bills | billpay-bills | |
| Linked Accounts | billpay-linked-accounts |
Use following request to create a customer token
curl --location 'https://api.unit.co/customers/10116/token' \
--header 'Content-Type: application/vnd.api+json' \
--header 'Authorization: ${TOKEN}' \
--data '{
"data":{
"type":"customerToken",
"attributes": {
"scope": "applications customers accounts cards transactions statements payments repayments counterparties authorizations billpay-bills billpay-linked-accounts rewards settlements billpay-vendors linked-accounts authorization-requests check-deposits received-payments check-payments customer-token-write",
"upgradableScope": "customers-write accounts-write cards-write cards-sensitive cards-sensitive-write transactions-write payments-write repayments-write payments-write-counterparty payments-write-linked-account payments-write-ach-debit counterparties-write linked-accounts-write authorization-requests-write check-deposits-write received-payments-write check-payments-write billpay-bills-write billpay-vendors-write"
}
}
}'
Embedding the White-Label App
<html>
<head>
<script
async
src="https://ui.s.unit.sh/release/latest/components-extended.js"
></script>
<!-- For production environment use `https://ui.unit.co/release/latest/components-extended.js` as the script source.-->
</head>
<body>
<unit-elements-white-label-app
customer-token="{{customerToken}}"
theme="{{themeUrl}}"
>
</unit-elements-white-label-app>
</body>
</html>