Hoe kunnen gegevens worden gemigreerd met behulp van de PayPal Credit Card Vault-tool?

Gebruik de PayPal Credit Card Vault om gevoelige klantgegevens, zoals creditcardgegevens, te importeren of exporteren van of naar een betalingsgateway met behoud van PCI-naleving.

Legenda

  • Admin - De PayPal-accountmanager of integratietechnicus.
  • Handelaar - De handelaar die de bestaande profielgegevens van consumenten wil overdragen naar en van PayPal.
  • Betalingsverwerker - De externe betalingsverwerker waarnaar de consumentenprofielgegevens van de webwinkel momenteel worden of moeten worden gemigreerd.
  • PayPal - De nieuwe of huidige betalingsverwerker van de handelaar.
  • Importrapport - Het handelaarsrapport dat de identiteit van de consument en het nieuwe betalingstoken bevat dat is gegenereerd als onderdeel van het migratieproces.
  • Exportrapport - Het handelaarsrapport dat de kaartgegevens bevat als onderdeel van het exportmigratieproces.

Screeningprocedure

De webwinkel moet contact opnemen met het verkoopteam om het migratieproces te starten. De webwinkel moet ons doorlichtingsproces ondergaan (beoordeling van het bedrijfsmodel, risico en naleving). Er wordt een toegewijde technische integratiespecialist (bijvoorbeeld een integratie-engineer) aan elke handelaar toegewezen zodra dit proces is voltooid.

Let op: Het verkrijgen van Risk-goedkeuring is een verplicht proces. De webwinkel wordt geadviseerd het migratieproces niet te starten zonder zijn bedrijfsmodel door te lichten en de nodige goedkeuring te krijgen.

Kosten

Geen

Tijdsperiode

1 - 2 weken.

Proces voor het importeren van gegevens

Opmerking:

  • We vereisen dat alle bestanden worden versleuteld met onze openbare PGP-sleutel voordat ze naar ons worden verzonden.
  • We accepteren alleen bestanden in versleutelde CSV-indeling (.csv.gpg).
  • We accepteren alleen versleutelde creditcardbestanden van PCI-conforme SFTP-servers.

De gemakkelijkste manier voor ons om je gegevens van een betalingsverwerker te importeren is dat je met hen samenwerkt om ons een versleuteld CSV-bestand te bezorgen dat minimaal de volgende velden bevat:

  • Klantreferentie: Een uniek nummer om de consument te identificeren.
  • Voornaam: Voornaam consument.
  • Tweede voornaam Tweede naam van de consument (optioneel).
  • Achternaam: Achternaam van de consument.
  • E-mailadres: E-mailadres van de consument.
  • Kaart-ID: Een uniek nummer om de creditcard te identificeren in het geval er meerdere kaarten voor één consument zijn.
  • Creditcardnummer Volledig creditcardnummer.
  • Vervaldatum maand: Tweecijferige maandnotatie (MM).
  • Vervaldatum jaar: Jaarnotatie van twee cijfers (YY).
  • Adres straat1: Straat van het factuuradres van de consument.
  • Adres straat2: Straat 2 van het factuuradres van de consument (optioneel).
  • Adres plaats: Factuuradres van de consument: stad.
  • Staat van het adres: Staat van het factuuradres van de klant met twee cijfers.
  • Postcode adres: Postcode van het factuuradres van de consument.
  • Landcode Geldige landcode (2-cijferig of 3-cijferig).

