api

Chirp Notifications

Full support for real time notifications from Chirp

Using the Ping / Callback API extensions to support real-time Chirp integrations.

This use case illustrates handling of real time, asynchronous events reported by Chirp Instant Financial Verification services.

The Chirp IFV subscription is triggered through any of the supported mechanism. For this example, the IFV request will be sent via the Chirp API, as depicted in the following figure.

%%{init: { 'theme':'base', 'themeVariables': { 'primaryColor': '#BB2528', 'primaryTextColor': '#000', 'primaryBorderColor': '#7C0000', 'lineColor': '#F8B229', 'secondaryColor': '#006100', 'tertiaryColor': '#000', 'fontFamily': 'Raleway, Verdana, Arial', 'fontSize': '30px' } } }%% sequenceDiagram participant back as Crediterium participant prov as Chirp opt Request IFV back->>prov: Request IFV activate prov prov->>back: Ack request with requestCode end

The response from Chirp will contain a requestCode to uniquely identify this particular subscription over time.

After this point, and depending on the specific trigger conditions configured within the Chirp environment for the specific customer, various types of events can be sent as per the figure below.

%%{init: { 'theme':'base', 'themeVariables': { 'primaryColor': '#BB2528', 'primaryTextColor': '#000', 'primaryBorderColor': '#7C0000', 'lineColor': '#F8B229', 'secondaryColor': '#006100', 'tertiaryColor': '#000', 'fontFamily': 'Raleway, Verdana, Arial', 'fontSize': '30px' } } }%% sequenceDiagram participant back as Crediterium participant prov as Chirp opt Callback notifications prov-->>back: Refresh status notification prov-->>back: Request status notification prov-->>back: Account disconnect notification prov-->>back: Balance callback notification prov-->>back: Deposit callback notification end

Example Requests

The Chirp Implementation Guide provides examples and details for each supported request.

curl "https://sandbox.ping.api.crediterium.net/v1/chirp" \
  -X POST \
  --header "Content-Type: application/json" \
  --data '<example payload from the documentation>'
Back to our APIs