Welcome Developers

Welcome Developers

Getting started with the REST API


The pbVerify RESTful Json API is intended to assist developers to integrate into our various API services for verifications as easily, securely, and quickly as possible. We have built and exclusive portal where you can access all API Documentation via our easy to view Swagger tool. Access to the API portal does come with a comprehensive due diligence onboarding process that requires 10minutes of your valuable time to complete our PBSA account application process. This is a totally digital onboarding process that does not require you to print and upload any documentation. Its all done online via our easy to use digital onboarding system that has been developed to carter for any entity type (CIPC registered companies and Sole Proprietors).

Getting started with the REST API


The SigniFlow JSON API is intended to manage the initiation, cancellation and removal of document workflows created within the SigniFlow system. The API will also manage the security control within the SigniFlow system and generation of workflow steps. The API is hosted within the following location, Development Environment: https://preprod.signiflow.com/



The system you are about to use is a Digital Onboarding system developed for PBSA, and requires no printing or uploading of documents to complete or sign the application. You will be redirected to a digital signing system to sign the account application form once you have completed the online form with all the required details of your business. If you require any assistance, please email support@pbverify.co.za .




Creating a workflow is the core of SigniFlow there are multiple ways in which you can
create a workflow but the most simple way is displayed here:

Login -> Pass Through Your API Account Username And Password.
-> Receive Back a Token Which Is Used For Further Processes.

CreateWorkflow ->Pass Through: Your API Token, Your Document (Base64 Encoded) & Other Information About The Workflow.
->Receive Back a Document ID

AddWorkflowStep ->Pass Through: The Document ID, Your API Token & Information About The Person Being Added.
->Receive Back Data Regarding The Step Added.

DocPrepperAddFields ->Pass Through: The Document ID, Your API Token & Information About The Field Being Added.
->Receive Back Data Regarding The Field Added.

InitiateFlow ->Pass Through: The Document ID, Your API Token
->Receive Back Data Regarding The Workflow.


Keep A Backup Of Your Documents As They Are Updated Or Completed, Feel Safe Knowing SigniFlow Keeps A Full Audit Of All Actions Taken On A Document Which Allows Us To Verify Any Downloaded Document With Our Backup.

Login -> Pass Through Your API Account Username And Password.
-> Receive Back a Token Which Is Used For Further Processes.

GetDoc ->Pass Through: Your API Token, Your Document ID.
->Receive Back a Document As A Base64 Encoded String As
Well As Other Information About The Document.


Get Your Dash Board Information


Login -> Pass Through Your API Account Username And Password.
-> Receive Back a Token Which Is Used For Further Processes.

GetPrepperTemplateList ->Pass Through Your API Token.
->Receive Back All Of Your Dashboard Values Including How Many
Documents You can Still Create.

The Basics


Once we issue your API account details, you will get access to our exclusive API managers portal. In the portal you can view your monthly usage, pull reports on amount of checks one and access your balance. We also give you access to our easy to use developers swagger tool. By inserting your private API account credentials, this tool will out put the required RESTful response, thus cutting down the development time thus saving you money.

Resources Available


pbVerify will endeavour to assist your team when required on how to integrate into our services. Just send an email to our support team and we will get back to you. And if you require a developer resource to assist with your integration we can quote you on an affordable resource to get your integration done.

API Documentation


Bank Account Verification Report


The data verified will show:

  • That the account exists at the institution
  • That the individual (or business) is the rightful owner of the bank account. This is done through the verification of an identity number (or company registration number) against the bank account number supplied
  • That the bank account in question is presently open and active
  • The bank account in question accepts debit and credit transactions
  • That the bank account in question has been in existence for a period exceeding 90 (ninety) days
  • The supplied contact email is the same as that hosted at the bank
  • The supplied contact cell phone is the same as that hosted at the bank

Sandbox


We also understand that testing is a cornerstone of any development project. To cater for this pbVerify has built a mirror environment of our Live environment where you will be able to access most of our services for testing for free at a limited monthly amount. Unfortunately, some functions do not have sandbox environments which are listed below.

  • Bank account verification
  • Bank Code
  • Realtime IDV
  • ID Photo
  • Facial to Hanis
  • Fingerprint Biometric
  • Facial Biometric
  • SADL

Other Basic Implementations


Fetch All Prepper Templates


Get All Your PrepperTemplates To Allow You To Select One To Apply To A WorkFlow.

Login -> Pass Through Your API Account Username And Password.
-> Receive Back a Token Which Is Used For Further Processes.

GetPrepperTemplateList ->Pass Through A Template Folder ID And Your API Token.
->Receive Back A List Of Prepper Templates.


Creating a workflow is the core of SigniFlow there are multiple ways in which you can
create a workflow but the most simple way is displayed here:

Login -> Pass Through Your API Account Username And Password.
-> Receive Back a Token Which Is Used For Further Processes.

Create Docflow ->Pass Through: Your API Token, Your Document (Base64 Encoded) & Other Information About The Workflow.
->Receive Back a Document ID

AddWorkflowStep ->Pass Through: The Document ID, Your API Token & Information About The Person Being Added.
->Receive Back Data Regarding The Step Added.

ApplyPrepperTemplate ->Pass Through: The Document ID, Your API Token & a Template ID.
->Receive Back Data Regarding The Field Added.