Aanvullende velden vereist voor Terugkerende Facturering:

  • Profielnaam: Een geldige profielnaam.
  • AMT: Het te factureren bedrag in dollars (gebruik 34.00, niet 34 en 1199.95, niet 1,199.95).
  • Begin De begindatum voor de terugkerende factureringscyclus (gebruik de datum van morgen of een datum in de toekomst).
  • Looptijd: Het aantal betalingen dat gedurende de looptijd van de overeenkomst moet worden gedaan (gebruik 0 als betalingen moeten doorgaan totdat het profiel wordt gedeactiveerd).
  • Betaalperiode: Hoe vaak de betaling plaatsvindt, bijv. DAYS, WEEK, BIWK, SMMO, FRWK, MONT, QTER, SMYR, YEAR (gebruik met het veld Frequentie).
  • Frequentie: Als de betalingsperiode = DAYS en de frequentie = 100, wordt er eens per 100 dagen een betaling geïnd.
  • Max. mislukte betalingen: Betalingsperiodes waarvoor de transactie kan mislukken voordat een profiel wordt geannuleerd (optioneel).
  • Aantal dagen voor nieuwe poging: Het aantal opeenvolgende dagen dat een mislukte transactie opnieuw moet worden geprobeerd totdat deze is goedgekeurd (optioneel).
  • Bedrijfsnaam: De bedrijfsnaam die aan dit profiel is gekoppeld (optioneel).

Opmerking: De eerste regel van het CSV-bestand moet de koptekst zijn.

Voorbeelden

Voorbeeld-CSV-bestand met creditcardgegevens voor het importproces van creditcardgegevens:

#customer_id,first_name,middle_name,last_name,email,card_id,acct,exp_month,exp_year,street1,street2,city,state,zip code,country
1,Kevin,Silvia,James,[email protected],125212,4916100304079232,01,20,'1 Main St','Bldg A','San Jose',CA,95131,US


Voorbeeld-CSV-bestand met creditcardgegevens voor het importproces van terugkerende creditcardprofielen:

#customer_id,first_name,middle_name,last_name,email,card_id,acct,exp_month,exp_year,street1,street2,city,state,zip code,country,profile_name,amount,start,pay_period,frequency,term,max_fail_payments,retry_num_days,company_name
1,Kevin,Silvia,James,[email protected],125212,4916100304079232,01,20,'1 Main St','Bldg A','San Jose',CA,95131,US,'magazine subscription',122.30,09092018,WEEK,52,0,2,2,'ABC Ltd.'


Opmerking: Deze voorbeelden dekken niet elk type import. Als u van deze standaardaanpak wilt afwijken, neem dan contact op met de speciale technische integratiebron om uw opties te bespreken. Zodra de import is voltooid, verstrekken we een rapport met de klant-ID's, kaart-ID's en nieuwe betalingstokens die we in de gateway hebben gemaakt. We vragen je om niet meer dan twee imports uit te voeren: één initiële import van klantgegevens en een tweede import van de wijzigingen tijdens de overgang van je verwerking. We importeren gegevens van maandag tot en met vrijdag, 10:00 tot 16:00 PST (VS), met uitzondering van feestdagen.

Proces voor gegevensportabiliteit

  • De webwinkel moet het e-mailadres van de contactpersoon van de betalingsverwerker opgeven. De beheerder stelt een DropZone-map in voor de webwinkel en betalingsverwerker.
  • De webwinkel moet een officiële e-mail naar de betalingsverwerker sturen om het exportproces van het creditcardbestand van de consument te starten.
  • De betalingsverwerker moet de PayPal openbare PGP-sleutel, hieronder weergegeven, gebruiken om het geëxporteerde creditcardbestand te versleutelen en te uploaden naar de DropZone-map die door de beheerder wordt gedeeld.
  • De betalingsverwerker moet de webwinkel (of beheerder) een e-mail sturen met de naam van het geüploade bestand.
  • De beheerder moet het migratieproces starten op de Credit Card Vault (Rogue)-tool.
  • De beheerder moet het rapport genereren met het nieuwe gegenereerde betalingstoken en het uploaden naar de DropZone-map die met de webwinkel wordt gedeeld.
  • De webwinkel moet het nieuwe rapport downloaden en zijn systeem bijwerken, waarbij hij of zij het oude betaaltoken vervangt door het nieuwe PayPal betalingstoken.
  • De webwinkel moet de beheerder op de hoogte stellen zodra deze live is met PayPal als betalingsverwerker.
  • De webwinkel moet alle toestemmingen van derden voor de tool intrekken.
  • De beheerder moet elk account dat namens de gebruiker is aangemaakt in PayPal voor het gegevensimportproces verwijderen/deactiveren en de webwinkel hiervan op de hoogte stellen.

