Skip to content

Commit

Permalink
Merge pull request #47 from painjansen/patch-2
Browse files Browse the repository at this point in the history
#46 - updated description.md
  • Loading branch information
OGKevin authored Jun 28, 2018
2 parents bb532db + dcc52e3 commit 6209fc8
Showing 1 changed file with 12 additions and 13 deletions.
25 changes: 12 additions & 13 deletions DESCRIPTION.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,6 @@

***NOTICE:*** *We have updated the sandbox base url to <https://public-api.sandbox.bunq.com/v1/>. Please update your applications accordingly. Check here: https://github.com/bunq/sdk_php/issues/149 for more info.*

***NOTICE***: *We're changing the origin of our callbacks for sandbox to originate from the Amazon network. Read the [receiving callbacks](#Receiving-Callbacks) section for more info.*

# Introduction

Welcome to bunq!
Expand Down Expand Up @@ -46,6 +44,7 @@ Once the speed of iteration slows down and more developers start using the API a
1. Create an Installation with the installation POST call and provide a new public key. After doing so you receive an authentication token which you can use for the API calls in the next steps.
2. Create a DeviceServer with the device-server POST call and provide a description and API key.
3. Create a SessionServer with the session-server POST call. After doing so you receive a new authentication token which you can use for the API calls during this active Session.​

### IP addresses

When using a standard API Key the DeviceServer and Installation that are created in this process are bound to the IP address they are created from. Afterwards it is only possible to add IP addresses via the Permitted IP endpoint.
Expand Down Expand Up @@ -272,6 +271,14 @@ A unique ID for the response formatted as a UUID. Clients can use it to add extr

The server's signature for this response. See the signing page for details on how to verify this signature.

### Warning header

#### X-Bunq-Warning

`X-Bunq-Warning: "You have a negative balance. Please check the app for more details."`

Used to inform you on situations that might impact your bunq account and API access.

# Errors

Familiar HTTP response codes are used to indicate the success or failure of an API request.
Expand Down Expand Up @@ -420,25 +427,17 @@ The `notification_filters` object looks like this:
| SHARE | notifications for any updates or creation of Connects (ShareInviteBankInquiry).|
| TAB_RESULT | notifications for updates on Tab payments.|
| BUNQME_TAB | notifications for updates on bunq.me Tab (open request) payments.|
| SUPPORT | notifications for messages received from us through support chat.|

### Mutation Category

A Mutation is a change in the balance of a monetary account. So, for each payment-like object, such as a request, iDEAL-payment or a regular payment, a Mutation is created. Therefore, the `MUTATION` category can be used to keep track of a monetary account's balance.

### Receiving Callbacks

***NOTICE***: We're changing the origin of our callbacks for sandbox to originate from the Amazon network.

Callbacks for the sandbox environment will be made from AWS starting May 28th 2018. 
Callbacks for the sandbox environment will be made from different IP's at AWS. 
Callbacks for the production environment will be made from 185.40.108.0/22.

Until 2018-06-09 we'll continue to send callbacks from:

- `185.40.109.64` callback outgoing IP production.
- `185.40.109.65` callback outgoing IP production.
- `185.40.111.64` callback outgoing IP production.
- `185.40.111.65` callback outgoing IP production.

*The IP addresses might change*. We will notify you in a timely fashion if such a change would take place.

### Retry mechanism
Expand Down Expand Up @@ -744,4 +743,4 @@ To decide how you are going to make your tab visible, pass a visibility object i

Setting `cash_register_qr_code` to true will connect this tab to the QR code from the cash register. If this cash register does not have a QR code yet, one will be created. Only one Tab can be connected to the cash register’s QR code at any given time.

Setting `tab_qr_code` to true will create a QR code specifically for this tab. This QR code can not be linked to anything else.
Setting `tab_qr_code` to true will create a QR code specifically for this tab. This QR code can not be linked to anything else.

0 comments on commit 6209fc8

Please sign in to comment.