Referentiegegevens van de regeling - Trust Payments

Met deze functionaliteit kunt u een terugkerende betalingsreeks voortzetten die oorspronkelijk was gestart met een andere Payment Service Provider dan Trust Payments. De ingediende schema-referentiegegevens bieden een link naar de betalingsgeschiedenis tussen uw bedrijf en de klant.

Over Visa regeling referentiegegevens

De systeemreferentiegegevens die Visa nodig heeft bij terugkerende en andere typen Merchant Initiated Transaction (MIT) autorisatie verzoeken worden de Visa Transaction Identifier (Transaction ID).

De Visa Transaction ID is een unieke identificatiecode voor elk oorspronkelijk autorisatie verzoek, een numerieke waarde van maximaal 15 cijfers in het teruggestuurde Visa autorisatie antwoord, na de eerste door de klant geïnitieerde transactie autorisatie die werd ingediend toen de kaarthouder zich voor het eerst aanmeldde voor de terugkerende of MIT overeenkomst.

Voorbeeld van een Visa Transaction ID: 987654321234567

Trust Payments vereisen de Visa Transaction ID in het bovenstaande formaat te verstrekken.

Over Mastercard regeling referentiegegevens

De systeemreferentiegegevens die Mastercard nodig heeft bij terugkerende en andere typen Merchant Initiated Transaction (MIT) autorisatie verzoeken worden de Mastercard Trace ID.

De Mastercard Trace ID is een combinatie van de Mastercard Financial Network Code, Banknet Reference Number en Banknet Settlement Date opgenomen in het antwoord op Mastercard autorisatie dat is teruggestuurd na de eerste door de klant geïnitieerde transactie autorisatie die is ingediend toen de kaarthouder zich voor het eerst aanmeldde voor de terugkerende of MIT overeenkomst.

Voorbeeld van een Mastercard Trace ID: "MCCABC1XY0101 "

Posities 1-3 = “MCC” = Financial Network Code
Posities 4-9 = “ABC1XY” = Banknet Reference Number
Posities 10-13 = “0101” = Banknet Settlement Date
Posities 14-15 = witruimte gevuld

Trust Payments vereisen de Mastercard Trace ID te verstrekken in het volgende formaat: "MCCABC1XY 0101"

Posities 1-3 = “MCC” = Financial Network Code
Posities 4-9 = “ABC1XY” = Banknet Reference Number
Posities 10-12 = " " = witruimte gevuld
Posities 13-16 = Banknet Settlement Date

Vereisten

Voordat u verder gaat, moet u contact opnemen met ons Support Team en vragen of de referentiedatafunctie van de regeling is ingeschakeld op uw site referentie(s).
Deze functionaliteit wordt alleen ondersteund als u betalingen verwerkt met TRU Acquiring.

Dien een verzoek in met referentiegegevens over de regeling

Voorbeeld aanvraag

#!/usr/bin/python
import securetrading

stconfig = securetrading.Config()
stconfig.username = "webservices@example.com"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)

auth = {
  "sitereference": "test_site12345",
  "requesttypedescriptions": ["AUTH"],
  "accounttypedescription": "RECUR",
  "currencyiso3a": "GBP",
  "baseamount": "1050",
  "orderreference": "My_Order_123",
  "pan": "4111111111111111",
  "expirydate": "12/2020",
  "schemereferencedata": "123456789012345",
  "subscriptiontype": "RECURRING",
  "subscriptionnumber": "2",
  "credentialsonfile": "2"
}

strequest = securetrading.Request()
strequest.update(auth)
stresponse = st.process(strequest) #stresponse contains the transaction response

<?php

if (!($autoload = realpath(__DIR__ . '/../../../autoload.php')) && !($autoload = realpath(__DIR__ . '/../vendor/autoload.php'))) {
throw new Exception('Composer autoloader file could not be found.');
}
require_once($autoload);

$configData = array(
  'username' => 'webservices@example.com',
  'password' => 'Password1^',
);

$requestData = array(
  'sitereference' => 'test_site12345', 
  'requesttypedescriptions' => array('AUTH'),
  'accounttypedescription' => 'RECUR',
  'currencyiso3a' => 'GBP',
  'baseamount' => '1050',
  'orderreference' => 'My_Order_123',
  'pan' => '4111111111111111',
  'expirydate' => '12/2020',
  'schemereferencedata' => '123456789012345',
  'subscriptiontype' => 'RECURRING',
  'subscriptionnumber' => '2',
  'credentialsonfile' => '2'
);

$api = \Securetrading\api($configData);
$response = $api->process($requestData);
var_dump($response->toArray());

?>