PayPal openbare PGP-sleutel voor het versleutelen van creditcardbestanden

Wanneer u ons uw gevoelige klantgegevens stuurt, moet u onze onderstaande openbare sleutel gebruiken om alle bestanden te versleutelen.

-----BEGIN PGP PUBLIC KEY BLOCK
-----Version: BCPG v1.67

mQENBGQO7FwBCACvlss+eQxRZ7FmLsK4v/Fim3btVeR6JeeOOPv8XcQ7Q0d5cnPT
kVt2CmvKsu/RKljRP/x/AiCDD91pO827CPL+0zKn6d+uHiPDrUCzeIHAzrScq6SG
PcfJphy5B3cgVkKIDLGtsEi5nE6NRBSbn8OpBML7B9WnzVgvaAM43xhQzuPcsZ2g
xI0UdhTGGlRS0SMP+uYUn61Z9p3k1Q3/qBmLvkH9mW7YclG1DWgzTbiEaSBsTOdN
SE1GKvW+pJ3STEYcpsLB75xtnZ8cwtimdX00sNUO0xiSWbQMrSajjy1XB+nTM0ie
pfVaOHi+L52Zw68wv5cQd3WVjTHG9y+Dcv3TABEBAAG0F3BheXBhbF9jcmVkaXR2
YXVsdF80MDk2iQE4BBMBAgAiBQJkDuxcAhsDBAsJCAcGFQgCCQoLAh4BBQkDwmcA
A4UB/wAKCRCBFfleETQW4+W3B/9PzMvhs2LsWP5b7DUn1EUOK3QhEKwcyEairWhH
Mznd8EIB1EOcZNe7lyqHXQNJmTNxk49Mn40pYdrwRrD17HEEIyE/AJMsdbB0CF3J
AzlvWRxrzjAw+dDHFSGvYy73M4h3IXZgOE5UW7bXSwLBWRDOc2LxjNG4OgmA4f+F
RvMSohn07t3aduo1kP84Es3RvqLVucgF4CBWB6W8xuNvmsO7RnErnL6xmOMKZYPY
wEDlBn3m/URNxPo69S8C0enJzPvAv20Nd2Jb7bOx4vCHW1FJfbmg9agHrYYkKzEl
8SKDk27hReIMWwx6tZFMxaYYdOeEjrk6DXVekkrZDuSCLVGquQENBGQO7FwBCAC0
fTMxWI5Uhnct1z43GVHkBJs79nagn+Y9L3kPq6yBKehGDmSOm9+eFpCTEku5Abz/
8sNXI2LgVG57RRoIy+DjJjwYaMpAWYGNlX0NuwQRoYbZu54G4yw5QxLZ+quYr5Xx
HJJtPXxnOiGnWfXYECYTaXYJg+mdbkiTcVcWDD44LoJiakoURWgP6dqRi7Qx1eZC
hIqTToautNZVccXk0V5SP7FGZckNEeRWXRti57Id4fP0hqmB3eeLrNQbHPf54EGC
/rTzL+s+mkL8hKBNkGaZXz5IIXBn9oh0EvqwIIS4kWceCrmTZC8U8z/wRYA4p6Xp
h7EDGHz0r/+1EzwaQqlbABEBAAGJASkEGAECABMFAmQO7F0CGwwFCQPCZwADhQH/
AAoJEIEV+V4RNBbjtNAH/1hxj6qJI9jaCb40SkPt2xivzQhyZjVmXwObSCbLfkpH
GxgQMPU0LWYqOPLfMZKNsdY26ZmOcBGCLreO/nOr90KSGpA2XVW0vjvqz5xgQW0t
HxyMrsJwt2cNvCigpA+lEBa2n99MVCGtPLOnZ4PnkWDha479g6Uq5/E2i7aVvaBW
eoxCji1d4oVVQ62aznpSkY2vRUUnN7rcfAjbe0+c2YcNwdA5XSYc72SxYULVra59
iwlWplsH62BBQtWVetPsoFgAzfLFw2drR7qYY24sBMrOeTpIhY70pDUafS6cKdyx
UH4GirnLxV8WaSBBAhs5eQ+gCeFwS+eZjFJGKl0RTNg=
=teqY
-----EINDE PGP PUBLIEKE SLEUTELBLOK-----

