Laatst gewijzigd 18/04/2014

1. Inleiding

De Alias Manager biedt functies voor periodieke facturering (betaling van periodiek gefactureerde diensten) en andere specifieke toepassingen met kaartnummeraliassen (opslag van klantenprofielen op uw website bijvoorbeeld).

Een alias is een identificatie voor een kaartnummer en de vervaldatum van de kaart en kan gebruikt worden om andere betalingen in de toekomst aan te vragen. Deze alias wordt aan een enkele merchant gekoppeld en kan niet door een derde gebruikt worden.

Dankzij de Alias Manager voor periodieke facturering (recurring) hoeven merchants die Batch, DirectLink en/of e-Terminal gebruiken de financiële gegevens van hun klanten na de eerste betaling niet op te slaan. Merchants die e-Commerce gebruiken, hoeven nooit in contact te komen met de financiële gegevens van hun klanten of hen op te slaan. Dit beperkt de risico’s en investeringen met betrekking tot de veilige opslag van de financiële gegevens van klanten. De Alias Manager laat het gebruik van een veilig periodiek factureringssysteem toe zonder dat de merchant zijn systeem PCI-compatibel hoeft te maken.

Zelfs wanneer de Alias Manager in uw account actief is, kunt u nog altijd transacties uitvoeren zonder een alias te specificeren.

Wanneer u in de e-Commerce-modus werkt, vragen we de klant of zijn financieel profiel opgeslagen mag worden. Aangezien ons systeem in overeenstemming is met de wetgeving betreffende de persoonlijke levenssfeer, kan een kaarthouder ons weigeren om zijn financieel profiel op te slaan. In dat geval kan de merchant beslissen om de transactie af te breken als de aanmaak van een alias cruciaal is.

Deze beperking is niet van toepassing op de andere modi, waarbij de merchant zelf de financiële gegevens van de kaarthouder invoert.

Dit document beschrijft de integratie van de optie “Alias Manager" in de toepassing van de merchant (e-Commerce / DirectLink / Batch / e-Terminal). Deze optiehandleiding moet samen met de integratiehandleidingen van e-Commerce / DirectLink / Batch / e-Terminal gelezen worden.

2. Een Alias aanmaken

U kunt een alias aanmaken door een transactie uit te voeren via e-Commerce, DirectLink of Batch. Daarnaast kunt u ook handmatig (via e-Terminal) een alias aanmaken op de Alias management-pagina. 

U kunt ook geen tekenreeks van cijfers met meer dan 14 tekens beginnend met 2, 3, 4, 5 of 6 gebruiken die op een kaartnummer lijkt. Dit wordt geblokkeerd door ons syteem, omwille van het onveilige aspect om niet-geëncrypteerde kaartnummers in ons systeem op te slaan.

De mogelijkheid om met een alias te werken voor periodieke facturering en andere specifieke toepassingen, hangt af van de betaalmethodes die u wenst te gebruiken. Zie de online betalingsmethoden Processing / Procedure overzichtspagina.


Opmerkingen over PayPal en PostFinance Card:
  • Aangezien deze betaalmethoden een authenticatie van de kaarthouder vragen, is het alleen mogelijk om een alias aan te maken met gebruik van e-Commerce.
  • Het minimum bedrag voor de PostFinance Card is CHF 0.05.

2.1 e-Commerce

De procedure voor het aanmaken van een alias in de e-Commerce-modus is bijna identiek aan die van een normale e-Commerce-transactie. Het grootste technische verschil ligt in de wijzigingen die uitgevoerd moeten worden bij de controle voor de betaling.

2.1.1 Extra verborgen velden

Om een alias via e-Commerce aan te maken, moet u de volgende extra verborgen velden doorsturen:

Veld Verklaring

ALIAS

Alias voorgesteld door de merchant
ALIASUSAGE Een tekst die de reden voor de aliasregistratie opgeeft

Na het verzenden van de verborgen velden wordt de veilige betaalpagina aan de klant getoond. Daar kan hij zijn betaalmethode kiezen en zijn betalingsgegevens invoeren.

Ook de tekst die u in het ALIASUSAGE-veld hebt doorgestuurd, wordt weergegeven.

Het dialoogvenster bevat een selectievakje dat de klant kan aan- of uitvinken om zijn toestemming te geven of te weigeren voor de opslag van zijn financieel profiel.