InitiateFlow ->Pass Through: The Document ID, Your API Token
->Receive Back API Token from the login API.



Advanced Implementations



Login -> Pass Through Your API Account Username And Password.
-> Receive Back a Token Which Is Used For Further Processes.

FullWorkflow ->Pass Through: Your API Token, Your Document (Base64 Encoded),
All Users Who Will Be Included In The Workflow as well as Where their
fields should be placed & Other Information About The Workflow.
->Receive Back a Document ID and Other Information Regarding The
Workflow.



Finding The Position Of Your Fields


If You Are Not Sure Where Your Fields Should Be Placed, Place White Text Wher You Want Your Field To Be.

Login -> Pass Through Your API Account Username And Password.
-> Receive Back a Token Which Is Used For Further Processes.

CreateWorkflow ->Pass Through: Your API Token, Your Document (Base64 Encoded) & Other Information About The Workflow.
->Receive Back a Document ID

GetDocumentTagField -> Pass Through The Document ID, The Text To Search For And API Token.
-> Receive Back List Of Positions Where The Text Was Found.




Swagger Tool Examples

Industry Leadership




Identity Verification

This API service provides an efficient and fast way to verify South African ID data against Government sourced data. It does this by enabling third parties to submit valid 13-digit South African identification number, from which it retrieves defined results.


Open example Responses From Identity Verification

Facetec Proof of Life – 3D Facial Authentication

The intuitive ZoOm interface makes Certified Liveness Detection and 3D Face Matching fast, easy and incredibly secure for everyone, regardless of their device. During onboarding, ZoOm’s 2-second video-selfie verifies Liveness, matches your 3D FaceMap to your Photo ID, and sets up your new account.


Open example

CIPC - Companies and Intellectual Property Commission

pbVerify's director search function, which accesses data provided by CIPC, is one of the most advanced CIPC search tools in South Africa. This tool enables customers to easily retrieve and verify all directors’ information.


Open example

Drivers License

This API service allows you to decrypt the barcode on the back of a  South African Drivers License using a 2-D Barcode scanner, or webservice to scan an uploaded card using base64.


Open example


Consumer Tracing

Is ideal for tracing agents, debt collectors and debt councillors that need to obtain the latest contact information of a consumer whilst simultaneously determining whether the consumer is under debt review. The report aggregates the latest public trace, contactibility and debt review data into one convenient trace report.


Open example

Know-Your-Customer (KYC)

Know-Your-Customer (KYC) legislation has been introduced in most major financial centres across the globe. Such legislation is driven by recommendations and standards set by the Financial Action Task Force (FATF)..


Open example

Sanctions Screening

This product allows users to perform initial due diligence by screening potential clients, agents and business partners through the industry-leading WorldCompliance database. Containing more than 2.5 million detailed profiles, the database helps clients detect individuals, organizations and vessels linked to more than 50 risk categories; including: AML Sanctions ScreeningPEP/PIP and Adverse Media.


Open example

Consumer Credit
Consumer Credit Report is packed with all the features of some of South Africa's leading credit bureaux Consumer credit reports, but at an affordable price. This report is an aggregate of accurate, reliable and up to date Credit bureau information on any credit active consumer.

Open example

Banking

The Real-Time – Account (Holder) Verification Service (AVS-R) is a function catering for the verification of the match of the identification number and bank account number of an individual or a business with the account details stored within the bank’s database. Currently, the central South African Banks provide this service, in one form or another, to their respective clients. pbVerify provides a platform which allows for the verification of accounts across all participating banks, in a uniform process.


Open example

SARS - VAT
You have the option to search from the Company registration number which will confirm the correct company VAT number that is associated with that business, or you can search by the company VAT number, which will confirm the company name and registration number associated to that VAT number

Open example

Prepaid Account


Activate your API account by applying for a PBSA account. You don’t need to qualify for a credit facility, as Prepaid options are available on request for smaller firms and developers who are building their own applications that require consumer/business validation and verification solutions.

Credit facility(30day)


For larger corporates which want a credit facility linked to their API account to manage their monthly verifications, PBSA offers various credit amounts to suit your budget. (Popup with the requirements for 30 days applications)

Company application for credit facility with PBSA

In order for your company to purchase pbVerify credits on an account, you will need to apply for a 30 day account, (credit facility) with PBSA (Pty) Ltd.

The following minimum requirements MUST be met. If your company does not meet ALL the minimum requirements, please do not apply as you will not be approved. If you are an individual, (non-company) please note PBSA only gives credit facilities to qualifying companies and not individuals, (sole-prop and trusts).


MINIMUM REQUIREMENTS:

  • Business must be trading for more than 2 years.
  • Business bank account must receive an Updated Bank Code status "C" for the credit amount being applied for.
  • Have NO adverse credit information on the company or directors applying for credit.
  • Pass the relevant affordability assessment and compliance checks for company and directors.

REQUIRED DOCUMENTS:

  • Letter from the bank confirming your business banking details, not older than 3 months. Please note: Your business bank account name must match your CIPC company/entity details exactly.
  • Company resolution if the person completing the application is not the authorised signer.

Minimum R 30,000 credit facility required.

Apply Now

Need a quote or have other questions pertaining to our advanced API services? Please don’t hesitate to contact us for further assistance. We are here to help!

Contact Sales