PayPal openbare PGP-sleutel voor het versleutelen van SFTP-inloggegevens

Wanneer je ons je gevoelige SFTP-inloggegevens stuurt, moet je onze onderstaande openbare sleutel gebruiken om je SFTP-inloggegevens te versleutelen.

-----BEGIN PGP PUBLIC KEY BLOCK
-----Version: BCPG v1.67

mQENBGQO+dABCAC1Aa6I+HwCSzWliRWeGu0Ps6nXCJFv2qxgTHrJU+9mcfoLDrRo
uowXopXFKA+sAlnkv+bp7AFM0tvapP8pqeFaXNwi8HcYla0vjJRO36a5exPFNEwN
fo3ljTHbxYnW07GSKK0FhuVFd9msneeFv/nYepzOH1K177BHUulI5hemZkyBXKFj
ubd4NX/3fnL2CypCaqNrfLXNk2r4aeNJSYbHIlK8TNOYuwL5ibRRERR5D2rAdyT3
R6PWHpfhEtI1S6jAs1MzdOJngbA9Xo9/I1mVJ1SCjGB/NXxzqoLNN5RONOHe8wFd
y1TTzsUaTEPn3nUgpDDmh+3gKJYfY0/RKCRJABEBAAG0FXBheXBhbF9wcm9jZXNz
b3JfNDA5NokBOAQTAQIAIgUCZA750AIbAwQLCQgHBhUIAgkKCwIeAQUJA8JnAAOF
Af8ACgkQXOXxXTLJc9iaWgf/XrOkI8Ii34jxXGHF7a9JTWrrKW+dnd8FBd6o+vTL
Ie/VnZ689METhACChr1NxwAOTwsgNqKwWWCVBqt+dC5aqr3XOAFBOBvSPWNWMK8Y
uhtD3qU1qlQNy74okZagJS79LkhC8Cmi8RSR9ACgpLCxIR24FZ9PAM7GhgoMI1K6
kl9ssZJqhwaevgAbPupDm8rhCl/yYlQflQysEzk44moLR3+7Kgir4ptev8HhJQ/K
NfpXU8lRrnCCbpD5+RmKxaFsk6nRC1l1Jh2iX6n7NJcyTfo71Ge6wI85+Mg+NmtC
N36iPzIZnmvc2UTEURTt9FmcJAZcv16URp9TcjdVmhADCLkBDQRkDvnQAQgAvyI1
IHdm2uOt1qGFKTPDf67wyQyjWPR3btlTPHthjNugIpsWk0eh2KpiSLD6hwx6CzTs
ox+E2Ilg2nwDfaNI0VP+UeXJ/tLi+PlZz2c4RDomyPCG5pfEQ8q7/yDrcsuCWEK3
x21VZJtMYpvzFKJGQd8FIxtzjx+5lnPxqkVgjl2pWp/KJ8WVMiKrrbPM1gGxILEV
fjj64YdTBRVSTS4NIs1mbmbKiSGWmbeOUSqrkeGzn22ENIgt+/t/TCYcH5jfyYCO
Uh8kGMr2SivFyhav1ENgk4+5i7mCe9TQQY+ci7pFQS+SOig+RxdPkv9i2n3/p6qn
Ics5SB60t3M/HVG8+QARAQABiQEpBBgBAgATBQJkDvnQAhsMBQkDwmcAA4UB/wAK
CRBc5fFdMslz2FBDB/wNOvMUM2qHK2t5UN/NBQ12XBgFKO5MZPZe3iVT7c9MBjg5
v1N9YGiLgGA/60y6BxDkRVLpg02UFcesw8Hr+Ntc6c022ekDj2G0N5wb3RCFvQUQ
O1FPyVx4OyFe3zgtZjNW9CFGwaLo6tj49QwgUhr5vshHDR4Hx/HO0y0ShcUHTKkG
HLSMHfjw0SCUo7UTz8tXszunvtHYjntDPowj42LQ6ZM57FfncpSCiEYoWhzFwPOU
h6wSPhkb+lJohm++J9VlX23HvIIhrIH38b2u8ydE+qOcnAWs8b63F9I1QrbE3kH1
bYUB5/8nQ7xEuTtLEOGANsFcTNkv6046NKV65rZ6
=wPuI
-----END PGP PUBLIC KEY BLOCK-----

