Dedicated client money accounts with Verify This collection covers:
Onboarding a customer using Verify Opening a dedicated client money account for the customer Making, receiving, and tracking payments Closing a bank account 1. Onboard a customer using Verifyโ Before you can open bank accounts, you will need to create legal persons to represent your customers in our system.
You are using Verify, our onboarding product that lets you submit your customer's information, and run automated ID&V, screening and anti-fraud checks on them all in one go.
Select the guide you need based on the type of customer you are onboarding.
Your customer Your app Griffin Store these URLs Store these workflow URLs opt [if workflow URLs stored = false] loop [for every claim] opt [if claims not added] ๐ก Webhook available loop [poll verification status] verification-status: in-progress loop [poll ID&V url] verification-status: checks-complete auto-decision made Referred application are reviewed by our team, followed by a manual decision ๐ก Webhook available for decisions loop [poll legal person application status] Once the application-status is accepted, you're ready to go! GET organization-url 200 OK - all relevant URLs returned GET organization-workflows-url 200 OK - all workflows you have access to All information received POST organization-legal-persons-url (with optional set of claims) 201 OK - legal person created all relevant URLs returned POST legal-person-claims-url 201 OK - claim created POST legal-person-verifications-url 201 OK - verification created all relevant URLs returned GET verification-url 200 OK - verification-status pending|in-progress|failed|checks-declined|checks-complete GET verification-resources-url 200 OK - contains idv-check-url Send ID&V URL Complete ID&V flow GET legal-person-url 200 OK - application-status accepted|referred|declined|errored Your customer Your app Griffin 2. Open a client money account for the customerโ You can now use the legal person URL you created in the last step to open a bank account for your customer.
๐ผ Open a client money account
You are using dedicated client money accounts, which means the account will hold money from a single customer, who is the beneficiary of that account.
Your App Griffin ๐ก Webhook available loop [poll] POST organization-bank-accounts-url bank-product-type = client-money-account client-money-type = general-client-money|designated-client-money|designated-client-fund pooled-funds = false beneficiary-URL = legal person URL 201 OK - account status: opening account-url included GET account-url 200 OK - account status: open Your App Griffin 3. Paymentsโ Receive a payment into the accountโ Griffin automatically receives payments, so there are no actions you need to take here, but you can track the progress of inbound payments by creating a webhook.
Your app Webhook admission-status: processing admission-status: delivered Funds credited to the creditor account payment-created admission-created transaction-created admission-updated Your app Webhook Make a payment from the accountโ You can use a webhook or polling to track payments you have submitted.
๐ธ Make a payment
Your app API Webhook service retrieve payment-submissions-url from response body submission-status: processing Funds debited from the debitor account submission-status: delivered Funds credited to the creditor account 1. POST to bank-account-payments-url 201 Payment created 2. POST to payment-submissions-url 200 OK submission-created transaction-created submission-updated Your app API Webhook service 4. Close the bank accountโ Once closed, the bank account cannot be reopened. Once a bank account enters the closing
state, it will no longer accept inbound payments.
๐
Close a bank account
Your app Griffin Account will no longer accept inbound payments loop [poll] ๐ก Webhook available loop [poll] alt [balance > 0] [balance = 0] POST close-account-url 200 OK - account status: closing bring account balance to zero GET account-url 200 OK - account status: closed GET account-url 200 OK - account status: closed Your app Griffin