Indien niet aangevinkt, dan kunt u als merchant het transactieproces automatisch stopzetten. Dit kunt u op de Alias Management-pagina instellen (via "Configuratie" > "Alias" in het backofficemenu).

Als de transactie op ons platform met succes verwerkt wordt (niet in status 0 of 1), dan maken wij het financieel profiel (alias) in onze aliasdatabase aan.

2.1.2 Beveiliging: SHA-handtekening (controle voor de betaling)

U moet de alias-parameters (ALIAS and ALIASUSAGE) gebruiken in de berekening van de SHA signature.

Voor meer details, ga naar e-Commerce.

2.1.3 Transactiefeedback aan de merchant

Als u na de transactie feedback-requests ontvangt, of feedbackparameters op een redirectie, dan zult u een extra parameter ontvangen: ALIAS.

Als u een SHA-OUT-handtekening voor deze feedback-requests hebt ingesteld, dan moet u de ALIAS-parameter in acht nemen voor uw handtekening.

Om tijdens een transactie via DirectLink een alias aan te maken, moet u naast de andere transactievelden ook de volgende velden doorsturen:

Veld Beschrijving
ALIAS Alias voorgesteld door de merchant
CARDNO Kaartnummer
ED Vervaldatum
CN Naam kaarthouder

Als de transactie op ons platform met succes verwerkt wordt (niet in status 0 of 1), dan maken wij het financieel profiel (alias) in onze aliasdatabase aan. 

Voor Direct Debits moet het rekeningnummer in het veld CARDNO worden meegezonden, de vervaldatum mag niet worden verzonden.

U moet de alias parameters (ALIAS and ALIASUSAGE) gebruiken in de berekening van de SHA-handtekening.

Voor meer details, ga naar e-Commerce.

Het XML antwoord op uw verzoek zal de extra parameter ALIAS bevatten.

2.3 Batch

Om tijdens een transactie via Batch een alias aan te maken, moet u naast de andere transactievelden ook de volgende velden doorsturen:

Veld
Veldnummer
ALIAS 17
CN 4
ED 5
CN 8

Als de transactie op ons platform met succes verwerkt wordt (niet in status 0 of 1), dan maken wij het financieel profiel (alias) in onze aliasdatabase aan.

2.4 Alias Manager

Aliassen kunnen handmatig in het backoffice geregistreerd worden:

  1. Ga naar "Configuratie" > "Alias" in het menu van uw account om de Alias Management-pagina te openen.
  2. Klik op de tab "Aanmaken" om een nieuwe alias te registreren.
  3. Voer de aliasnaam en de financiële gegevens in: naam kaart/rekeninghouder, kaartnummer en vervaldatum (indien van toepassing)
  4. Klik op de knop “Aanmaken”.

Let op dat deze methode alleen mogelijk is voor creditcards en Direct Debits. Het is niet mogelijk om een nieuwe allias te registreren voor PayPal en PostFinance Card.

Aangezien de alias handmatig aangemaakt wordt in plaats van via een transactie, maken wij het financieel profiel (alias) niet onmiddellijk in onze aliasdatabase aan. Wij kunnen het financieel profiel pas in onze database invoeren wanneer een transactie met de alias door de financiële instelling aanvaard is, m.a.w. nadat de betalingsgegevens officieel gecontroleerd zijn.

3. Gebruik van de Alias

De mogelijkheid om met een Alias te werken voor periodieke facturering en andere specifieke toepassingen hangt af van de betaalmethodes die u wenst te gebruiken.

3.1 e-Commerce

Om een bestaande ALIAS te gebruiken, kunnen of moeten de volgende verborgen velden meegestuurd worden in uw request:

Veld Omschrijving Verplicht
ALIAS De naam van de ALIAS die u wilt gebruiken. Wij controleren dan of de ALIAS voor uw PSPID al bestaat. J
ALIASUSAGE Stuur een waarde met dit veld enkel als u een andere tekst aan de klant wilt tonen dan degene die u initieel had gestuurd bij het aanmaken van de alias.
N
ECI ECI-waarde "9" moet gestuurd worden bij wederkerende transacties J

Als de ALIAS bestaat, dan worden de naam van de kaarthouder, het gemaskeerde creditcardnummer en de vervaldatum op de betaalpagina geïnitialiseerd.

3.1.1 Alias-update

