Visa und Mastercard haben vorgeschrieben, dass alle Händler, die Schuldenrückzahlungen verarbeiten, die folgenden Felder in Anfragen an Trust Payments übermitteln müssen. (Gilt nur für die Anfragearten AUTH und ACCOUNTCHECK)
Dieses Mandat gilt nur für Händler mit bestimmten Acquiring-Banken. Bitte kontaktieren Sie unser Support-Team für weitere Informationen.
Erfordernis: Ihre Kunden Categorie Nummer muss entweder 6012, 6051 oder 7299 sein.
Ihre Kunden Categorie Nummer (MCC) ist eine vierstellige Nummer, die Ihnen von Ihrem Acquirer zugewiesen wird. Sie wird verwendet, um das Unternehmen nach der Art der Produkte oder Dienstleistungen zu klassifizieren, die es anbietet. Wenn Sie sich über den Wert Ihrer Kunden Categorie Nummer nicht sicher sind, wenden Sie sich bitte an unser Support-Team.
Vererbung
Sobald Sie eine AUTH oder ACCOUNTCHECK verarbeitet haben, die diese Pflichtfelder enthält, können sie in zukünftige Anfragen übernommen und bei Bedarf automatisch an die anwerbende Bank weitergegeben werden.
Beispiel anfordern
Das folgende Beispiel enthält die Felder, die für Händler, die Schuldentilgungen verarbeiten, vorgeschrieben sind:
(Payload)
{
"payload":{
"accounttypedescription":"ECOM",
"baseamount":"1050",
"currencyiso3a":"GBP",
"sitereference":"test_site12345",
"requesttypedescriptions":["THREEDQUERY","AUTH"],
"customeraccountnumber":"4111111111111111",
"customeraccountnumbertype":"CARD",
"customerdob":"1990-01-01",
"customerpostcode":"TR45 6ST",
"customerlastname":"Bloggs",
"debtrepayment":"1"
},
"iat":1559033849,
"iss":"jwt.user"
}
Das folgende Beispiel enthält die Felder, die für Händler, die Schuldentilgungen verarbeiten, vorgeschrieben sind:
(Payload)
{
"payload":{
"accounttypedescription":"ECOM",
"baseamount":"1050",
"currencyiso3a":"GBP",
"sitereference":"test_site12345",
"termurl":"https:\/\/payments.securetrading.net\/process\/payments\/mobilesdklistener",
"requesttypedescriptions":["THREEDQUERY","AUTH"],
"customeraccountnumber":"4111111111111111",
"customeraccountnumbertype":"CARD",
"customerdob":"1990-01-01",
"customerpostcode":"TR45 6ST",
"customerlastname":"Bloggs",
"debtrepayment":"1"
},
"iat":1559033849,
"iss":"jwt.user"
}
Das folgende Beispiel enthält die Felder, die für Händler, die Schuldentilgungen verarbeiten, vorgeschrieben sind:
#!/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": "ECOM",
"currencyiso3a": "GBP",
"baseamount": "1050",
"orderreference": "My_Order_123",
"pan": "4111111111111111",
"expirydate": "12/2020",
"securitycode": "123",
"customeraccountnumber": "4111111111111111",
"customeraccountnumbertype": "CARD",
"customerdob": "1990-01-01",
"customerpostcode": "TR45 6ST",
"customerlastname": "Bloggs",
"debtrepayment": "1"
}
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' => 'ECOM',
'currencyiso3a' => 'GBP',
'baseamount' => '1050',
'orderreference' => 'My_Order_123',
'pan' => '4111111111111111',
'expirydate' => '12/2020',
'securitycode' => '123',
'customeraccountnumber' => '4111111111111111',
'customeraccountnumbertype' => 'CARD',
'customerdob' => '1990-01-01',
'customerpostcode' => 'TR45 6ST',
'customerlastname' => 'Bloggs',
'debtrepayment' => '1'
);
$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": "ECOM",
"pan": "4111111111111111",
"expirydate": "12/2020",
"securitycode": "123",
"customeraccountnumber": "4111111111111111",
"customeraccountnumbertype": "CARD",
"customerdob": "1990-01-01",
"customerpostcode": "TR45 6ST",
"customerlastname": "Bloggs",
"debtrepayment": "1"
}]
}'
{
"alias":"webservices@example.com",
"version":"1.00",
"request":[{
"currencyiso3a":"GBP",
"requesttypedescriptions":["AUTH"],
"sitereference":"test_site12345",
"baseamount":"1050",
"orderreference":"My_Order_123",
"accounttypedescription":"ECOM",
"pan":"4111111111111111",
"expirydate":"12/2020",
"securitycode":"123",
"customeraccountnumber":"4111111111111111",
"customeraccountnumbertype":"CARD",
"customerdob":"1990-01-01",
"customerpostcode":"TR45 6ST",
"customerlastname":"Bloggs",
"debtrepayment":"1"
}]
}
<requestblock version="3.67">
<alias>webservices@example.com</alias>
<request type="AUTH">
<merchant>
<orderreference>My_Order_123</orderreference>
<debtrepayment>1</debtrepayment>
</merchant>
<billing>
<payment type="VISA">
<expirydate>12/2020</expirydate>
<pan>4111111111111111</pan>
<securitycode>123</securitycode>
</payment>
<amount currencycode="GBP">1050</amount>
</billing>
<operation>
<sitereference>test_site12345</sitereference>
<accounttypedescription>ECOM</accounttypedescription>
</operation>
<customer>
<name>
<last>Bloggs</last>
</name>
<postcode>TR45 6ST</postcode>
<dob>1990-01-01</dob>
<accountnumber type="CARD">4111111111111111</accountnumber>
</customer>
</request>
</requestblock>
Feldspezifikation
Die erforderlichen Felder sind wie folgt:
Feld | Format | Beschreibung | |
customeraccountnumber XPath: /customer/accountnumber |
Numerisch (20) |
Wenn der Kontonummern-Typ "ACCOUNT", die Kontonummer des Kontoinhabers.
Wenn der Kontonummern-Typ "CARD", die Kartennummer des Kontoinhabers. Der in der Antwort zurückgegebene Wert ist in einem maskierten Format, z. B. "411111#######1111". |
|
customeraccountnumbertype XPath: /customer/accountnumber/@type |
Alpha (7) | Entweder "CARD" oder "ACCOUNT". | |
customerdob XPath: /customer/dob |
Datum JJJJ-MM-TT | Das Geburtsdatum des Kontoinhabers. | |
customerpostcode XPath: /customer/postcode |
Alphanumerisch (25) |
Die Postleitzahl des Kunden oder die Postleitzahl.
Es muss sich um eine gültige Postleitzahl für den customercountryiso2a vorgelegt. |
|
customerlastname XPath: /customer/name/last |
Alphanumerisch einschließlich Symbole (127) |
Der Nachname des Kunden. | |
debtrepayment XPath: /merchant/debtrepayment |
Numerisch (1) |
Gibt an, ob die Transaktion als Schuldentilgung gekennzeichnet ist:
Hinweis: Ihre Website kann so konfiguriert werden, dass dieses Kennzeichen bei jeder Transaktion standardmäßig mit dem Wert 0 oder 1 übermittelt wird. (Bitte kontaktieren Sie unser Support-Team, um diese Änderung vorzunehmen). |