Transactie CSV download

Je moet een Trust Payments API gebruikersnaam opgeven met voldoende gebruikersrechten om de download uit te voeren voor de opgegeven site referentie(s).

--user=example@example.com --ask-password

Het CSV-bestand kan worden gedownload met een HTTPS POST query string met Basic Access Authentication. Basic Access Authentication is een methode voor een web browser client programma om een gebruikersnaam en wachtwoord op te geven bij het verwerken van een verzoek.

Ondersteunde gebruikersrollen

U kunt uw Webservices gebruikersnaam en wachtwoord gebruiken om transactiebestanden en rapporten te downloaden. Als je nog geen Webservices gebruikersnaam hebt, kun je een nieuwe API-gebruiker aanmaken via Portal of MyST.

U kunt ook een nieuwe gebruikersrol Extra Transactie downloaden aanmaken, die toegang heeft tot extra informatie over acquirer fees. (Informatie over acquirer fees is alleen beschikbaar voor transacties die worden verwerkt met een deelnemende acquiring bank. Neem contact op met ons ondersteuningsteam voor meer informatie)

Autorisatie kop

Een gebruikersnaam en wachtwoord, gescheiden door een dubbele punt en vervolgens base64 gecodeerd, moeten worden opgenomen in de autorisatie header bij het uitvoeren van het verzoek. De meeste URL-bibliotheken zullen de basisverificatieheader automatisch aanmaken, maar als u dit handmatig moet doen, volg dan dit voorbeeld:

Gebruikersnaam: csvdownload@example.com
Wachtwoord: pa55word
Gescheiden door een dubbele punt: csvdownload@example.com:pa55word
Base64 encodeer: Y3N2ZG93bmxvYWRAZXhhbXBsZS5jb206cGE1NXdvcmQ=

Daarom moet de autorisatie header zijn:

Authorization: Basic Y3N2ZG93bmxvYWRAZXhhbXBsZS5jb206cGE1NXdvcmQ=

In het verzoek kunnen filters worden opgenomen, zodat alleen records worden teruggezonden die aan bepaalde criteria voldoen.

sitereferences=test_site12345&startdate=2017-01-01&enddate=2017-01-31&settlestatuss=100

Standaard worden alle transacties binnen het datumbereik voor de opgegeven sitereferentie(s) gedownload. Er kunnen filters worden toegepast op de download, zodat alleen bepaalde records worden geretourneerd. In het bovenstaande voorbeeld zijn de volgende filters toegepast:

• Site referentie: test_site12345
• Transactie autorisatie datum: 1 januari 2017 - 31 januari 2017
• Status betaling: 100

Meerdere waarden voor dezelfde filters kunnen in de oproep worden opgenomen, gescheiden door een "&".

Bijvoorbeeld voor het downloaden van e-commerce en MOTO transacties, de accounttypedescriptions filter kan tweemaal worden opgenomen met twee verschillende waarden:

accounttypedescriptions=ECOM&accounttypedescriptions=MOTO

Noodzakelijke filters

De volgende velden moeten in de POST-gegevens worden opgenomen:

Gegevens kunnen worden gedownload voor meerdere sitereferenties door extra sitereferenties velden in de oproep op te nemen, gescheiden door een "&".

Als er bijvoorbeeld transacties nodig zijn voor site1 en site2, zou de oproep het volgende inhouden:

sitereferences=site1&sitereferences=site2

Optionele filters

Nuttige filters

Hieronder volgt een lijst van de meest gebruikte filters door onze handelaren:
(Neem contact op met ons Support Team om te informeren naar de beschikbaarheid van extra filters)

Filter op tijd

Gebruik de volgende filters om gegevens te downloaden over transacties binnen een bepaald tijdsbereik:

Bijvoorbeeld voor het downloaden van transacties tussen 13:30:00 en 14:29:59:

starttimehour=13&starttimeminute=30&endtimehour=14&endtimeminute=29

Type datum

Standaard worden gespecificeerde datums en tijden gefilterd op basis van wanneer de transactie aanvankelijk werd verwerkt. U kunt echter expliciet aangeven welk type datum/tijd wordt gefilterd door het volgende extra filter op te nemen:

Hier kunt u aangeven welke gegevensvelden moeten worden teruggezonden.

Alle Transactie downloaden CSV's de Transactiereferentie bevatten voor elke geretourneerde record.

Voorbeelduitvoer:

transactionreference
13-2-81000
13-28-1
13-28-10
13-28-11

U kunt extra velden opgeven die moeten worden teruggegeven in de Transactie downloaden, zoals in onderstaand voorbeeld:

optionalfields=errorcode&optionalfields=currencyiso3a&optionalfields=authcode&optionalfields=orderreference&optionalfields=paymenttypedescription&optionalfields=settlestatus&optionalfields=settlemainamount&optionalfields=settleduedate&optionalfields=customercountryiso2a

Het bovenstaande voorbeeld bevat de volgende optionele velden:

• Foutcode
• Munt
• Auth code
• Referentie bestelling
• Payment Type (Betalingstype)
• Status betaling (settlestatus)
• Settle hoofdbedrag
• Deadline betaling
• Land van de klant

De uitvoer zou deze optionele velden bevatten. De in het verzoek opgegeven veldnamen staan op de eerste regel van de CSV-uitvoer, in dezelfde volgorde:

transactionreference,errorcode,currencyiso3a,authcode,orderreference,paymenttypedescription,settlestatus,settlemainamount,settleduedate,customercountryiso2a
23-9-1,0,GBP,TEST,20161,VISA,100,10.99,2017-01-03,GB
23-9-2,0,GBP,TEST,20162,MASTERCARD,100,11.98,2017-01-10,GB
23-9-3,0,GBP,TEST,20163,MASTERCARD,100,10.99,2017-01-11,GB
23-9-4,0,GBP,TEST,20164,MASTERCARD,100,10.99,2017-01-16,GB

Volledige lijst van optionele velden

In de volgende paragrafen worden de velden opgesomd die in de uitvoer kunnen worden opgenomen, indien zij in het verzoek zijn gespecificeerd:

Transactie details

Betalingsgegevens

afwikkeling details

Beveiligingsantwoord

Het antwoord van de AVS en beveiligingscodecontroles die zijn uitgevoerd tijdens autorisatie. Dit kan een van de volgende waarden zijn:

• 0 = DATA NOT GIVEN
• 1 = DATA NOT CHECKED
• 2 = DATA MATCH
• 4 = DATA NOT MATCHED

Factuurgegevens

Levering

Gegevens van de handelaar

Vergoedingen voor de koper

De volgende velden kunnen alleen worden teruggegeven als aan de volgende vereisten is voldaan:

• Deze velden worden alleen ingevuld wanneer transacties worden verwerkt met een ondersteunde acquirer. Neem contact op met ons Support Team voor meer informatie.
• De gebruikersrol Extra transactiedownload moet worden gebruikt om de download uit te voeren (deze velden kunnen niet worden geretourneerd met gebruikersrol Webservices).

Download de CSV van de volgende URL:

https://myst.securetrading.net/auto/transactions/transactionsearch