Als de kaarthouder de vooraf ingestelde gegevens niet wijzigt en gewoon op de knop “Verzenden” klikt, dan zoeken we het financieel profiel (gebaseerd op de ALIAS) in de database op.

Indien hij bepaalde gegevens, zoals de vervaldatum, wil bijwerken, kan de kaarthouder de geïnitialiseerde velden wijzigen. Als de transactie op ons platform met succes verwerkt wordt (niet in status 0 of 1), dan zullen we de financiële gegevens van de klant bijwerken.

Voor meer informatie over de controle voor de betaling en feedback-requests na de transactie, raadpleeg Alias aanmaken via e-Commerce .

Om een bestaande ALIAS te gebruiken, moeten de volgende velden meegestuurd worden in uw request:

Veld Omschrijving
ALIAS De naam van de ALIAS die u wilt gebruiken. Wij controleren dan of de ALIAS voor uw PSPID al bestaat.
ALIASPERSISTEDAFTERUSE

Geef aan of u een alias tijdelijk of permanent wilt opslaan. De mogelijke waarden zijn:

  • "N": de alias wordt na 2 uur verwijderd
  • "Y": de alias wordt permanent opgeslagen, voor toekomstig gebruik

Als een alias wordt aangemaakt met de N-waarde en de transactie binnen twee uur wordt uitgevoerd, moet deze parameter-waardecombinatie ook zijn opgenomen in de transactie, zodat de alias wordt verwijderd. Als deze parameter-waardecombinatie niet in de transactie is opgenomen, blijft de alias behouden voor toekomstig gebruik. 

ECI ECI-waarde "9" moet gestuurd worden bij wederkerende transacties

Als de ALIAS bestaat, dan worden de naam van de kaarthouder, het gemaskeerde creditcardnummer en de vervaldatum op de betaalpagina geïnitialiseerd.

Als u ons gewoon de ALIAS doorstuurt (geen nieuw creditcardnummer, vervaldatum, naam kaarthouder), dan zoeken wij het financieel profiel (gebaseerd op de ALIAS) in de database op.

Naast de ALIAS-parameter kunt u ons ook een nieuw creditcardnummer, vervaldatum of naam van de kaarthouder doorsturen om de bestaande ALIAS bij te werken. Als de transactie op ons platform met succes verwerkt wordt (niet in status 0 of 1), dan zullen we de financiële gegevens van de klant bijwerken.

3.3 Batch

Om een bestaande ALIAS te gebruiken, moet u de volgende velden meesturen in het bestand:

Veld Omschrijving Veldnr.
ALIAS De naam van de ALIAS die u wilt gebruiken. Wij controleren dan of de ALIAS voor uw PSPID al bestaat. 17
ECI ECI-waarde "9" moet gestuurd worden bij wederkerende transacties. 35

3.3.1 Alias-update

Als u ons de ALIAS doorstuurt, dan zoeken wij het financieel profiel (gebaseerd op de ALIAS) in de database op.

Naast het ALIAS-veld kunt u ons ook een nieuw creditcardnummer, vervaldatum of naam van de kaarthouder doorsturen om de bestaande ALIAS bij te werken. Als de transactie op ons platform met succes verwerkt wordt (niet in status 0 of 1), dan zullen we de financiële gegevens van de klant bijwerken.

3.4 e-Terminal

Om een alias te gebruiken via e-Terminal volgt u deze stappen:

  1. Klik in het backofficemenu op de “Alias” link
  2. Zoek de alias die u wilt gebruiken op in de Alias Management-pagina
  3. Klik op de knop “Gebruiken”. De e-Terminal voucher wordt weergegeven met de geïnitialiseerde naam van de kaarthouder, het kaartnummer en de vervaldatum.

3.4.1 Alias-update

U kunt enkel de vervaldatum wijzigen op de voucher. De geïnitialiseerde naam van de kaarthouder en het kaartnummer kunnen niet op de voucher gewijzigd worden.

3.5 Fouten

Als bij een transactie een alias wordt verzonden, maar ons systeem de alias niet kan vinden (meestal wanneer de alias niet bestaat), worden de volgende foutcode en foutmelding geretourneerd:

Retourveld
Waarde
NCERROR
50001111 (Gegevensvalidatiefout)
NCERRORPLUS
Alias "..." not Found (niet gevonden)

