Skip to content

Commit 15aa3ab

Browse files
daanrijpkemacbDaanRijpkema
authored andcommitted
Improved readme, mentioning the new documentation
1 parent 96729f6 commit 15aa3ab

1 file changed

Lines changed: 3 additions & 98 deletions

File tree

README.md

Lines changed: 3 additions & 98 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@ Utilized by other applications as well:
1616
> Read our improved documentation [**here**](https://bluem-development.github.io/bluem-docs/bluemphp.html)
1717
1818
We have several guides available there. They include:
19+
1920
- [Getting started guide](https://bluem-development.github.io/bluem-docs/tutorial-configuration.html)
2021
- [Tutorial on payments](https://bluem-development.github.io/bluem-docs/tutorial-payments.html)
2122
- [Tutorial on webhooks](https://bluem-development.github.io/bluem-docs/tutorial-webhooks.html)
@@ -27,7 +28,8 @@ Most of this will be migrated into the documentation mentioned above. Note: You
2728

2829
## Table of Contents
2930

30-
* [Requirements](#requirements)
31+
- [Requirements](#requirements)
32+
3133
- [Getting started:](#getting-started)
3234
- [Changelog](#changelog)
3335
- [Testing](#testing)
@@ -197,103 +199,6 @@ The Webhook is only needed for ePayments and eMandates: online stores/portals th
197199
Please note that the flow for the IBAN-Name check is shorter: a TransactionRequest is performed. The results return as a TransactionResponse.
198200
This is because the end-user is not needed; the call is straight to the Bank Database, that provides in the TransactionResponse the IBAN-Name check results.
199201

200-
## Preselecting a bank for Payment requests using debtorWallet
201-
202-
**Note:** This is relevant for bank-based transactions and services:
203-
204-
It is possible to preselect a Bank within your own application for Payments, based on an IssuerID (BIC/Swift code) when creating a Mandate, Payment or Identity request. This can be used if you want to user to select the given bank in your own interface and skip the bank selection within the Bluem portal interface.
205-
This reduces the amount of steps required by performing the selection of the bank within your own application and interface by utilizing the preselection feature from the PHP library on the request object as so:
206-
207-
```php
208-
$BIC = "INGBNL2A";
209-
$request->selectDebtorWallet($BIC);
210-
```
211-
212-
Parameter has to be a valid BIC code of a supported bank. An invalid BIC code will trigger an exception. **Please note that supported BICs differ per service as not every bank offers the same services!** The supported BIC codes per service can also be requested from a Bluem object, given the service context. **As appendix to this Documentation file, you can find a full list of all BICs per context.**
213-
214-
Illustrated here is that a list of BICs per context can also be retrieved programmatically:
215-
216-
```php
217-
$MandatesBICs = $bluem->retrieveBICsForContext("Mandates"); // also specific to localInstrumentCode, see notes.
218-
$PaymentsBICs = $bluem->retrieveBICsForContext("Payments");
219-
$IdentityBICs = $bluem->retrieveBICsForContext("Identity");
220-
```
221-
222-
Input of a different context will trigger an exception. If valid, the result is an array of `Bluem\BluemPHP\BIC` objects with attributes `IssuerID` and `IssuerName`: the BIC and Bank name respectively. You can use this to populate your user interface.
223-
224-
Please note that the BIC list will vary when a different `localInstrumentCode` is configured. The localInstrumentCode `CORE` and `B2B` are supported by different banks. Based on your configuration, the right BIC list is loaded from context automatically and used to verify the debtorWallet.
225-
226-
This method can be used when creating iDIN and when creating iDEAL requests; you could store the selected bank (“Issuer”) on user level and use it when creating a request for your user.
227-
228-
- You can inform the user WHY this is necessary and refer to the new laws and rules, in your own website/application or refer to the news/public announcements.
229-
- You can inform the user about the amount of trouble required: display a piece of text saying that it only takes a minute or two, and that it is stored for your convenience: that it ensures integrity, and a valid webshop experience.
230-
231-
## Using different Payment transaction methods
232-
233-
**Important note: ensure you have the right BrandID set up for specific payment methods. Refer to your account manager to retrieve a list of the specific BrandIDs per payment method**
234-
235-
You can allow the PayPal and Creditcard payment methods by selecting these within the request object before sending it.
236-
237-
To use iDeal, (default option). A BIC **can** be provided. If left empty, bank selection will occur in the Bluem portal.
238-
239-
```php
240-
$BIC = 'INGBNL2A';
241-
$request = $request->setPaymentMethodToIDEAL($BIC);
242-
```
243-
244-
To use PayPal, give in a PayPal account email address. The email is also not required.
245-
246-
```php
247-
$payPalAccount = 'john.doe@gmail.com';
248-
$request = $request->setPaymentMethodToPayPal($payPalAccount);
249-
```
250-
251-
To use Creditcards, you can set the credit card details as follows (not required)
252-
253-
```php
254-
$request = $request->setPaymentMethodToCreditCard();
255-
```
256-
257-
or
258-
259-
```php
260-
$cardNumber = '1234000012340000';
261-
$name = 'John Doe';
262-
$securityCode = 123;
263-
$expirationDateMonth = 11;
264-
$expirationDateYear = 2025;
265-
266-
$request = $request->setPaymentMethodToCreditCard(
267-
$cardNumber,
268-
$name,
269-
$securityCode,
270-
$expirationDateMonth,
271-
$expirationDateYear
272-
);
273-
```
274-
275-
To use Sofort, use the following method:
276-
277-
```php
278-
$request = $request->setPaymentMethodToSofort();
279-
```
280-
281-
To use Carte Bancaire, use the following method:
282-
283-
```php
284-
$request = $request->setPaymentMethodToCarteBancaire();
285-
```
286-
287-
To use Bancontact, use the following method
288-
289-
```php
290-
$request = $request->setPaymentMethodToBancontact();
291-
```
292-
293-
These methods will throw an exception if required information is missing.
294-
295-
Once the request executes, the link to the transaction will send you to the Bluem Portal with the corresponding interface and flow.
296-
297202
## Webhooks
298203

299204
Webhooks exist for Payments, eMandates and Identity. They trigger during requests to the Bluem flow and send data to your application.

0 commit comments

Comments
 (0)