Der folgende Inhalt setzt voraus, dass Sie die erforderliche PCI-Zertifizierung erhalten haben, um sensible Karteninhaberdaten in der Anfrage an unsere Webservices API zu verarbeiten und zu übermitteln.
Lesen Sie diesen Artikel, um mehr zu erfahren.
Regeln können für einzelne JSON-Anfragen aktiviert werden, indem der eindeutige Regelbezeichner in das Feld ruleidentifier Feld. Die in der JSON-Anfrage angegebenen Regeln weisen unser System an, bestimmte Aktionen durchzuführen, wenn vordefinierte Kriterien erfüllt sind (unabhängig davon, ob die Regeln in MyST aktiviert wurden). Nachfolgend ein Beispiel für eine Anfrage, in der zwei Regeln STR-1 und UDR-23 angegeben 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",
"ruleidentifier": ["STR-1","UDR-23"]
}
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',
'ruleidentifier' => array('STR-1','UDR-23')
);
$api = \Securetrading\api($configData);
$response = $api->process($requestData);
var_dump($response->toArray());
?>
curl --user webservices@example.com:Password1^ https://webservices.securetrading.net/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",
"ruleidentifier": ["STR-1","UDR-23"]
}]}'
Regeln können nicht an untergeordnete Anforderungen vererbt werden.
Feldspezifikation
| Feld | Format | Beschreibung | |
 |
ruleidentifier XPath: /operation/rule/@identifier |
Alphanumerisch mit Bindestrichen | Wie in der obigen Beispielanfrage gezeigt, können Sie eindeutige Bezeichner für die auf diese Anfrage anzuwendenden Regeln übermitteln (z. B. STR-1). |
Wurde die Aktion durchgeführt?
Wenn eine Regel auf eine Anfrage angewandt wurde und die in der Bedingung angegebenen Kriterien erfüllt wurden, so dass die Aktion ausgelöst wurde, enthält die Antwort zusätzliche Felder zur Bestätigung, dass dies geschehen ist. In der folgenden Beispielantwort wurden zwei Regeln angewandt und die entsprechenden Aktionen ausgeführt.
Wenn eine Bedingung nicht erfüllt ist, wird die Aktion nicht ausgeführt und es werden keine zusätzlichen Felder in der Antwort zurückgegeben.
{
u 'requestreference': u 'A0bxh87wt',
u 'version': u '1.00',
u 'response': [{
u 'transactionstartedtimestamp': u '2016-12-07 11:32:44',
#### OTHER FIELDS NORMALLY RETURNED IN AUTH RESPONSE ####
u 'rules': [{
u 'ruleidentifier': u 'STR-1',
u 'ruledescription': u 'Auth security code not matched - Merchant decline'
}, {
u 'ruleidentifier': u 'UDR-23',
u 'ruledescription': u 'successful Visa AUTH - server 1'
}],
}]
}
array(3) {
["requestreference"] => string(9) "A3579dkvx"
["version"] => string(4) "1.00"
["response"] => array(1) {
[0] => array(27) {
#### OTHER FIELDS NORMALLY RETURNED IN AUTH RESPONSE ####
["rules"] => array(2) {
[0] => array(2) {
["ruleidentifier"] => string(5) "STR-1"
["ruledescription"] => string(49) "Auth security code not matched - Merchant decline"
}
[1] => array(2) {
["ruleidentifier"] => string(6) "UDR-23"
["ruledescription"] => string(31) "successful Visa AUTH - server 1"
}
}
}
}
}
{
"requestreference": "W23-fjgvn3d8",
"version": "1.00",
"response": [{
#### OTHER FIELDS NORMALLY RETURNED IN AUTH RESPONSE ####
"rules": [
{
"ruleidentifier": "STR-1",
"ruledescription": "Auth security code not matched - Merchant decline"
},
{
"ruleidentifier": "UDR-23",
"ruledescription": "successful Visa AUTH - server 1"
}
],
}],
"secrand": "zO9"
}
| Feld | Format | Beschreibung | |
 |
Regeln XPath: /operation/rule/@identifier |
Wurden Aktionen durchgeführt, werden die Regeln in der Antwort-JWT zurückgegeben. Sie enthält Informationen für jede Regel, in der eine Aktion durchgeführt wurde. |
|
|
ruleidentifier XPath: /operation/rule/@identifier |
Alphanumerisch mit Bindestrichen |
Für jede Regel, bei der eine Aktion durchgeführt wurde, wird der eindeutige Regelbezeichner (z. B. STR-1) in der Antwort-JWT zurückgegeben. Wird immer zurückgegeben, wenn eine Aktion ausgelöst wurde, ansonsten nicht. |
|
ruledescription XPath: /operation/rule/@identifier |
Alphanumerisch | Für jede Regel, bei der eine Aktion durchgeführt wurde, wird die Regelbeschreibung in der Antwort JWT zurückgegeben. Diese besteht aus dem Namen der Bedingung und dem Namen der Aktion in einer Zeichenkette, die beide durch einen Bindestrich getrennt sind, wie im obigen Antwortbeispiel gezeigt. |