4. Aliasbeheer

Klik op "Configuratie" > "Alias" in uw back-officemenu om toegang te krijgen tot uw Aliasbeheerpagina. Deze pagina bevat de volgende onderdelen:

  • Mijn aliasgegevens:
    • Status:
      • Aantal actieve aliassen (aanklikbaar om een lijst te bekomen van de betreffende aliassen)
      • Aantal aliassen met bijna verlopen creditcardgegevens (aanklikbaar om een lijst te bekomen van de betreffende aliassen)
      • Aantal aliassen die werden verwijderd in de huidige kalendermaand
      • Aantal actieve aliassen in de vorige kalendermaand
    • Algemene parameters: Hier configureert u:
      • of het opt-in/out selectievakje op de betaalpagina al dan niet is aangevinkt. De kaarthouder kan alsnog kiezen zijn kaartgegevens al dan niet te bewaren door het vakje aan/uit te vinken.
      • of een transactie moet geweigerd worden als de kaarthouder kiest om zijn gegevens niet te laten bewaren, en dus geen alias te laten aanmaken
      • de bewaartermijn: hoeveel maanden een alias moet bewaard worden (tussen 3 en 60 maanden/5 jaar). Deze periode wordt na elk gebruik geherinitialiseerd.
    • Hosted Tokenization Page: hier geeft u aan of u de op-in/out checkbox wilt weergeven op de Hosted Tokenization-pagina (optioneel).
  • Aliaslijst, voor het raadplegen en downloaden, opzoeken, gebruiken, wijzigen en verwijderen van aliassen.
  • Aanmaken, voor het manueel aanmaken van nieuwe aliassen.

5. Speciale toepassingen

Dit hoofdstuk geeft meer uitleg over specifieke, geavanceerde aliastoepassingen die een hoger niveau van integratie vereisen. Deze toepassingen zijn niet van toepassing voor periodieke (recurring) betalingen.

De mogelijkheid om met een Alias te werken voor periodieke facturering en andere specifieke toepassingen hangt af van de betaalmethodes die u wenst te gebruiken.

5.1 e-Wallet

U kunt geregistreerde klanten een e-wallet van creditcards geven zonder dat u hun financiële gegevens hoeft te beheren.

U maakt een nieuwe alias aan voor de eerste betaling van een nieuwe klant. Wanneer de klant uw website opnieuw bezoekt, kunt u de gemaskeerde kaart(en) die aan zijn alias(sen) gekoppeld zijn op de achtergrond (in uw HTML-code) weergeven. De eenvoudigste manier om de gemaskeerde kaartnummers te registreren, is hen te onttrekken uit de feedbackparameters die we u na elke transactie doorsturen (e-Commerce).

Voorbeeld van een e-wallet:

<select name=”cards”>
<option value=”alias284”>VISA – XXXXXXXXXXXX1111</option>
<option value=”alias128”>MasterCard – XXXXXXXXXXXX9999</option>
<option value=”alias389”>Use a new card</option>
</select>

Wanneer de klant (een van) zijn gemaskeerde kaart(en) op uw website selecteert, wordt de gekoppelde alias naar ons doorgestuurd in uw verborgen velden.

U kunt nog altijd de keuze “Andere kaart” aanbieden om het aanmaakproces van een nieuwe alias op te starten.

5.2 Geoptimaliseerd aliasbeheer

Wanneer u de Alias Manager met e-Commerce of DirectLink gebruikt, kunt u ook een extra veld/parameter (ALIASOPERATION) doorsturen.

Veld
Mogelijke waarden
ALIASOPERATION
Leeg (of BYMERCHANT)
BYPSP

Wanneer u een toekomstige nieuwe klant hebt, moet u een nieuwe alias aanmaken. De kaart die tijdens de transactie gebruikt zal worden, is misschien voordien al op uw website gebruikt en komt dan overeen met een al bestaande alias. ALIASOPERATION BYPSP kan gebruikt worden om de aanmaak van dubbele aliassen voor dezelfde kaart te voorkomen.

Om een nieuwe alias aan te maken kunt u het aliasveld leeg laten en ALIASOPERATION BYPSP doorsturen. Ons systeem zal dan controleren of er al een alias voor het kaartnummer bestaat en zal enkel een nieuwe alias aanmaken als dat nodig is. Als het gebruikte kaartnummer overeenstemt met een al bestaande alias, dan zal er geen nieuwe alias aangemaakt worden en zal de betaling aan de gevonden alias gekoppeld worden.