Proces voor gegevensexport

Als u een exportproces wilt starten, stuurt u een verzoek per e-mail naar [email protected] met de volgende informatie:

  • Naam:
  • Telefoon:
  • e-mail:
  • Bedrijfsnaam
  • Service: (d.w.z. Payflow/PayPal-integratie)
  • Inlognaam: (indien Payflow)
  • externe leverancier, ze gaan over naar:

Een vertegenwoordiger zal contact met u opnemen om de migratie te bespreken.

Vereisten om een export te starten

  • Contract - We zullen het contract als laatste medeondertekenen.
    • Vermeld de informatie over de gateway/leverancier/derde partij onderaan waar het bestand via SFTP wordt geleverd.
    • Voer bovenaan pagina één uw bedrijfsnaam en bedrijfsadres in.
  • Certificaat - De externe leverancier die de creditcardgegevens ontvangt, moet zijn of haar meest recente PCI-Compliance Attestation of Compliance (AoC)-certificaat overleggen.
    • Deze PCI-scan wordt gevalideerd met ons PCI-compliance team.
  • SFTP (poort 22) - URL, gebruikersnaam en openbare sleutel.
    • We leveren de informatie nadat deze aan onze kant is opgehaald via SFTP aan de leverancier die het geldige PCI AoC-certificaat heeft verstrekt (niet rechtstreeks aan de handelaar). We moeten de SFTP-locatie kennen waarnaar we moeten leveren en de juiste gegevens (gebruikersnaam/wachtwoord, enz.) om dit te doen. SFTP moet op poort 22 staan.
    • De publieke sleutel moet in PGP-formaat zijn, met de extensie *.asc. Of u kunt uw PGP-blok opsturen, en wij kunnen het dienovereenkomstig opslaan in het juiste formaat.


Er zijn vier typen betalings-ID's voor een exportmigratie:

PayPal-transactie

1. PayPal-transactiereferenties

  • We hebben alle PayPal transactie-ID's nodig.
  • De lijst moet in een Kladblok.txt-indeling met regeleinden zijn.

Voorbeeld van invoertransactiebestand voor PayPal transactie-ID's:

3WF269588Y247415G
0DJ26409TS592692K


Voorbeeld van een exportbestand voor PayPal transactie-ID's:

#transaction_id,result,first_name,last_name,credit_card_num,exp_month,exp_year,phone_number,address1,city,state,country_code,zip_code,currency_code
3WF269588Y247415G,Succes,PayPal,MTS,4716123113346438,12,2021,,12312 Port Grace Blv,La Vista,NE,US,68128,USD


2. PayPal terugkerende profielen

  • We hebben alle profiel-ID's nodig.
  • De lijst moet in een Kladblok.txt-indeling met regeleinden zijn.

Voorbeeld van een invoerbestand voor PayPal terugkerende profielen:

I-66HLJ9WHR3K4

Voorbeeld van een exportbestand voor PayPal terugkerende profielen:

#profile_id,decrypted_profile_id,result,subscriber_name,credit_card_num,exp_month,exp_year,phone_number,address1,line2,city,state,country_code,postal_code,currency_code,status,start_date,initial_amount,amount_paid,delinquent_amount,profile_reference,current_period_id,next_billing_time,num_failed_payments,trial_amount_paid, outsanding_balance_paid,ipn_notify_url,period_number,period_type,bill_period,bill_frequency,total_bill_cycles,bill_cycles_used,amount,ship_amount,tax_amount,period_start_time
I-66HLJ9WHR3K4,2121412,Succes,Wereldwijde testtool,4556969247882919,01,2022,,,,,,,,,A,Fri Jul 31 2020 16:00:00 GMT-0700 (Pacific Daylight Time),0,0,0,RPInvoice123,3122479,Sat Aug 01 2020 03:00:00 GMT-0700 (Pacific Daylight Time), 0,0,,,1,T,D,1,4,0,200,2,Wed Dec 31 1969 16:00:00 GMT-0800 (Pacific Standard Time)


