Skip to content
This repository has been archived by the owner on Aug 30, 2024. It is now read-only.

Configure request trigger

Edwin Woudt edited this page Feb 16, 2020 · 3 revisions

Introduction

This is a trigger that fires when a request is received. You can set many different filters to precisely select which transactions you want to receive.

1. Create new trigger

In IFTTT platform, go to API -> Triggers and click on the New trigger button. You can then enter the following details:

  • Name: bunq request (can be changed to anything you like)
  • Description: This trigger fires when a request for money is received under the given conditions. (can be changed to anything you like)
  • Endpoint: choose API and use bunq_request in the URL. Note: this must match exactly!

See screenshot.

2. Trigger fields

Once the trigger had been created, the first step is to define all trigger fields.

Below are all the possible trigger fields. You can add them all for maximum flexibility, but you can also add a subset.

Account [ screenshot ]
Label: Account
Description: Select the account on which to monitor requests
Key name: account
Input type: Dropdown list
Data source for dropdown list: Retrieve list items for my service
Amount comparator [ screenshot ]
Label: Amount comparator
Description: Comparator for the Amount value field
Key name: amount_comparator
Input type: Dropdown list
Data source for dropdown list: Retrieve list items for my service
Amount value [ screenshot ]
Label: Amount account value
Description: Value to compare the requested amount with
Key name: amount_value
Input type: Text input
Amount comparator 2 [ screenshot ]
Label: Amount comparator 2
Description: Comparator for the Amount value 2 field
Key name: amount_comparator_2
Input type: Dropdown list
Data source for dropdown list: Retrieve list items for my service
Amount value 2 [ screenshot ]
Label: Amount value 2
Description: Second value to compare the requested amount with
Key name: amount_value_2
Input type: Text input
Counterparty account comparator [ screenshot ]
Label: Counterparty account comparator
Description: Comparator for the Counterparty account value field
Key name: counterparty_account_comparator
Input type: Dropdown list
Data source for dropdown list: Retrieve list items for my service
Counterparty account value [ screenshot ]
Label: Counterparty account value
Description: Value to compare the counterparty IBAN with
Key name: counterparty_account_value
Input type: Text input
Counterparty account comparator 2 [ screenshot ]
Label: Counterparty account comparator 2
Description: Comparator for the Counterparty account value 2 field
Key name: counterparty_account_comparator_2
Input type: Dropdown list
Data source for dropdown list: Retrieve list items for my service
Counterparty account value 2 [ screenshot ]
Label: Counterparty account value 2
Description: Second value to compare the counterparty IBAN with
Key name: counterparty_account_value_2
Input type: Text input
Counterparty name comparator [ screenshot ]
Label: Counterparty name comparator
Description: Comparator for the Counterparty name value field
Key name: counterparty_name_comparator
Input type: Dropdown list
Data source for dropdown list: Retrieve list items for my service
Counterparty name value [ screenshot ]
Label: Counterparty name value
Description: Value to compare the counterparty name with
Key name: counterparty_name_value
Input type: Text input
Counterparty name comparator 2 [ screenshot ]
Label: Counterparty name comparator 2
Description: Comparator for the Counterparty name value 2 field
Key name: counterparty_name_comparator_2
Input type: Dropdown list
Data source for dropdown list: Retrieve list items for my service
Counterparty name value 2 [ screenshot ]
Label: Counterparty name value 2
Description: Second value to compare the counterparty name with
Key name: counterparty_name_value_2
Input type: Text input
Description comparator [ screenshot ]
Label: Description comparator
Description: Comparator for the Description value field
Key name: description_comparator
Input type: Dropdown list
Data source for dropdown list: Retrieve list items for my service
Description value [ screenshot ]
Label: Description value
Description: Value to compare the request description with
Key name: description_value
Input type: Text input
Description comparator 2 [ screenshot ]
Label: Description comparator 2
Description: Comparator for the Description value 2 field
Key name: description_comparator_2
Input type: Dropdown list
Data source for dropdown list: Retrieve list items for my service
Description value 2 [ screenshot ]
Label: Description value 2
Description: Second value to compare the request description with
Key name: description_value_2
Input type: Text input

3. Verbiage

It doesn't really matter what you put here. A suggestion is to use:

  • bunq account {{fields.account.label}} receives a request for money

4. Ingredients

By default there already is a 'CreatedAt' ingredient.

The following are all possible ingredients. You can add them all (highly suggested), but feel free to leave out ones you do not need.

Amount [ screenshot ]
Name: Amount
Slug: amount
Note: The amount requested
Type: String
Example: 25.00
Account [ screenshot ]
Name: Account
Slug: account
Note: IBAN of the account (yours) from which the money is requested
Type: String
Example: NL42BUNQ2013456789
AccountName [ screenshot ]
Name: AccountName
Slug: account_name
Note: Name/description of the account from which the money is requested
Type: String
Example: Groceries account
CounterpartyAccount [ screenshot ]
Name: CounterpartyAccount
Slug: counterparty_account
Note: IBAN of the counterparty
Type: String
Example: NL42BANK0123456789
CounterpartyName [ screenshot ]
Name: CounterpartyName
Slug: counterparty_name
Note: Name of the counterparty
Type: String
Example: Acme Inc.
Description [ screenshot ]
Name: Description
Slug: description
Note: Description delivered with the request
Type: String
Example: Invoice 12345
RequestId [ screenshot ]
Name: RequestId
Slug: request_id
Note: Unique request identifier
Type: String
Example: 123e4567-e89b-12d3-a456-426655440000

5. Applet templates

These are completely optional. Here are some suggestions:

Mobile push notifications:

  • {{CounterpartyName}} requested {{Amount}}

Short message:

  • {{CounterpartyName}} requested {{Amount}}

Long post:

  • Post title: bunq request
  • Post body: Created: {{CreatedAt}}<br>Account: {{Account}}<br>Amount: {{Amount}}<br>Counterparty account: {{CounterpartyAccount}}<br>Counterparty name: {{CounterpartyName}}<br>Description: {{Description}}

Spreadsheet:

  • Spreadsheet name: bunq_requests_{{Account}}
  • Formatted row: {{Account}}|||{{CreatedAt}}|||{{Amount}}|||{{CounterpartyAccount}}|||{{CounterpartyName}}|||{{Description}}|||{{RequestId}}

6. FInally

Once you are done, the result should look something like this screenshot

Go to API -> Endpoint tests and click on the 'Begin test' button. In case all results are green: congratulations, you configured the request trigger correctly!