Wanneer u een aliaswaarde in het ALIAS-veld/parameter doorstuurt (d.i. een alias gebruikt) en BYPSP als ALIASOPERATION, dan controleren wij of de ontvangen financiële gegevens overeenstemmen met een bestaande alias.

Als de klant zijn creditcardgegevens tijdens de transactie gewijzigd heeft, dan zullen onze feedbackparameters/XML-response een andere alias bevatten dan die u naar ons hebt doorgestuurd. De teruggestuurde alias in de feedbackparameters/XML-response komt overeen met een al bestaande alias voor het nieuwe kaartnummer of een nieuwe alias die door ons systeem is aangemaakt.

Als uw processen aliassen vereisen die aan het OrderID gekoppeld zijn (een nieuwe alias voor elk order), dan moet de ALIASOPERATION-parameter leeg gelaten worden (of op de waarde BYMERCHANT ingesteld worden).

In de onderstaande tabel vindt u een overzicht van de mogelijkheden van beide ALIASOPERATION-waarden voor het aanmaken en gebruiken/bijwerken van uw aliassen. U kunt een andere ALIASOPERATION gebruiken om uw aliassen aan te maken en te gebruiken/bij te werken. Op die manier kunt u uw Alias Management optimaliseren naargelang uw specifieke behoeften. 

  ALIASOPERATION
 

Leeg (of BYMERCHANT)
BYPSP
Verzonden op het moment van de aanmaak van de alias
  • Merchant kiest de aliasnamen.
  • Mogelijkheid om een nieuwe alias voor elk order aan te maken.
  • Ons systeem kiest de aliasnamen..
  • Ons systeem maakt enkel een nieuwe alias aan als het kaartnummer nog niet aan een andere alias gekoppeld is..
Verzonden op het moment van het gebruik of de update van de alias
(Alias verzonden in het ALIAS-veld)
Eén alias per klant: als de klant zijn creditcardgegevens tijdens de transactie wijzigt, dan zal de alias met de nieuwe gegevens bijgewerkt worden. Eén alias per creditcard: als de klant zijn creditcardgegevens tijdens de transactie wijzigt, dan zal er een nieuwe alias aangemaakt worden.

5.2.1 Voorbeeld met "BYMERCHANT" (of leeg)

Gegevens in onze aliasdatabase:

Alias
Kaartnummer
A14352
41111…
B76985  53999…

Voorbeeld 1 :

  • Verzonden Alias : A14352
  • Gebruikte kaart : 37411…
  • Ontvangen Alias : A14352

Gegevens in onze aliasdatabase:

Alias
Kaartnummer
A14352
37411…
B76985  53999…

Voorbeeld 2 :

  • Verzonden Alias : C01203
  • Gebruikte kaart : 53999…
  • Ontvangen Alias : C01203

Gegevens in onze aliasdatabase:

Alias
Kaartnummer
A14352
41111…
B76985  53999…
C01203 53999…

5.2.2 Voorbeeld met "BYPSP"

Gegevens in onze aliasdatabase:

Alias
Kaartnummer
XXXXXXXX-CA55-4995-B4F0-C3424AB2C2BA 41111…
YYYYYYYY-CA55-4995-B4F0-C3424AB2C2BA 53999…

Voorbeeld 1:

  • Verzonden Alias: XXXXXXXX-CA55-4995-B4F0-C3424AB2C2BA
  • Gebruikte kaart: 37411…
  • Ontvangen Alias: ZZZZZZZZ-CA55-4995-B4F0-C3424AB2C2BA

Gegevens in onze aliasdatabase:

Alias
Kaartnummer
XXXXXXXX-CA55-4995-B4F0-C3424AB2C2BA
41111…
YYYYYYYY-CA55-4995-B4F0-C3424AB2C2BA  53999…
ZZZZZZZZ-CA55-4995-B4F0-C3424AB2C2BA
37411…

Er werd een nieuwe Alias aangemaakt, omdat de gebruikte kaart al in de database aanwezig was en de verzonden Alias al aan een ander kaartnummer gekoppeld was. In het geval van "ALIASOPERATION: leeg (of BYMERCHANT)" zou de bestaande Alias met het verzonden kaartnummer bijgewerkt worden. 

