Bestand aanbieden - Guides (2024)

Transacties aanbieden kan op verschillende manieren. De eerste mogelijkheid is via de diverse gateways : JSON, HTML, NVP & SOAP. De tweede mogelijkheid is om transacties via batch aan te bieden.

Via de bestand aanbieden functionaliteit is het dus mogelijk om meerdere transacties tegelijk uit te voeren. Let hierbij wel op dat er geen klant-interactie plaats vindt, een iDEAL betaling is dus niet mogelijk.

Bestand aanbieden via de Plaza

Indien een account de juiste rechten heeft is het mogelijk om via de onderstaande stappen gebruik te maken van bestand aanbieden.

1. Klik op Uitvoeren > Bestand aanbieden.
2. Klik rechts bovenin het venster op Acties > Upload new batch.
3. Sleep het bestand (.CSV) in het file drop veld en selecteer rechts de correcte instellingen.

a. Bestand als test aanbieden: Indien er getest moet worden om te controleren of alles klopt
b. Is een refund-batch:     Indien het gaat om een Refund bestand.
(Zie het Refund.csv voorbeeldbestand hieronder. Een refund bestand bevat geen service- en actieparameters.)
c. Website dropdown:      Kies een van de websites, tenzij de key(s) zijn opgenomen in het .csv-bestand.

4. Klik op Bestand aanbieden en wacht op goedkeuring.

Als een bestand succesvol is aangeboden ontvangt de aanvrager een e-mail met daar in een goedkeuringscode. Deze code dient ingevuld te worden om de verwerking van het bestand te starten.

Status

Als er bij het aanbieden van het bestand iets fout is gegaan, is de status De batch is mislukt. De batch kan mislukken om diverse redenen. Bijvoorbeeld doordat een specifieke waarde ontbreekt of niet klopt. Onderstaand vind je enkele tips voor de verwerking van het bestand.

• Currency is meestal euro, de waarde hiervoor is EUR. Voor de Amerikaanse dollar is dit USD.
• De Websitekey van een website vind je via Instellingen > Websites.
• Let er bij Amount op dat de cijfers worden gescheiden met een punt en niet met een komma.
• Culture gaat om de taal. Meer hierover vind je hier.
• Het bestand moet worden aangeboden in .csv-format, niet in .xls-format.
• Voor sommige parameters (zoals geslacht, service en action) zijn een aantal specifieke waarden mogelijk. Hiervoor kun je ook terecht op onze API documentatie.
• Je kunt nooit precies hetzelfde bestand aanbieden: als je iets aan het testen bent of er gaat iets verkeerd en je wilt dus het bestand opnieuw aanbieden, dan mag de titel en de inhoud niet identiek zijn aan een eerder aangeboden bestand. Als je een bestand aanbiedt wat wel hetzelfde is, zal er meteen een foutmelding optreden.

Als alles goed is verwerkt is de status De batch is in afwachting van goedkeuring. De (ingelogde) gebruiker ontvangt na het uploaden/verwerken een e-mail met bevestigingscode welke kan worden opgevoerd met de Batch goedkeuren-knop linksbovenin de batchgegevens.

Kenmerken batch:

Voor details over een batch kun je op de specifieke batch klikken. Hier vind je in de kolom Details meer informatie.

• Aangeboden: Aanbiedingstijd en -datum van het bestand
• Aantal posten: Aantal regels in de csv dat voor de batch is gebruikt
• Bedrag debit: Totaal debit bedrag in batch (bijvoorbeeld vorderingen)
• Bedrag credit: Totaal credit bedrag (bijvoorbeeld refunds)
• Bestandsnaam: Naam van het geuploade bestand
• Bestandstype: csv (Wordt geopend met Excel)
• Bron: Meestal Plaza, maar kan ook sFTP zijn

Verwerkte batch

Zodra een batch is verwerkt en goedgekeurd kun je op de batch klikken om de resultaten te bekijken.

• Origineel bestand: Het aangeboden bestand.
• Validatie resultaten: Dit bestand geeft per regel in het aangeboden bestand aan of deze ingeladen kon worden in de Plaza of niet. Als alles goed gaat, wordt dat in dit bestand aangegeven. Als er iets verkeerd gaat, vind je dat in dit bestand en daar staat ook bij wat er mis is gegaan zodat je dit kunt aanpassen.
• Processing-resultaten: Een overzicht van de status/details van de gecreëerde transacties (e.g. TransactionKey, Status, ErrorMessage)

Multilevel autorisatie.

Het is mogelijk om goedkeuringen in te stellen. Deze functie maakt het mogelijk om een vier ogen beleid in te stellen waarmee eventuele fouten kunnen worden voorkomen. Meer informatie over multilevel autorisatie vind je onder Uitvoeren > Goedkeuringen.

Voorbeeldbestanden.

iDEAL-QR.csv

SEPA Direct Debit transacties

SepaDirectDebit.csv

Sepadirectdebit payrecurrent.csv

SepaDirectDebit met eigen mandaatreferentie.csv

SepaDirectDebit met BCM minimale velden.csv

SepaDirectDebit met BCM uitgebreid.csv

Overboeking

Overboeking.csv

Overboeking met BCM minimaal.csv

Overboeking met BCM uitgebreid.csv

PayPerEmail

PayPerEmail(1).csv

PayPerEmail met BCM minimaal.csv

PayPerEmail met BCM uitgebreid.csv

Buckaroo Credit Management

BCM CreateInvoice minimaal.csv

BCM CreateInvoice uitgebreid.csv

BCM CreateInvoice uitgebreid B2B.csv

BCM Creditnote(1).csv

Subscription

CreateSubscription PayperEmail.csv

CreateSubscription met IBAN.csv

UpdateSubscription prijs aanpassing.csv

StopSubscription.csv

Overig

refund.csv

Diakrieten

Wanneer letters met schriftteken erboven worden gebruikt, spreken we van diakrieten. Dit resulteert erin dat er onder of door een letter een teken wordt gezet ter aanduiding van de uitspraak. Zoals bij het woord fryslân. Het "dakje" op de 'a' is een diakriet. Buckaroo gebruikt voor de verwerking van deze tekens de codering UTF-8. In de verschillende gateways wordt de UTF-8 encoding afgedwongen. Voor bestandsaanbieden geldt dat ook daarin de UTF-8 codering afgedwongen dient te worden. Het is dus goed om in de gebruikte tekst editor te letten of deze de tekst UTF-8 gecodeerd opslaat. Andere encoding wordt er door Buckaroo uitgefilterd en vervangen door een vraagteken (?) om verdere verwerking van de data mogelijk te maken. Wanneer er in de naamgeving van klant, straatnamen of andere data diakrieten worden gebruikt, is dit belangrijk om aandacht aan te geven.