Ein Payment Facilitator ist ein Unternehmen, das die Zahlungsabwicklung für gesponserte Unterhändler, die Kartenzahlungen akzeptieren, erleichtert. Der Zahlungserleichterer ist Eigentümer der Beziehung zu seinen gesponserten Unterhändlern und erhält Mittel für die verarbeiteten Transaktionen, die er dann entsprechend an die gesponserten Unterhändler weiterleitet. Auf dieser Seite werden die Feldnamen angegeben, die Trust Payments Payment Facilitator-Kunden in die an das Trust Payments Gateway gesendeten Anfragen aufnehmen müssen. Wenn Sie weitere Informationen darüber wünschen, wie Sie ein Payment Facilitator werden können, wenden Sie sich bitte an unser Commercial Team.
Übermittlung von Zahlungsvermittlerfeldern in einer Anforderung
Werden diese Anforderungen nicht erfüllt, so wird ein Fehler für ein ungültiges Feld zurückgegeben (30000).
Nachfolgend ein Beispiel für eine Anfrage, die Felder für Zahlungsabwickler enthält:
Sie müssen die payload die in Ihrem JWT übermittelt werden, um zusätzliche Felder aufzunehmen, wie unten dargestellt. Wenn Sie die Felder für den Zahlungsdienstleister auf diese Weise übermitteln, werden alle in Ihrem Konto gespeicherten oder von einem übergeordneten Konto geerbten Werte außer Kraft gesetzt.
(Payload)
{
"payload":{
"accounttypedescription":"ECOM",
"baseamount":"1050",
"currencyiso3a":"GBP",
"sitereference":"test_site12345",
"pan":"4900490000000501",
"expirydate":"12/2030",
"securitycode":"123",
"facilitatorid":"987654",
"facilitatorname":"FAC",
"submerchantid":"999999999999999",
"chargedescription":"Test Sub Mer Name",
"merchantstreet":"1 Test Street",
"merchantcity":"Test City",
"merchantzipcode":"TR45 6ST",
"merchantcountryiso2a":"GB",
"requesttypedescriptions":["THREEDQUERY","AUTH"]
},
"iat":1559033849,
"iss":"jwt.user"
}
Nachfolgend ein Beispiel für eine Anfrage, die Felder für Zahlungsabwickler enthält:
Sie müssen die an Trust Payments übermittelte Anfrage aktualisieren, damit sie zusätzliche Felder enthält, wie unten gezeigt. Wenn Sie die Felder für den Zahlungsdienstleister auf diese Weise übermitteln, werden alle in Ihrem Konto gespeicherten oder von einem übergeordneten Konto geerbten Werte außer Kraft gesetzt.
(Beispiel)
#!/usr/bin/python
import securetrading
stconfig = securetrading.Config()
stconfig.username = "webservices@example.com"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)
auth = {
"currencyiso3a": "GBP",
"requesttypedescriptions": ["AUTH"],
"sitereference": "test_site12345",
"baseamount": "1050",
"accounttypedescription": "MOTO",
"pan": "4111111111111111",
"expirydate": "12/2030",
"securitycode": "123",
"facilitatorid": "987654",
"facilitatorname": "FAC",
"submerchantid": "999999999999999",
"chargedescription": "Test Sub Mer Name",
"merchantstreet": "1 Test Street",
"merchantcity": "Test City",
"merchantzipcode": "TR45 6ST",
"merchantcountryiso2a": "GB"
}
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(
'currencyiso3a' => 'GBP',
'requesttypedescriptions' => array('AUTH'),
'sitereference' => 'test_site12345',
'baseamount' => '1050',
'accounttypedescription' => 'MOTO',
'pan' => '4111111111111111',
'expirydate' => '12/2030',
'securitycode' => '123',
'facilitatorid' => '987654',
'facilitatorname' => 'FAC',
'submerchantid' => '999999999999999',
'chargedescription' => 'Test Sub Mer Name',
'merchantstreet' => '1 Test Street',
'merchantcity' => 'Test City',
'merchantzipcode' => 'TR45 6ST',
'merchantcountryiso2a' => 'GB'
);
$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",
"accounttypedescription": "MOTO",
"pan": "4111111111111111",
"expirydate": "12/2030",
"securitycode": "123",
"facilitatorid": "987654",
"facilitatorname": "FAC",
"submerchantid": "999999999999999",
"chargedescription": "Test Sub Mer Name",
"merchantstreet": "1 Test Street",
"merchantcity": "Test City",
"merchantzipcode": "TR45 6ST",
"merchantcountryiso2a": "GB"
}]
}'
{
"alias":"webservices@example.com",
"version":"1.00",
"request":[{
"currencyiso3a":"GBP",
"requesttypedescriptions":["AUTH"],
"sitereference":"test_site12345",
"baseamount":"1050",
"accounttypedescription":"MOTO",
"pan":"4111111111111111",
"expirydate":"12/2030",
"securitycode":"123",
"facilitatorid":"987654",
"facilitatorname":"FAC",
"submerchantid":"999999999999999",
"chargedescription":"Test Sub Mer Name",
"merchantstreet":"1 Test Street",
"merchantcity":"Test City",
"merchantzipcode":"TR45 6ST",
"merchantcountryiso2a":"GB"
}]
}
<requestblock version="3.67" >
<alias>webservices@example.com</alias>
<request type="AUTH">
<operation>
<sitereference>test_site12345</sitereference>
<accounttypedescription>MOTO</accounttypedescription>
</operation>
<merchant>
<facilitatorid>987654</facilitatorid>
<facilitatorname>FAC</facilitatorname>
<submerchantid>999999999999999</submerchantid>
<chargedescription>Test Sub Mer Name</chargedescription>
<merchantstreet>1 Test Street</merchantstreet>
<merchantcity>Test City</merchantcity>
<merchantzipcode>TR45 6ST</merchantzipcode>
<merchantcountryiso2a>GB</merchantcountryiso2a>
</merchant>
<billing>
<amount currencycode="GBP">1050</amount>
<payment type="VISA">
<expirydate>12/2030</expirydate>
<pan>4111111111111111</pan>
<securitycode>123</securitycode>
</payment>
</billing>
</request>
</requestblock>
Feldspezifikation
Alle unten aufgeführten Felder werden in der Antwort zurückgegeben, wenn sie an die erwerbende Bank weitergeleitet werden.
| Feld | Format | Beschreibung | |
| chargedescription XPath: /merchant/chargedescription |
Alphanumerisch einschließlich Leerzeichen und Sonderzeichen (25) |
Das Feld charge description ist ein Feld, das wir bei einer Transaktion an die Empfängerbank weitergeben. Sie müssen in diesem Feld die SubadresseName des Händlers eingeben. |
|
| expirydate XPath: /billing/payment/expirydate |
Datum MM/JJJJ | Das auf der Karte aufgedruckte Ablaufdatum. | |
| facilitatorid XPath: /merchant/facilitatorid |
Numerisch (11) |
Die von Visa/Mastercard zum Zeitpunkt der Registrierung zugewiesene Zahlungsvermittler-ID. Beachten Sie, dass über Visa und Mastercard separate IDs vergeben werden. |
|
|
|
facilitatorname XPath: /merchant/facilitatorname |
Alphanumerisch einschließlich Leerzeichen und Sonderzeichen (3, 7 oder 12) |
Der Name des Zahlungsabwicklers oder die mit Visa/Mastercard vereinbarte Abkürzung. (Dies erscheint auf den Kontoauszügen des Karteninhabers vor dem gesponserten UnterkontoName des Händlers , gefolgt von einem *-Zeichen. Z.B. "FAC*Test Sub Mer Name") |
|
|
merchantcity XPath: /merchant/merchantcity |
Alphanumerisch (13) |
Geförderte Unterhandelsstadt oder Stadt. |
|
|
merchantcountryiso2a XPath: /merchant/merchantcountryiso2a |
Alpha (2) |
Gesponserter ISO2A-Ländercode des Unterhändlers. Klicken Sie hier für eine vollständige Liste der Ländercodes. |
|
|
merchantstreet XPath: /merchant/merchantstreet |
Alphanumerisch (33) |
Gesponserte Adresse des Unterhändlers. |
|
|
merchantzipcode XPath: /merchant/merchantzipcode |
Alphanumerisch (10) |
Gesponserte Unterhändler-Postleitzahl oder Postleitzahl. Es muss sich um eine gültige Postleitzahl für den merchantcountryiso2a eingereicht werden. |
| pan XPath: /billing/payment/pan |
Numerisch (12-19) | Dies ist die lange Nummer, die auf der Vorderseite der Kundenkarte aufgedruckt ist. | |
|
|
submerchantid XPath: /merchant/submerchantid |
Alphanumerisch einschließlich Leerzeichen und Sonderzeichen (15) |
Kennung des gesponserten Unterhändlers, die vom Zahlungserleichterer zugewiesen wird. Muss für jeden gesponserten Unterhändler eindeutig sein. |
|
|
independentsalesorgid XPath: /merchant/independentsalesorgid |
Numerisch (11) |
Die von Mastercard bei der Registrierung zugewiesene ISO-ID (Independent Sales Organisation). |
| securitycode XPath: /billing/payment/securitycode |
Numerisch (3-4) |
Dies ist der 3-stellige Sicherheitscode, der auf der Rückseite der Karte aufgedruckt ist.
(Bei AMEX ist dies ein 4-stelliger Code, der sich auf der Vorderseite der Karte befindet) Dieses Feld ist für Trust Payments nicht unbedingt erforderlich, wird aber für die Verarbeitung von Sicherheitscodeprüfungen dringend empfohlen. Außerdem können einige Banken die Zahlung ablehnen, wenn der Sicherheitscode nicht vorhanden ist. |
Ähnliche Artikel
JavaScript Library
JavaScript Library ist eine Sammlung vorgefertigter Codes, die den Prozess der Annahme von Kartenzahlungen Ihrer Kunden vereinfacht.
AUTH Spezifikation
Dieser Artikel enthält Codebeispiele und Feldspezifikationen für Standardanfragen Autorisierung , die über unsere API Webservices verarbeitet werden.