Voorbeeld 2:
  • Verzonden Alias: ledig
  • Gebruikte kaart: 53999…
  • Ontvangen Alias: YYYYYYYY-CA55-4995-B4F0-C3424AB2C2BA

Gegevens in onze aliasdatabase:

Alias
Kaartnummer
XXXXXXXX-CA55-4995-B4F0-C3424AB2C2BA
41111…
YYYYYYYY-CA55-4995-B4F0-C3424AB2C2BA 53999…
ZZZZZZZZ-CA55-4995-B4F0-C3424AB2C2BA
37411…

Omdat de gebruikte kaart al aan een bestaande Alias gekoppeld was, werd de verzonden Alias niet aangemaakt en werd de bestaande Alias gebruikt.

In het geval van "ALIASOPERATION: leeg (of BYMERCHANT)" zou de nieuwe Alias met het verzonden kaartnummer aangemaakt worden, waardoor de database twee aliassen met hetzelfde kaartnummer zou bevatten.

Voorbeeld 3:
  • Verzonden Alias: ZZZZZZZZ-CA55-4995-B4F0-C3424AB2C2BA
  • Gebruikte kaart: 53999…
  • Ontvangen Alias: YYYYYYYY-CA55-4995-B4F0-C3424AB2C2BA

Gegevens in onze aliasdatabase:

Alias
Kaartnummer
XXXXXXXX-CA55-4995-B4F0-C3424AB2C2BA
41111…
YYYYYYYY-CA55-4995-B4F0-C3424AB2C2BA 53999…
ZZZZZZZZ-CA55-4995-B4F0-C3424AB2C2BA
37411…

Omdat de gebruikte kaart al aan een (andere) bestaande Alias gekoppeld was en de verzonden Alias al bestond, werd de Alias gebruikt die met het kaartnummer overeenstemt.

In het geval van "ALIASOPERATION: leeg (of BYMERCHANT)" zou de bestaande Alias met het verzonden kaartnummer bijgewerkt worden, waardoor de database twee aliassen met hetzelfde kaartnummer zou bevatten.

6. Appendix: Bulk Alias-aanmaak via Batch

6.1 Overzicht

Het doel van Bulk Alias-aanmaak via Batch is om meerdere aliassen in een keer aan te maken, zonder transacties uit te voeren. De merchant dient de batchbestanden in "BYMERCHANT"-modus te verstrekken, inclusief de Alias ID.

De batchbestanden kunnen zowel manueel als automatisch worden geüpload, via een http-request op het Ingenico ePayments platform. Dit kan synchroon of asynchroon gedaan worden, hoewel we aanraden om de bestanden asynchroon te behandelen indien deze meer dan 100 records bevatten.

Op deze manier worden er geen transacties uitgevoerd.

Een format check zorgt ervoor dat de creditcard- of rekeningnummers correct zijn, zonder dat een autorisatie wordt uitgevoerd. Dit heeft als gevolg dat er geen zekerheid is of de kaart/rekening nog geldig is.

Als de vervaldatum van een creditcard in het verleden ligt, voegt ons systeem twee jaar toe, tot de datum in de toekomst ligt. Dit is een standaard proces bij het aanmaken van een alias.
De merchant kan zijn bestanden voor aliasaanmaak op twee verschillende manieren uploaden:

  1. Handmatig: de merchant upload de bestanden manueel in zijn back-office (zie Basic Batch).
  2. Automatisch: de merchant voert de upload requests met een eigen applicatie uit via https, op specifieke pagina's op ons systeem (zie Advanced Batch).

Voor meer informatie, ga naar Advanced Batch voor request URL en specifieke parameters.

6.2 Aanmaak

Het bestand met het verzoek moet een ASCII tekstbestand zijn en mag slechts een lijn per alias bevatten. De velden dienen te worden gescheiden met een puntkomma (";") en de waarden zelf mogen geen puntkomma bevatten.

Formaat: AN= Alfanumeriek / N=Numeriek, maximum aantal aanvaarde tekens
  Veld
Formaat
Voorbeeld
1
OPERATION
AN, 8
ADDALIAS
2
ALIAS
AN, 50
Customer123
3
CN
AN, 35
John Doe
4
CARDNO
AN, 21
XXXXXXXXXXXX1111
5
EXPDATE
MMYY 1012
6
BRAND
AN, 25
VISA
7
PSPID
AN, 30
JDoeSHOP