Payflow-transacties

3. Payflow PNREF's

  • We hebben alle Payflow Transaction ID's (PNREF's) nodig.
  • De Payflow PNREF's/transactiereferenties moeten binnen de afgelopen 12 maanden vallen.
  • We moeten de partnernaam en leveranciersnaam van je Payflow-account weten.
  • We maken een nieuwe gebruikersrol aan in je Payflow-account om de export te voltooien.
  • De lijst moet in een Kladblok.txt-indeling met regeleinden zijn.

Voorbeeld van een invoerbestand voor payflow-PNREF's:

B50P0C291FCB

Voorbeeldexportbestand voor Payflow PNREF's:

#transaction_id,result,first_name,last_name,credit_card_num,exp_month,exp_year,phone_number,line1,line2,stad,staat,bedrijf,land,postal_code,e-mail,currency_code
B50P0C291FCB,0,John,Smith,6840,10,20,,123 Main St,,SanJose,CA,,US,68128,,USD


4. Payflow terugkerende profielen

  • We hebben alle Payflow-terugkerende profiel-ID's nodig.
  • We kunnen alleen gegevens ophalen voor 'actieve profielen'.
  • We moeten de partnernaam en leveranciersnaam van de rekening weten.
  • We maken een nieuwe gebruikersrol aan in je Payflow-account om de export te voltooien.
  • De lijst moet in een Kladblok.txt-indeling met regeleinden zijn.

Het voorbeeldinvoerbestand voor terugkerende Payflow-profielen:

RP0000001223

aVoorbeeld van een exportbestand voor terugkerende Payflow-profielen:

#profile_id,decrypted_profile_id,result,first_name,last_name,credit_card_num,exp_month,exp_year,phone_number,line1,line2,plaats,staat,bedrijf,land,postal_code,e-mail,currency_code,subscriber_name,status,begin,termijn,next_payment,einde,pay_period,creation_date,last_changed,cancel_date,next_payment_num, comment1,frequency,tender,amt,payments_left,aggregate_amt,aggregate_optional_amt,max_fail_payments,num_fail_payments,retry_num_days
RP0000001223,,0,,,4916XXXXXXXX6840,,,,123 Main St,,,,,,68128,[email protected],USD,GlobalTest Profile Creation,ACTIVE,04302020,0,08132020,,WEEK,04172020,08092020,,16,,1,C,0.01,,0.00,0.00,0,0,0,15,3


Een integratie-ingenieur werkt samen met uw nieuwe externe betalingsverwerker om hun PGP-sleutel te verkrijgen tijdens het exportproces. De beheerder deelt een PayPal DropZone-map met het lid van de nieuwe betalingsverwerker. Alle creditcardgegevens die zijn gekoppeld aan de betalingsidentificaties in de invoerbestanden worden geëxporteerd als een versleuteld bestand (met de opgegeven PGP-sleutel). Het versleutelde bestand wordt geüpload naar de gedeelde DropZone-map. Elke kaartrecord staat op een eigen rij.

Opmerking:

  • We exporteren alleen bestanden die zijn versleuteld met de openbare PGP-sleutel die is verkregen van de betalingsverwerker.
  • We sturen alleen versleutelde creditcardbestanden naar een PCI-conforme SFTP-server.

PayPal DropZone-toegang

DropZone is ons platform voor bestandsoverdracht dat veilig bestanden verzendt, bestanden ontvangt en regelmatige bestandsoverdrachten automatiseert.
Voor meer informatie over toegang tot DropZone, zie Wat is DropZone en hoe gebruik ik het om bestanden naar PayPal te verzenden?

Heb je nog vragen?

Als je vragen hebt over het importeren van de gegevens van je klanten in PayPal, stuur dan een e-mail naar ons team Data Migration Support.

Als je vragen hebt over het exporteren van de gegevens van je klanten, stuur dan een e-mail naar ons ondersteuningsteam.