1. Home
2. Integratie- oplossingen
3. Terugkerende betalingen
4. Alias Manager
5. Alias Manager

1. Introductie

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.

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.

2.2 DirectLink

2.2.1 Aanvullende verzoekparameters

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.

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

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

Voor meer details, ga naar e-Commerce.

2.2.3 Transactieantwoord

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”.

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
ALIAS	De naam van de ALIAS die u wilt gebruiken. Wij controleren dan of de ALIAS voor uw PSPID al bestaat. Verplicht
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. Optioneel
ECI	ECI-waarde "9" moet gestuurd worden bij wederkerende transacties Verplicht

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 .

3.2 DirectLink

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.

3.2.1 Alias-update

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.
• 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.

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 Paypage 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.

# / 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.

#/ 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 Paypage 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)	Einddatum: datum van de laatste geplande betaling van een reeks
COF_RECURRING_FREQUENCY*	numeriek tussen 2 en 4 karakters (bijv. 31, 031 of 0031)	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.

7.3 Alias maken / gebruiken via DirectLink / Batch

In tegenstelling tot eCommerce zal het verzenden van de COF-parameters in elk scenario verplicht zijn.