| Table of Contents |
|---|
| Tip |
|---|
FLOA is enabled on the test MID BNP_DEMO_AXEPTA, the technical data (HMAC, Blowfish) is available in the Test Environment section. |
Floa Test Data
MerchandID and MerchantSiteID
MerchandID
| Info | ||
|---|---|---|
| ||
MerchantIdext : 38 Montant minimum d'une commande de test : 100€ |
MerchantSiteID List
Country | Payment method | MerchantSiteID | Capture Method |
|---|---|---|---|
| France | 3X | 7369 | Automatic |
| France | 3X | 7240 | Manual |
| France | 4X | 7017 | Automatic |
| France | 4X | 7235 | Manual |
| France | 1XD | 7377 | Automatic |
| France | 3XD | 7378 | Automatic |
| France | 10X | 7286 | Automatic |
| Spain | 3X | 7936 | Automatic |
| Spain | 3X | 71085 | Manual |
| Spain | 4X | 7594 | Automatic |
| Spain | 4X | 71086 | Manual |
| Spain | 1XD | 7929 | Automatic |
| Italy | 3X | 7934 | Automatic |
| Italy | 3X | 71089 | Manual |
| Italy | 4X | 7937 | Automatic |
| Italy | 4X | 71082 | Manual |
| Italy | 1XD | 71122 | Automatic |
| Portugal | 4X | 7938 | Automatic |
| Portugal | 4X | 71088 | Manual |
| Portugal | 1XD | 70838 | Automatic |
| Belgium | 3X | 70719 | Automatic |
| Belgium | 1XD | 7930 | Automatic |
Country specific Data
| AXEPTA API parameters | Belgium | Spain | Italy | Portugal |
|---|---|---|---|---|
| Language | nl-BE en-BE | es-ES | it-IT | pt-PT |
| AddrCountryCode | BE | ES | IT | PT |
| PersonID | NA | 40919740A | RSSMRA74D22A001Q | 999999999 |
Payment request creation
| Info |
|---|
Objective:Makea3Xpayment request with automaticcapture |
HMAC Calculation
The HMAC valueisobtainedbyencryptingthestringPayID*TransID*MerchantID*Status*Codewithyourstore'sHMACkey.
Exemple with BNP_DEMO_AXEPTA
- PayID*TransID*MerchantID*Amount*Currency → *TID-603512401222998545*BNP_DEMO_AXEPTA*20000*EUR
- HMAC value → 5D32E54BC3628698E59B7A9830617AD9135AD3FAAC24FDC2D2ED6F554C40C719
The DATA field and Len value
The DATA field is obtained in 2 steps:
- Creating a character string containing all the parameters necessary to create the FLOA payment
- Encrypting this character string with the Blowfish key
The Len field is the size of the DATA field.
1) Creating the character string for a 'standard' FLOA payment request
All the parameters needed to create a standard FLOA payment request are available in the FLOA Pay Direct Integration section.
You will find below a FLOA Sandbox Payment request
| Code Block |
|---|
TransID=TID-603512401222998545 &MerchantID=BNP_DEMO_AXEPTA &RefNr=AEEZA92 &Amount=20000 &Currency=EUR &URLSuccess=https://www.paytest.org/ct-test-1/success.php&URLFailure=https://www.paytest.org/ct-test-1/failure.php &URLNotify=https://www.paytest.org/ct-test-1/notify.php &TermURL=https://www.paytest.org/ct-test-1/term.php &Response=encrypt &Response=encrypt &MerchantIDExt=38 &PayType=7369 &CustomerID=ID_User_1234567 &FirstName=John &LastName=Doe &MobileNr=0607080910 &Email=john.doe@mail.com &AddrStreet=rue du marche &AddrZIP=75001 &AddrCity=PARIS &AddrCountryCode=FR &Date=25/10/2022 &FirstOrderDate=05/07/2022 &LastOrderDate=25/10/2022 &Channel=DESKTOP &DeliveryChannel=STD &NumberArticles=3 &Homepage=https://axepta.bnpparibas/&URLBack=https://axepta.bnpparibas/ &ProductDetails=ewogICAgImNhdGVnb3JpZTEiOiAiQ2F0ZWdvcmllIDEgZGUgcHJvZHVpdCIsCiAgICAiY2F0ZWdvcmllMiI6ICJDYXRlZ29yaWUgMiBkZSBwcm9kdWl0IiwKICAgICJjYXRlZ29yaWUzIjogIkNhdGVnb3JpZSAzIGRlIHByb2R1aXQiCn0= &MAC=5d32e54bc3628698e59b7a9830617ad9135ad3faac24fdc2d2ed6f554c40c719 |
You will find below an example of a FLOA request in "copy/paste" format.
| Code Block | ||
|---|---|---|
| ||
TransID=TID-603512401222998545&MerchantID=BNP_DEMO_AXEPTA&RefNr=AEEZA92&Amount=20000&Currency=EUR&URLSuccess=https://www.paytest.org/ct-test-1/success.php&URLFailure=https://www.paytest.org/ct-test-1/failure.php&URLNotify=https://www.paytest.org/ct-test-1/notify.php&TermURL=https://www.paytest.org/ct-test-1/term.php&Response=encrypt&MerchantIDExt=38&PayType=7369&CustomerID=ID_User_1234567&FirstName=John&LastName=Doe&MobileNr=0607080910&Email=john.doe@mail.com&AddrStreet=rue du marche&AddrZIP=75001&AddrCity=PARIS&AddrCountryCode=FR&Date=25/10/2022&FirstOrderDate=05/07/2022&LastOrderDate=25/10/2022&Channel=DESKTOP&DeliveryChannel=STD&NumberArticles=3&Homepage=https://axepta.bnpparibas/&URLBack=https://axepta.bnpparibas/&ProductDetails=ewogICAgImNhdGVnb3JpZTEiOiAiQ2F0ZWdvcmllIDEgZGUgcHJvZHVpdCIsCiAgICAiY2F0ZWdvcmllMiI6ICJDYXRlZ29yaWUgMiBkZSBwcm9kdWl0IiwKICAgICJjYXRlZ29yaWUzIjogIkNhdGVnb3JpZSAzIGRlIHByb2R1aXQiCn0= &MAC=5d32e54bc3628698e59b7a9830617ad9135ad3faac24fdc2d2ed6f554c40c719 |
| Tip |
|---|
Please check that the TransID, RefNr, and CustomerID fields are unique before initiating a new payment and that the MerchantID field matches with your online store. |
2) Data end Len creation field
Encrypting the string with BNP_DEMO_AXEPTA Blowfish key we got the following value :
| Code Block |
|---|
DATA=43ad07f58ff6a5f9ebbdd42e361d2c85ce4ad41fcd63c69781d7318aad096f4d7699c0ce131681d934289cb04e179b8e64ea10ed7fcfcd7327cea3cc11c6705870841f76dfec778fc6632d6c88f6d35c0ccdbd1cce4a57871c3d5119afca2d8ad01763bde51dc74f66611cbdb9ca85242ec1c384b76f2a008b3b4ad0833cad089ef4e31033648b1e097cfeb70b6bb957f0ba07be2136990fd7066a61c5087eb76762c0f3982d4cf06ac9ea17c91ba2849ef4e31033648b1e097cfeb70b6bb957798f8be4b0424244d4778f5b020fca86d9f205ba9a2d693c5ab090f6b6860d4543ad07f58ff6a5f9ebbdd42e361d2c85ce4ad41fcd63c6977ee5f4ae41f7b7e6a83be998660fd992ad33abac5d6306a9e735dfdeaaeaf55ba9103c629c0e5d7f098a6e0d9f666b277b3a3263030fe6db25725982025547b6fd5225cd8b9f469ececff7b237caca34a8860867fba90d6d286fa3a9f585e114ecffac02fa6f76f16e3c8a0500b497eecfb388b02392b5f714201292e5be819c19060dc6f169368ceb0951b77fbc24214fdd207ad9889931eeee8152be538ec64b25cb7fba0373cdcfb388b02392b5f714201292e5be819c19060dc6f169368ceb0951b77fbc24218aa0d4eefec3d7227e5e5011b3dac317553ebf1fe5a3e78a0ccdbd1cce4a5787f41ca8e0820555969522e875be787e1bb103c689b929ab97ffe9ed068ca81f514980ce343015a805a3bc64670b56d42743ad07f58ff6a5f91fda96696989d8d5121f050256c279b95217d10b78c0c6613408bf38a991833b168765edc9cebd7b3eee627be88f9d70cb1b630ac4b67791c3221dd71cf614db94c37420cc2a1e7ce9207eaa70781f748c0aff7f84bc02f003629c7f90a295d3adfd5fa0fadb444305c2f49a15986407cbe394943e7f190fa5d02ed1704a08a210c8471c611df07f678407aca21170fd671e3d5a3b047d6d54fc77219c2f4feac48db213405e337dfd80c325a44e8d4dca7ef636d6d06b929b769ce6bc6bc5c07d5b326d0ee6239627aa4a5299e99ba5036d2f807a3588e92d0c8f438134657067f0e8c1cc19875874d0f1528fd562b4ec312bf1ebeaca9679b1a824cdfe0c6e4b212497632c9c31a1aacd74323105aa4ce48cfd56ac0ecda42a2fa29a3554d00cb4f994878a0a0d80879a6bb2c775dd773b39b386eefa975d28d3668c13dd15e9150fac37309c0360703fd966a5046cc491604de6118a52b76b5248454ddd286f2a8b24b0fe371eccbda6ccb4fc253b255c06e0df990fdd94f4313ec2b94142dea706dc2f1957df00d0beb0d3b527a0657581ca09feffc0fb430b29241637212780f7be6eb8ab026e4bcd39ab0a15d47e30f0f31300242566b91813b36a7ee2e904ee61991333fd40388c0fcde0806ab017fdb40b3381867e30f0f313002425247e10ea390b4a19d682c49870005066cdd86d16355aa6e46870b68bd7d7faec2d597814b868753e2dc625646022d6b8d682c49870005066771a6a544ace53ef79f47397fdb37b8ec213d54cf06585137b5bfce7b59fdee583f8943a1ef51691e72c246ba4046569a550051007a798db6c01f3f2786e33c05272bacc84b3ba1363a3823aac673d4322492fb0efc298ba956760eea2cc913a492fb5c5c3afb0e012a42f533f954eeb4ba7f15fe830e9ec522dc803bd2fd9c9f517b2c4fdf0d969dcf3c7b153e7205e134253b94352700998e6a1d34ce01f120461c3f1ff461ff6104b31a46c28cc244d322c043254729f3f32e2b09ce531864e6737ee016d7869&Len=1270 |
3) Finalize the request
A request sent to the platform contains three basic parameters: MerchantID, Len, and Data.
The MerchantID and Len parameters are not encrypted, only the Data parameter is encrypted with the Blowfish key, such as : MerchantID=YourMerchantID&Len=67&Data=0A67FE96a65d384350F50FF1
These items are added to the FLOA endpoint as follows:
| Code Block |
|---|
https://paymentpage.axepta.bnpparibas/floapay.aspx?MerchantID=YourMerchantID&Len=67&Data=0A67FE96a65d384350F50FF1 |
Example with BNP_DEMO_AXEPTA
Make a Payment
| Card Type | Card Number | Expiration date | CVV | Fonction |
|---|---|---|---|---|
| Card OK | 5017679110380400 | Always greater than today's date | 000 | Simulates the behavior of a valid payment |
| Card KO | 5017679100900712 | Always greater than today's date | 000 | Simulates the behavior of an invalid payment |