Bestand aanbieden

Bestand aanbieden


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 Services > 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 Mijn Buckaroo > 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 Configuratie.

Voorbeeldbestanden.

Onderstaand vind je diverse voorbeeldbestanden inclusief korte toelichting wat een specifiek veld inhoud.


iDEAL QR

iDEAL-QR.csv



(Simple) SEPA Direct Debit transacties

(Simple) SEPA Direct Debit:

Simple-SEPA-Direct-Debit.csv

Simple SEPA Direct Debit met Credit Management

Simple-SEPA-Direct-Debit-CM.csv

Simple SEPA Direct Debit met Credit Management en Pre-Notificatie

Simple-SEPA-Direct-Debit-CM-Pre-Notification.csv



Transfer

Voorbeeldbestand Overboeking regulier:

Transfer.csv

Voorbeeldbestand Overboeking met Credit Management:

Transfer-With-CM.csv



PayPerEmail

PayperEmail:

PayPerEmail.csv

PayperEmail met Credit Management:

PayPerEmail-With-CM.csv



Subscriptions

Update Subscription - IBAN:

UpdateSubscriptionIBAN.csv

Update Subscription - prijs en aantal:

UpdateSubscription-With-Price-and-quantity.csv

Update Subscription - Voeg debiteur toe of wijzig debiteurgegevens:

UpdateSubscription-Add-Debtor-Or-Edit-Debtor-Data.csv



Andere bestanden:

Refunds voorbeeldbestand:

Refund.csv

Betaalopdracht voorbeeldbestand:

Payment-Order.csv

Creditnota voorbeeldbestand:

Credit-Note.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.


Was dit artikel nuttig?

What's Next