Afin de simplifier le lien entre le customer et le marchand lorsque ce premier souhaite déposer des fonds via virement, nous avons mis en place le "Virtual Iban". Il n'y aura avec celui-ci plus besoin d'utiliser de référence sur les virements, chaque customer aura un vitual iban spécifique. Vous pourrez trouver celui-ci à 4 endroits :
Il est possible de génerer un virtual iban sur un customer, soit à la création, soit à l'update si dèjà créé
Ici nous allons le faire a la création mais le process est le meme pour l'update, voici le code curl, on passe ici le walletId du marchand :
curl -v -X POST 'https://test-api.centralpay.net/v2/rest/customer' \
-u 'doctest:4I9HJRTd' \
-d 'firstName=Carla' \
-d 'lastName=Mauru' \
-d 'addressLine1=17 rue de la poste' \
-d 'postalCode=37000' \
-d 'city=Tours' \
-d 'country=FR' \
-d 'email=carlamauru@gmail.com' \
-d 'cardTokenId=e03de50d-e864-43c4-8da5-95dfd28e2e8a' \
-d 'walletIdForIban=9b7f18d8-734f-4c72-8792-aea2ecdbdbaa'
{
"customerId": "55e7e32b-63b6-45b3-8a02-e91e185487c0",
"creationDate": "2023-03-17T10:22:10.215653+01:00",
"merchantCustomerId": null,
"firstName": "CARLA",
"lastName": "MAURU",
"email": "carlamauru@gmail.com",
"phone": null,
"addressLine1": "17 RUE DE LA POSTE",
"addressLine2": null,
"addressLine3": null,
"addressLine4": null,
"postalCode": "37000",
"city": "TOURS",
"country": "FRA",
"cards": [
{
"cardId": "dfa96807-7b0e-4386-b323-c99aea82456e",
"creationDate": "2023-03-17T10:21:55.538519+01:00",
"customerId": "55e7e32b-63b6-45b3-8a02-e91e185487c0",
"cardTokenId": "e61bc62c-4cc6-45d5-bf31-78ff6e4ffabd",
"infoId": null,
"merchantCardId": null,
"commercialBrand": "VISA",
"first6": "400000",
"last4": "0010",
"expirationMonth": 12,
"expirationYear": 2023,
"country": null,
"cardholderName": "D DEGEAI",
"cardholderEmail": "ddegeai@centralpay.eu",
"description": null,
"fingerprint": "b31d96aaa14cf7436c4ad6d4b95a1e15c7de7cb3",
"cardType": null,
"region": null,
"productType": null,
"europeanEconomicArea": null,
"check": false,
"additionalData": {}
}
],
"description": null,
"language": null,
"otpExpired": false,
"subscriptions": [],
"installmentPayments": [],
"fee": 0,
"totalCharge": 0,
"bankAccounts": [
{
"iban": "FR7699999000017163979804706",
"bic": "CEAYFR22"
}
],
"metaData": null,
"preferredCardId": null,
"cardMerchants": [],
"movementId": "1b4ca6a8-ce9a-4ed0-a68a-ac51c722c368",
"otpExpirationDate": null,
"additionalData": {}
}
Cette réponse est renvoyée quand le customer a bien été créé avec un virtual IBAN
Il est possible de trouver un virtual iban sur un marchand via le backoffice :
Lorsque vous allez appelez le service /sctTransaction vous allez pouvoir passer en paramètre l'ibanWalletId lié au wallet ID du marchand où l'argent va aller.
Exemple de code Curl :
curl -v -X POST 'https://test-api.centralpay.net/v2/rest/sctTransaction' \
-u 'doctest:4I9HJRTd' \
-d 'amount=100' \
-d 'currency=EUR' \
-d 'walletIdForIban=9b7f18d8-734f-4c72-8792-aea2ecdbdbaa'
{
"sctTransactionId": "61f08e17-ddbe-4b8a-95bd-7a9580bb3a29",
"creationDate": "2023-03-17T11:17:23.615075+01:00",
"receiptDate": null,
"cancellationDate": null,
"pointOfSaleId": "0ce87724-882c-443d-ad07-2afef674d1d7",
"customerId": null,
"destinationBankAccountId": "ae909782-18d2-42dc-b9b7-9e3c38dac167",
"merchantSctTransactionId": null,
"status": "PENDING",
"iban": "FR7612548029980000000150086",
"bic": "AXABFRPP",
"bankAccount": {
"iban": "FR7612548029980000000150086",
"bic": "AXABFRPP"
},
"sepaReference": "1UUKWHOA820DOH9",
"description": null,
"currency": "EUR",
"amount": 100,
"transferGroup": null,
"payoutCurrency": "EUR",
"payoutAmount": null,
"commission": null,
"fee": null,
"processed": null,
"processedDate": null,
"order": {
"firstName": null,
"lastName": null,
"addressLine1": null,
"addressLine2": null,
"addressLine3": null,
"addressLine4": null,
"postalCode": null,
"city": null,
"country": null,
"email": null,
"phone": null,
"cardCountry": null,
"cardholderName": null,
"cardholderEmail": null
},
"transactionTransfers": [],
"movementId": null,
"cancelMovementId": null,
"paymentRequestBreakdownId": null,
"paymentRequestId": null,
"additionalData": {}
}
Cette réponse est renvoyée quand le SCT Transaction a bien été effectué avec un virtual IBAN
Vous pourrez trouver un virtual iban sur une demande de paiement de type virement :
