Skip to main content
Ready-to-LaunchCustom Builds
Start Building Now

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.

4 hours

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:

ResourceRead ScopeWrite Scope
Vendorsbillpay-vendors
Billsbillpay-bills
Linked Accountsbillpay-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>