Voorbeeld met creditcard:

ADDALIAS;Customer123;John Doe;XXXXXXXXXXXX1111;1015;VISA;JDoeSHOP;

Voorbeeld met Direct Debits:

ADDALIAS;Customer123;John Doe;XXXXXXXXXXXX1111;1015;VISA;JDoeSHOP;

6.3 Verwijderen

Het bestand met het verzoek moet een ASCII tekstbestand zijn en mag slechts een lijn per alias bevatten. De velden dienen te worden gescheiden met een puntkomma (";") en de waarden zelf mogen geen puntkomma bevatten. 

Formaat: AN= Alfanumeriek / N=Numeriek, maximum aantal aanvaarde tekens

Veld
Formaat
Voorbeeld
1
OPERATION
A, 8
DELALIAS
2 ALIAS AN, 50 Customer123

 

Voorbeeld: DELALIAS;Customer123;;;;;; (alle puntkomma's aan het eind moeten toegevoegd worden!)

Automatische file upload:

Om de verwijdering van een alias tot stand te brengen is een bestand met het volgende formaat nodig:

OHL;PSPID;API PASSWORD;;USER API;
DELALIAS;ALIAS VALUE;;;;;;
DELALIAS;ALIAS VALUE;;;;;;
OTF;

Wij raden aan om ‘checkandprocess’ (controleren en verwerken) te gebruiken en alleen aliassen van dezelfde PSPID te vermelden.

Voor meer informatie over de verschillende automatische upload processen, ga naar Advanced Batch.

7. Het maken en gebruiken van aliassen binnen de COF-richtlijn (Credential-on-File)

7.1 Overzicht

Met de introductie van de COF-richtlijn (Credential-on-File) door de belangrijkste betalingssystemen Visa / Mastercard, zullen er enige wijzigingen nodig zijn voor het proces waarmee aliassen worden gemaakt en gebruikt.

Er kan bij COF-transacties een onderscheid worden gemaakt tussen door de kaarthouder gestarte transacties (cardholder-initiated transaction, ofwel CIT) en door de handelaar gestarte transacties (merchant-initiated transaction, ofwel MIT).

Aangezien een CIT door de kaarthouder wordt gestart, kan elk hiervan 3DS-identificatie activeren. Indien een CIT de eerste transactie is in een transactiecyclus (m.a.w. voor een abonnement), is 3DS verplicht.

Aangezien een MIT door de handelaar wordt gestart, zal deze geen 3DS activeren, aangezien een MIT (m.a.w. een reguliere betaling voor een abonnement) over het algemeen wordt voorafgegaan door een CIT met 3DS. De handelaar moet aanvullende informatie naar Ingenico ePayments sturen om te garanderen dat een dergelijke transactie met succes wordt verwerkt. Hiervoor moeten de volgende COF-parameters worden verzonden om de context van de transactie (eerste of volgende) en/of use cases (abonnement, ongepland, etc...) te specificeren:

Veld

 Waarden

Beschrijving

COF_INITIATOR* CIT Een transactie uitgevoerd door een kaarthouder
  MIT Een transactie uitgevoerd door een merchant
COF_SCHEDULE*
SCHED Een geplande transactie
  UNSCHED Een ongeplande transactie
COF_TRANSACTION*
FIRST De eerste van een reeks transacties

SUBSEQ

Opeenvolgende reeks transacties

COF_RECURRING_EXPIRY* Datum JJJJMMDD (bijv. 20190914)
Momenteel enkel beschikbaar in de testomgeving.
Einddatum: datum van de laatste geplande betaling van een reeks
COF_RECURRING_FREQUENCY*
numeriek tussen 2 en 4 karakters (bijv. 31, 031 of 0031)
Momenteel enkel beschikbaar in de testomgeving.
Dagen tussen betalingen voor een geplande reeks
* Wij verzoeken u om de parameterwaardes te sturen volgens het formaat dat wordt aangegeven in de tabel. Anders zal de transactie geblokkeerd worden door ons systeem.

Voor de volgende scenario's (CIT / MIT / Alias maken / gebruiken) zijn de volgende waarden van toepassing:

Parameterwaarden

Omschrijving

CIT-FIRST-UNSCHED
Van toepassing wanneer er een alias gebruikt of aangemaakt wordt
CIT-FIRST-SCHED

Van toepassing op een eerste geplande betaling/abonnement

MIT-SUBSEQ-UNSCHED Van toepassing op terugkerende betalingen
MIT-SUBSEQ-SCHED Van toepassing op afbetalingen

7.2 Alias maken / gebruiken via eCommerce

Alhoewel het gebruik van COF-parameters voor het maken/gebruiken van aliassen sterk wordt aanbevolen, bieden we onze handelaren nog steeds de mogelijkheid bij de gevestigde procedures te blijven door alleen op de parameters ALIAS/ALIASUSAGE te vertrouwen. Dit vormt echter een aanzienlijke beperking op de mogelijkheid de gemaakte Aliassen te hergebruiken en is alleen beschikbaar in de eCommerce-integratiemodus.

Tijdens het maken van een Alias zal Ingenico ePayments de transactie op de achtergrond als CIT markeren. Als gevolg daarvan kan de gemaakte Alias alleen worden gebruikt in volgende CIT's (m.a.w. de kaarthouder bezoekt de webshop van de handelaar opnieuw voor een andere aankoop, zonder opnieuw zijn of haar creditcardgegevens in te voeren). Dezelfde Alias kan daarom niet voor MIT worden gebruikt.

Het verzenden van de eerder genoemde COF-parameters tijdens het maken / gebruiken van Aliassen zal tot een flexibelere bruikbaarheid van Aliassen leiden. Dit stelt de handelaar ertoe in staat een tijdens CIT gemaakte Alias te hergebruiken in een volgende MIT.

In tegenstelling tot eCommerce zal het verzenden van de COF-parameters in elk scenario verplicht zijn.
Ingenico ePayments, de wereldleider in diensten voor digitale betalingen, zet complexe betaaltransacties om tot vlotte en geïntegreerde betaaloplossingen op alle verkoopkanalen: online, in de winkel en mobiel. Met ons innoverende aanbod aan multichannel-betaaldiensten, van transactieaanvaarding tot transactiebetaling, en van marketing tot klantenbinding, helpen wij de ondernemers om hun betalingen te beheren, te groeperen en te beveiligen, om fraude te voorkomen en om hun verkopen te stimuleren dankzij betere conversieverhoudingen. Ingenico ePayments is een merk van de groep Ingenico, de wereldleider in geïntegreerde betaaloplossingen.

Deze website maakt gebruik van cookies om u de beste gebruikerservaring te kunnen geven. Als u deze cookies niet wilt accepteren, laten wij u toe om de cookie-instellingen te wijzigen. Klik op 'Aanvaarden' om alle cookies van deze website toe te staan. 

Cookie settings

Introductie

Functioneel

Functionele cookies zijn nodig om de website correct te laten werken. Die cookies kunnen niet worden uitgeschakeld.

Geoptimaliseerd

Met optimalisatiecookies kunnen we het gebruik van de website analyseren, zodat we deze kunnen meten en verbeteren.
Dit is het standaard niveau.

Gepersonaliseerd

Personalisatiecookies worden gebruikt voor sociale media en geavanceerde personalisatie. Hiermee kunnen we u informatie laten zien die betrekking heeft op uw bedrijf.


Voorbeelden van ondersteunde functionaliteit

  • Landvoorkeur opslaan
  • Taalvoorkeur opslaan

Voorbeelden van niet-toegestane functionaliteit

  • Persoonlijke informatie over uw bezoek opslaan
  • Anonieme tracering via Google Analytics
  • Tracering voor marketingdoeleinden

Voorbeelden van ondersteunde functionaliteit

  • Landvoorkeur opslaan
  • Taalvoorkeur opslaan
  • Anonieme tracering via Google Analytics

Voorbeelden van niet-toegestane functionaliteit

  • Persoonlijke informatie over uw bezoek opslaan
  • Tracering voor marketingdoeleinden

Voorbeelden van ondersteunde functionaliteit

  • Landvoorkeur opslaan
  • Taalvoorkeur opslaan
  • Anonieme tracering via Google Analytics
  • Inhoud weergeven die aansluit op uw interesses
  • Advertenties weergeven die aansluiten op uw interesses
  • Tracering voor marketingdoeleinden

Voorbeelden van niet-toegestane functionaliteit

  • Persoonlijke gegevens opslaan