curl --user webservices@example.com:Password1^ <DOMAIN>/json/ -H "Content-type: application/json" -H "Accept: application/json" -X POST -d '{
  "alias":"webservices@example.com",
  "version": "1.00",
  "request": [{
    "currencyiso3a": "GBP",
    "requesttypedescriptions": ["AUTH"],
    "sitereference": "test_site12345",
    "baseamount": "1050",
    "orderreference": "My_Order_123",
    "accounttypedescription": "RECUR",
    "pan": "4111111111111111",
    "expirydate": "12/2020",
    "schemereferencedata": "123456789012345",
    "subscriptiontype": "RECURRING",
    "subscriptionnumber": "2",
    "credentialsonfile": "2"
  }]
}'

{
  "alias":"webservices@example.com",
  "version":"1.00",
  "request":[{
    "currencyiso3a":"GBP",
    "requesttypedescriptions":["AUTH"],
    "sitereference":"test_site12345",
    "baseamount":"1050",
    "orderreference":"My_Order_123",
    "billingfirstname":"Joe",
    "billinglastname":"Bloggs",
    "accounttypedescription":"RECUR",
    "pan":"4111111111111111",
    "expirydate":"12/2020",
    "schemereferencedata": "123456789012345",
    "subscriptiontype":"RECURRING",
    "subscriptionnumber":"2",
    "credentialsonfile":"2"
  }]
}

<requestblock version="3.67">
  <alias>webservices@example.com</alias>
  <request type="AUTH">
    <merchant>
      <orderreference>My_Order_123</orderreference>
    </merchant>
    <billing>
      <payment>
        <expirydate>12/2020</expirydate>
        <pan>4111111111111111</pan>
      </payment>
      <amount currencycode="GBP">1050</amount>
      <subscription type="RECURRING">
        <number>2</number>
      </subscription>
    </billing>
    <operation>
      <sitereference>test_site12345</sitereference>
      <accounttypedescription>RECUR</accounttypedescription>
      <schemereferencedata>123456789012345</schemereferencedata>
      <credentialsonfile>2</credentialsonfile>
    </operation>
  </request>
</requestblock>

Specificatie van het verzoekveld

In dit geval is een extra veld vereist:

Veld	Formaat	Beschrijving
credentialsonfile XPath: /operation/credentialsonfile	Numeriek (1)	Dit is vereist voor Visa en Mastercard transacties waarbij de handelaar gebruik maakt van Gevevens in Bestand (CoF). Vul in dit veld "2" in om aan te geven dat de betaling gebruik maakt van eerder opgeslagen referenties.
schemereferencedata XPath: /operation/schemereferencedata	Als Mastercard regeling: Alfanumeriek (max. lengte 16) Posities 1-3 = Financial Network Code Posities 4-9 = Banknet Reference Number Posities 10-12 = witruimte gevuld Posities 13-16 = Banknet Settlement Date Als Visa regeling: Numeriek (15) bijv. 123456789012345	Referentiegegevens van de regeling die door uw vorige aanbieder van betalingsdiensten (PSP) zijn verstrekt na de eerste betaling in de reeks. Deze moeten ongewijzigd worden ingediend.
subscriptionnumber XPath: /billing/subscription/number	Numeriek (5)	Dit wordt gebruikt om de positie van een betaling binnen een reeks terugkerende transacties te identificeren. Voor elke volgende betaling moet het ingediende nummer met 1 worden verhoogd (zonder hiaten). bijv. 2e transactie is "2", 3e is "3", dan "4" enz. (U moet dit nummer alleen verhogen als de vorige terugkerende betalingsaanvraag succesvol was) Wij stellen geen beperkingen aan het aantal betalingen met een kaart.
subscriptiontype XPath: /billing/subscription/@type	Alpha (11)	Dit is het type abonnement: "RECURRING" is voor wanneer de klant een terugkerende betaling doet voor telkens een nieuw product/dienst. "INSTALLMENT" is voor wanneer een klant een enkele bestelling koopt in verschillende termijnen. Termijnen worden ondersteund voor winkeliers met een Trust Payments acquiring account. Als u een andere acquiring bank gebruikt, moet u contact opnemen met ons Support Team om te controleren of deze functie wordt ondersteund voordat u verder gaat.

Behandeling van het antwoord

De referentiegegevens van de regeling worden in het antwoord teruggestuurd:

Veld

Formaat

Beschrijving

schemereferencedata
XPath: /operation/schemereferencedata

Als Mastercard regeling:

Alfanumeriek (max. lengte 16)
- Posities 1-3 = Financial Network Code
- Posities 4-9 = Banknet Reference Number
- Posities 10-12 = witruimte gevuld
- Posities 13-16 = Banknet Settlement Date

Als Visa regeling:

Numeriek (15)
bijv. 123456789012345

Referentiegegevens van de regeling in verband met deze transactie, zoals teruggestuurd door de kaartuitgever.

Opmerking: Bij volgende terugkerende betalingen moet u de oorspronkelijke referentiegegevens van het schema die bij de aanvraag werden verstrekt, blijven indienen.

Referentiegegevens regeling