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.
Payouts werden verwendet, um Gelder auf ein anderes Bankkonto zu überweisen. Häufige Anwendungsfälle hierfür sind:
- Kunden die Möglichkeit geben, Geld von ihrem Konto abzuheben.
- Auszahlung eines Versicherungsanspruchs an einen Kunden.
Payouts sind auch als Credit Fund Transfers (CFT) oder Original Credit Transfers (OCT) bekannt.
Payouts an Visa-gekennzeichnete Karten werden über das Visa Direct-Protokoll verarbeitet.
Klicken Sie hier, um mehr zu erfahren.
Glücksspiele Payouts auf Mastercard-gekennzeichnete Karten werden über das Mastercard Gaming and Gambling Payments Program abgewickelt .
Klicken Sie hier, um mehr zu erfahren.
Nicht-Gaming-Karten Payouts zu Mastercard werden über das ProgrammMastercard MoneySend abgewickelt.
Klicken Sie hier, um mehr zu erfahren.
Voraussetzungen
Sie benötigen eine CFT Händlernummer, die mit Ihrem Trust Payments Konto verknüpft sein muss. Wenn Sie sich nicht sicher sind, ob Ihre Händlernummer dies unterstützt, empfehlen wir Ihnen, sich mit Ihrer Bank in Verbindung zu setzen, um dies zu klären. Vergewissern Sie sich außerdem, dass Sie alle von Ihrer Bank vorgegebenen Richtlinien befolgen, bevor Sie fortfahren.
Beispiele für Anfrage/Antwort
Um eine Payout zu verarbeiten, müssen Sie eine Payout Anfrage über unsere Webservices API übermitteln. Codebeispiele finden Sie unten.
Um eine Payout erfolgreich bearbeiten zu können, muss Ihr Antrag unbedingt folgende Angaben enthalten:
- accounttypedescription=CFT
- requesttypedescriptions=REFUND
Beispiel anfordern
#!/usr/bin/python
import securetrading
stconfig = securetrading.Config()
stconfig.username = "webservices@example.com"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)
payout= {
"accounttypedescription": "CFT",
"baseamount": "1",
"billingcountryiso2a": "GB",
"billingfirstname": "First",
"billinglastname": "Last",
"billingdob": "1990-01-01",
"currencyiso3a": "GBP",
"expirydate": "12/2030",
"pan": "411111******1111",
"requesttypedescriptions": ["REFUND"],
"sitereference": "site12346"
}
strequest = securetrading.Request()
strequest.update(payout)
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(
'accounttypedescription' => 'CFT',
'baseamount' => '1',
'billingcountryiso2a' => 'GB',
'billingfirstname' => 'First',
'billinglastname' => 'Last',
'billingdob' => '1990-01-01',
'currencyiso3a' => 'GBP',
'expirydate' => '12/2030',
'pan' => '411111******1111',
'requesttypedescriptions' => array('REFUND'),
'sitereference' => 'site12346'
);
$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": [{
"accounttypedescription": "CFT",
"baseamount": "1",
"billingcountryiso2a": "GB",
"billingfirstname": "First",
"billinglastname": "Last",
"billingdob": "1990-01-01",
"currencyiso3a": "GBP",
"expirydate": "12/2030",
"pan": "411111******1111",
"requesttypedescriptions": ["REFUND"],
"sitereference": "site12346"
}]
}'
{
"alias":"webservices@example.com",
"version":"1.00",
"request":[{
"accounttypedescription":"CFT",
"baseamount":"1",
"billingcountryiso2a": "GB",
"billingfirstname":"First",
"billinglastname":"Last",
"billingdob":"1990-01-01",
"currencyiso3a":"GBP",
"expirydate":"12/2030",
"pan":"411111******1111",
"requesttypedescriptions":["REFUND"],
"sitereference":"site12346"
}]
}
<requestblock version="3.67">
<alias>webservices@example.com</alias>
<request type="REFUND">
<billing>
<amount currencycode="GBP">1</amount>
<country>GB</country>
<dob>1990-01-01</dob>
<name>
<first>First</first>
<last>Last</last>
</name>
<payment>
<expirydate>12/2035</expirydate>
<pan>411111******1111</pan>
</payment>
</billing>
<operation>
<accounttypedescription>CFT</accounttypedescription>
<sitereference>site12346</sitereference>
</operation>
</request>
</requestblock>
Ersetzen Sie <DOMAIN> mit einer unterstützten Domäne. Klicken Sie hier für eine vollständige Liste.
Beispiel für eine Antwort
{
u 'requestreference': u 'Agv3epv31',
u 'version': u '1.00',
u 'responses': [{
u 'accounttypedescription': u 'CFT',
u 'acquirerresponsecode': u '00',
u 'acquirerresponsemessage': u 'Approved or completed Successfully',
u 'authcode': u 'ABC123',
u 'baseamount': u '1',
u 'chargedescription': u 'Charge description',
u 'cryptocurrencyindicator': u '0',
u 'currencyiso3a': u 'GBP',
u 'dccenabled': u '0',
u 'debtrepayment': u '0',
u 'errorcode': u '0',
u 'errormessage': u 'Ok',
u 'issuer': u 'ISSUER NAME',
u 'issuercountryiso2a': u 'GB',
u 'livestatus': u '1',
u 'maskedpan': u '411111######1111',
u 'merchantcategorycode': u '7995',
u 'merchantcity': u 'Test City',
u 'merchantcountryiso2a': u 'GB',
u 'merchantname': u 'Test Merchant',
u 'merchantnumber': u '000104900099999',
u 'merchantzipcode': u 'TR45 6ST',
u 'operatorname': u 'webservices@merchant.com',
u 'parenttransactionreference': u '60-102-99999999',
u 'paymenttypedescription': u 'VISA',
u 'requesttypedescription': u 'REFUND',
u 'retrievalreferencenumber': u '334918601688',
u 'securityresponseaddress': u '0',
u 'securityresponsepostcode': u '0',
u 'securityresponsesecuritycode': u '0',
u 'settleduedate': u '2023-12-15',
u 'settlestatus': u '100',
u 'stan': u '601688',
u 'transactionreference': u '60-70-99999999',
u 'transactionstartedtimestamp': u '2023-12-15 18:00:42'
}]
}
array(3) {
["requestreference"] => string(9) "A19beknpr"
["responses"] => array(1) {
[0] => array(35) {
["accounttypedescription"] => string(3) "CFT"
["acquirerresponsecode"] => string(2) "00"
["acquirerresponsemessage"] => string(34) "Approved or completed Successfully"
["authcode"] => string(6) "ABC123"
["baseamount"] => string(1) "1"
["chargedescription"] => string(18) "Charge description"
["cryptocurrencyindicator"] => string(1) "0"
["currencyiso3a"] => string(3) "GBP"
["dccenabled"] => string(1) "0"
["debtrepayment"] => string(1) "0"
["errorcode"] => string(1) "0"
["errormessage"] => string(2) "Ok"
["issuer"] => string(11) "ISSUER NAME"
["issuercountryiso2a"] => string(2) "GB"
["livestatus"] => string(1) "1"
["maskedpan"] => string(16) "411111######1111"
["merchantcategorycode"] => string(4) "7995"
["merchantcity"] => string(9) "Test City"
["merchantcountryiso2a"] => string(2) "GB"
["merchantname"] => string(13) "Test Merchant"
["merchantnumber"] => string(15) "000104900099999"
["merchantzipcode"] => string(8) "TR45 6ST"
["operatorname"] => string(24) "webservices@merchant.com"
["parenttransactionreference"] => string(15) "60-102-99999999"
["paymenttypedescription"] => string(4) "VISA"
["requesttypedescription"] => string(6) "REFUND"
["retrievalreferencenumber"] => string(12) "334918601688"
["securityresponseaddress"] => string(1) "0"
["securityresponsepostcode"] => string(1) "0"
["securityresponsesecuritycode"] => string(1) "0"
["settleduedate"] => string(10) "2023-12-15"
["settlestatus"] => string(3) "100"
["stan"] => string(6) "601688"
["transactionreference"] => string(14) "60-70-99999999"
["transactionstartedtimestamp"] => string(19) "2023-12-15 18:00:42"
}
}
["version"] => string(4) "1.00"
}
{
"requestreference": "W57-Ncn48qwu",
"response": [{
"accounttypedescription": "CFT",
"acquirerresponsecode": "00",
"acquirerresponsemessage": "Approved or completed Successfully",
"authcode": "ABC123",
"baseamount": "1",
"chargedescription": "Charge description",
"cryptocurrencyindicator": "0",
"currencyiso3a": "GBP",
"dccenabled": "0",
"debtrepayment": "0",
"errorcode": "0",
"errormessage": "Ok",
"issuer": "ISSUER NAME",
"issuercountryiso2a": "GB",
"livestatus": "1",
"maskedpan": "411111######1111",
"merchantcategorycode": "7995",
"merchantcity": "Test City",
"merchantcountryiso2a": "GB",
"merchantname": "Test Merchant",
"merchantnumber": "000104900099999",
"merchantzipcode": "TR45 6ST",
"operatorname": "webservices@merchant.com",
"parenttransactionreference": "60-102-99999999",
"paymenttypedescription": "VISA",
"requesttypedescription": "REFUND",
"retrievalreferencenumber": "334918601688",
"securityresponseaddress": "0",
"securityresponsepostcode": "0",
"securityresponsesecuritycode": "0",
"settleduedate": "2023-12-15",
"settlestatus": "100",
"stan": "601688",
"transactionreference": "60-70-99999999",
"transactionstartedtimestamp": "2023-12-15 18:00:42"
}],
"secrand": "nN",
"version": "1.00"
}
<responseblock version="3.67">
<requestreference>W57-6yBtc6n0</requestreference>
<response type="REFUND">
<acquirerresponsecode>00</acquirerresponsecode>
<acquirerresponsemessage>Approved or completed Successfully</acquirerresponsemessage>
<authcode>ABC123</authcode>
<billing>
<amount currencycode="GBP">1</amount>
<dcc enabled="0"/>
<payment type="VISA">
<issuer>ISSUER NAME</issuer>
<issuercountry>GB</issuercountry>
<pan>411111######1111</pan>
</payment>
</billing>
<error>
<code>0</code>
<message>Ok</message>
</error>
<live>1</live>
<merchant>
<chargedescription>Charge description</chargedescription>
<debtrepayment>0</debtrepayment>
<merchantcategorycode>7995</merchantcategorycode>
<merchantcity>Test City</merchantcity>
<merchantcountryiso2a>GB</merchantcountryiso2a>
<merchantname>Test Merchant</merchantname>
<merchantnumber>000104900099999</merchantnumber>
<merchantzipcode>TR45 6ST</merchantzipcode>
<operatorname>webservices@merchant.com</operatorname>
</merchant>
<operation>
<accounttypedescription>CFT</accounttypedescription>
<cryptocurrencyindicator>0</cryptocurrencyindicator>
<parenttransactionreference>60-102-99999999</parenttransactionreference>
</operation>
<other>
<retrievalreferencenumber>335212345678</retrievalreferencenumber>
<stan>575503</stan>
</other>
<security>
<address>0</address>
<postcode>0</postcode>
<securitycode>0</securitycode>
</security>
<settlement>
<settleduedate>2023-12-18</settleduedate>
<settlestatus>100</settlestatus>
</settlement>
<timestamp>2023-12-18 15:55:59</timestamp>
<transactionreference>57-70-73675503</transactionreference>
</response>
<secrand>cWq80RAf8JgxC1dv</secrand>
</responseblock>
Beispiel anfordern
#!/usr/bin/python
import securetrading
stconfig = securetrading.Config()
stconfig.username = "webservices@example.com"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)
payout= {
"accounttypedescription": "CFT",
"baseamount": "1",
"billingcountryiso2a": "GB",
"billingdob": "1990-12-02",
"billingfirstname": "First",
"billinglastname": "Last",
"currencyiso3a": "GBP",
"expirydate": "12/2030",
"pan": "545454******5454",
"requesttypedescriptions": ["REFUND"],
"sitereference": "site12346",
"transactiontypeindicator": "C55"
}
strequest = securetrading.Request()
strequest.update(payout)
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(
'accounttypedescription' => 'CFT',
'baseamount' => '1',
'billingcountryiso2a' => 'GB',
'billingdob' => '1990-12-02',
'billingfirstname' => 'First',
'billinglastname' => 'Last',
'currencyiso3a' => 'GBP',
'expirydate' => '12/2030',
'pan' => '545454******5454',
'requesttypedescriptions' => array('REFUND'),
'sitereference' => 'site12346',
'transactiontypeindicator' => 'C55'
);
$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": [{
"accounttypedescription": "CFT",
"baseamount": "1",
"billingcountryiso2a": "GB",
"billingdob": "1990-12-02",
"billingfirstname": "First",
"billinglastname": "Last",
"currencyiso3a": "GBP",
"expirydate": "12/2030",
"pan": "545454******5454",
"requesttypedescriptions": ["REFUND"],
"sitereference": "site12346",
"transactiontypeindicator": "C55"
}]
}'
{
"alias":"webservices@example.com",
"version":"1.00",
"request":[{
"accounttypedescription":"CFT",
"baseamount":"1",
"billingcountryiso2a": "GB",
"billingdob":"1990-12-02",
"billingfirstname":"First",
"billinglastname":"Last",
"currencyiso3a":"GBP",
"expirydate":"12/2030",
"pan":"545454******5454",
"requesttypedescriptions":["REFUND"],
"sitereference":"site12346",
"transactiontypeindicator":"C55"
}]
}
<requestblock version="3.67">
<alias>webservices@example.com</alias>
<request type="REFUND">
<billing>
<amount currencycode="GBP">1</amount>
<country>GB</country>
<dob>1990-01-01</dob>
<name>
<first>First</first>
<last>Last</last>
</name>
<payment>
<expirydate>12/2035</expirydate>
<pan>545454******5454</pan>
</payment>
</billing>
<merchant>
<transactiontypeindicator>C55</transactiontypeindicator>
</merchant>
<operation>
<accounttypedescription>CFT</accounttypedescription>
<sitereference>site12346</sitereference>
</operation>
</request>
</requestblock>
Ersetzen Sie <DOMAIN> mit einer unterstützten Domäne. Klicken Sie hier für eine vollständige Liste.
Beispiel für eine Antwort
{
u 'requestreference': u 'Agv3epv31',
u 'version': u '1.00',
u 'responses': [{
u 'accounttypedescription': u 'CFT',
u 'acquirerresponsecode': u '00',
u 'acquirerresponsemessage': u 'Approved or completed Successfully',
u 'authcode': u 'ABC123',
u 'baseamount': u '1',
u 'chargedescription': u 'Charge description',
u 'cryptocurrencyindicator': u '0',
u 'currencyiso3a': u 'GBP',
u 'dccenabled': u '0',
u 'debtrepayment': u '0',
u 'errorcode': u '0',
u 'errormessage': u 'Ok',
u 'issuer': u 'ISSUER NAME',
u 'issuercountryiso2a': u 'GB',
u 'livestatus': u '1',
u 'maskedcustomeraccountnumber': u '12345678',
u 'maskedpan': u '545454######5454',
u 'merchantcategorycode': u '6537',
u 'merchantcity': u 'Test City',
u 'merchantcountryiso2a': u 'GB',
u 'merchantname': u 'Test Merchant',
u 'merchantnumber': u '000123456789012',
u 'merchantzipcode': u 'TR45 6ST',
u 'operatorname': u 'webservices@merchant.com',
u 'parenttransactionreference': u '60-102-99999999',
u 'paymenttypedescription': u 'MASTERCARD',
u 'requesttypedescription': u 'REFUND',
u 'retrievalreferencenumber': u '334918601688',
u 'securityresponseaddress': u '0',
u 'securityresponsepostcode': u '0',
u 'securityresponsesecuritycode': u '0',
u 'settleduedate': u '2023-12-15',
u 'settlestatus': u '10',
u 'stan': u '601688',
u 'transactionreference': u '60-70-99999999',
u 'transactionstartedtimestamp': u '2023-12-15 18:00:42',
u 'transactiontypeindicator': u 'C55'
}]
}
array(3) {
["requestreference"] => string(9) "A19beknpr"
["responses"] => array(1) {
[0] => array(37) {
["accounttypedescription"] => string(3) "CFT"
["acquirerresponsecode"] => string(2) "00"
["acquirerresponsemessage"] => string(34) "Approved or completed Successfully"
["authcode"] => string(6) "ABC123"
["baseamount"] => string(1) "1"
["chargedescription"] => string(18) "Charge description"
["cryptocurrencyindicator"] => string(1) "0"
["currencyiso3a"] => string(3) "GBP"
["dccenabled"] => string(1) "0"
["debtrepayment"] => string(1) "0"
["errorcode"] => string(1) "0"
["errormessage"] => string(2) "Ok"
["issuer"] => string(11) "ISSUER NAME"
["issuercountryiso2a"] => string(2) "GB"
["livestatus"] => string(1) "1"
["maskedcustomeraccountnumber"] => string(8) "12345678"
["maskedpan"] => string(16) "545454######5454"
["merchantcategorycode"] => string(4) "6537"
["merchantcity"] => string(9) "Test City"
["merchantcountryiso2a"] => string(2) "GB"
["merchantname"] => string(13) "Test Merchant"
["merchantnumber"] => string(15) "000123456789012"
["merchantzipcode"] => string(8) "TR45 6ST"
["operatorname"] => string(24) "webservices@merchant.com"
["parenttransactionreference"] => string(15) "60-102-99999999"
["paymenttypedescription"] => string(10) "MASTERCARD"
["requesttypedescription"] => string(6) "REFUND"
["retrievalreferencenumber"] => string(12) "334918601688"
["securityresponseaddress"] => string(1) "0"
["securityresponsepostcode"] => string(1) "0"
["securityresponsesecuritycode"] => string(1) "0"
["settleduedate"] => string(10) "2023-12-15"
["settlestatus"] => string(2) "10"
["stan"] => string(6) "601688"
["transactionreference"] => string(14) "60-70-99999999"
["transactionstartedtimestamp"] => string(19) "2023-12-15 18:00:42"
["transactiontypeindicator"] => string(3) "C55"
}
}
["version"] => string(4) "1.00"
}
{
"requestreference": "W60-B6c1u7bY",
"response": [{
"accounttypedescription": "CFT",
"acquirerresponsecode": "00",
"acquirerresponsemessage": "Approved or completed Successfully",
"authcode": "ABC123",
"baseamount": "1",
"chargedescription": "Charge description",
"cryptocurrencyindicator": "0",
"currencyiso3a": "GBP",
"dccenabled": "0",
"debtrepayment": "0",
"errorcode": "0",
"errormessage": "Ok",
"issuer": "ISSUER NAME",
"issuercountryiso2a": "GB",
"livestatus": "1",
"maskedcustomeraccountnumber": "12345678",
"maskedpan": "545454######5454",
"merchantcategorycode": "6537",
"merchantcity": "Test City",
"merchantcountryiso2a": "GB",
"merchantname": "Test Merchant",
"merchantnumber": "000123456789012",
"merchantzipcode": "TR45 6ST",
"operatorname": "webservices@merchant.com",
"parenttransactionreference": "60-102-99999999",
"paymenttypedescription": "MASTERCARD",
"requesttypedescription": "REFUND",
"retrievalreferencenumber": "334918601688",
"securityresponseaddress": "0",
"securityresponsepostcode": "0",
"securityresponsesecuritycode": "0",
"settleduedate": "2023-12-15",
"settlestatus": "10",
"stan": "601688",
"transactionreference": "60-70-99999999",
"transactionstartedtimestamp": "2023-12-15 18:00:42",
"transactiontypeindicator": "C55"
}],
"secrand": "nN",
"version": "1.00"
}
<responseblock version="3.67">
<requestreference>W60-1Yj4kh3A</requestreference>
<response type="REFUND">
<acquirerresponsecode>00</acquirerresponsecode>
<acquirerresponsemessage>Approved or completed Successfully</acquirerresponsemessage>
<authcode>ABC123</authcode>
<billing>
<amount currencycode="GBP">1</amount>
<dcc enabled="0"/>
<payment type="MASTERCARD">
<issuer>ISSUER NAME</issuer>
<issuercountry>GB</issuercountry>
<pan>545454######5454</pan>
</payment>
</billing>
<customer>
<accountnumber type="ACCOUNT">999999</accountnumber>
</customer>
<error>
<code>0</code>
<message>Ok</message>
</error>
<live>1</live>
<merchant>
<chargedescription>Charge description</chargedescription>
<debtrepayment>0</debtrepayment>
<merchantcategorycode>6537</merchantcategorycode>
<merchantcity>Test City</merchantcity>
<merchantcountryiso2a>GB</merchantcountryiso2a>
<merchantname>Test Merchant</merchantname>
<merchantnumber>000104900099999</merchantnumber>
<merchantzipcode>TR45 6ST</merchantzipcode>
<operatorname>webservices@merchant.com</operatorname>
<transactiontypeindicator>C55</transactiontypeindicator>
</merchant>
<operation>
<accounttypedescription>CFT</accounttypedescription>
<cryptocurrencyindicator>0</cryptocurrencyindicator>
<parenttransactionreference>60-102-99999999</parenttransactionreference>
</operation>
<other>
<retrievalreferencenumber>335212345678</retrievalreferencenumber>
<stan>607892</stan>
</other>
<security>
<address>0</address>
<postcode>0</postcode>
<securitycode>0</securitycode>
</security>
<settlement>
<settleduedate>2023-12-18</settleduedate>
<settlestatus>10</settlestatus>
</settlement>
<timestamp>2023-12-18 15:51:25</timestamp>
<transactionreference>60-70-99999999</transactionreference>
</response>
<secrand>8A8Rzl2O</secrand>
</responseblock>
Beispiel anfordern
#!/usr/bin/python
import securetrading
stconfig = securetrading.Config()
stconfig.username = "webservices@example.com"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)
payout= {
"accounttypedescription": "CFT",
"baseamount": "1",
"billingdob": "1990-12-02",
"billingfirstname": "First",
"billinglastname": "Last",
"cftsourceoffunds": "05",
"currencyiso3a": "GBP",
"customeraccountnumber": "999999",
"customeraccountnumbertype": "ACCOUNT",
"customerfirstname": "First",
"customerlastname": "Last",
"customerstreet": "123 Street",
"customertown": "Town",
"customercountryiso2a": "GB",
"expirydate": "12/2030",
"pan": "545454******5454",
"requesttypedescriptions": ["REFUND"],
"sitereference": "site12346",
"transactiontypeindicator": "C52"
}
strequest = securetrading.Request()
strequest.update(payout)
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(
'accounttypedescription' => 'CFT',
'baseamount' => '1',
'billingdob' => '1990-12-02',
'billingfirstname' => 'First',
'billinglastname' => 'Last',
'cftsourceoffunds' => '05',
'currencyiso3a' => 'GBP',
'customeraccountnumber' => '999999',
'customeraccountnumbertype' => 'ACCOUNT',
'customerfirstname' => 'First',
'customerlastname' => 'Last',
'customerstreet' => '123 Street',
'customertown' => 'Town',
'customercountryiso2a' => 'GB',
'expirydate' => '12/2030',
'pan' => '545454******5454',
'requesttypedescriptions' => array('REFUND'),
'sitereference' => 'site12346',
'transactiontypeindicator' => 'C52'
);
$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": [{
"accounttypedescription": "CFT",
"baseamount": "1",
"billingdob": "1990-12-02",
"billingfirstname": "First",
"billinglastname": "Last",
"cftsourceoffunds": "05",
"currencyiso3a": "GBP",
"customeraccountnumber": "999999",
"customeraccountnumbertype": "ACCOUNT",
"customerfirstname": "First",
"customerlastname": "Last",
"customerstreet": "123 Street",
"customertown": "Town",
"customercountryiso2a": "GB",
"expirydate": "12/2030",
"pan": "545454******5454",
"requesttypedescriptions": ["REFUND"],
"sitereference": "site12346",
"transactiontypeindicator": "C52"
}]
}'
{
"alias":"webservices@example.com",
"version":"1.00",
"request":[{
"accounttypedescription":"CFT",
"baseamount":"1",
"billingdob":"1990-12-02",
"billingfirstname":"First",
"billinglastname":"Last",
"cftsourceoffunds":"05",
"currencyiso3a":"GBP",
"customeraccountnumber":"999999",
"customeraccountnumbertype":"ACCOUNT",
"customerfirstname":"First",
"customerlastname":"Last",
"customerstreet":"123 Street",
"customertown":"Town",
"customercountryiso2a":"GB",
"expirydate":"12/2030",
"pan":"545454******5454",
"requesttypedescriptions":["REFUND"],
"sitereference":"site12346",
"transactiontypeindicator":"C52"
}]
}
<requestblock version="3.67">
<alias>webservices@example.com</alias>
<request type="REFUND">
<billing>
<amount currencycode="GBP">1</amount>
<country>GB</country>
<dob>1990-01-01</dob>
<name>
<first>First</first>
<last>Last</last>
</name>
<payment>
<expirydate>12/2035</expirydate>
<pan>545454******5454</pan>
</payment>
</billing>
<customer>
<accountnumber type="ACCOUNT">999999</accountnumber>
<country>GB</country>
<name>
<first>First</first>
<last>Last</last>
</name>
<street>123 Street</street>
<town>Town</town>
</customer>
<merchant>
<cftsourceoffunds>05</cftsourceoffunds>
<transactiontypeindicator>C52</transactiontypeindicator>
</merchant>
<operation>
<accounttypedescription>CFT</accounttypedescription>
<sitereference>site12346</sitereference>
</operation>
</request>
</requestblock>
Ersetzen Sie <DOMAIN> mit einer unterstützten Domäne. Klicken Sie hier für eine vollständige Liste.
Beispiel für eine Antwort
{
u 'requestreference': u 'Agv3epv31',
u 'version': u '1.00',
u 'responses': [{
u 'accounttypedescription': u 'CFT',
u 'acquirerresponsecode': u '00',
u 'acquirerresponsemessage': u 'Approved or completed Successfully',
u 'authcode': u 'ABC123',
u 'baseamount': u '1',
u 'chargedescription': u 'Charge description',
u 'cryptocurrencyindicator': u '0',
u 'currencyiso3a': u 'GBP',
u 'dccenabled': u '0',
u 'debtrepayment': u '0',
u 'errorcode': u '0',
u 'errormessage': u 'Ok',
u 'issuer': u 'ISSUER NAME',
u 'issuercountryiso2a': u 'GB',
u 'livestatus': u '1',
u 'maskedcustomeraccountnumber': u '12345678',
u 'maskedpan': u '545454######5454',
u 'merchantcategorycode': u '6537',
u 'merchantcity': u 'Test City',
u 'merchantcountryiso2a': u 'GB',
u 'merchantname': u 'Test Merchant',
u 'merchantnumber': u '000123456789012',
u 'merchantzipcode': u 'TR45 6ST',
u 'operatorname': u 'webservices@merchant.com',
u 'parenttransactionreference': u '60-102-99999999',
u 'paymenttypedescription': u 'MASTERCARD',
u 'requesttypedescription': u 'REFUND',
u 'retrievalreferencenumber': u '334918601688',
u 'securityresponseaddress': u '0',
u 'securityresponsepostcode': u '0',
u 'securityresponsesecuritycode': u '0',
u 'settleduedate': u '2023-12-15',
u 'settlestatus': u '10',
u 'stan': u '601688',
u 'transactionreference': u '60-70-99999999',
u 'transactionstartedtimestamp': u '2023-12-15 18:00:42',
u 'transactiontypeindicator': u 'C52'
}]
}
array(3) {
["requestreference"] => string(9) "A19beknpr"
["responses"] => array(1) {
[0] => array(37) {
["accounttypedescription"] => string(3) "CFT"
["acquirerresponsecode"] => string(2) "00"
["acquirerresponsemessage"] => string(34) "Approved or completed Successfully"
["authcode"] => string(6) "ABC123"
["baseamount"] => string(1) "1"
["chargedescription"] => string(18) "Charge description"
["cryptocurrencyindicator"] => string(1) "0"
["currencyiso3a"] => string(3) "GBP"
["dccenabled"] => string(1) "0"
["debtrepayment"] => string(1) "0"
["errorcode"] => string(1) "0"
["errormessage"] => string(2) "Ok"
["issuer"] => string(11) "ISSUER NAME"
["issuercountryiso2a"] => string(2) "GB"
["livestatus"] => string(1) "1"
["maskedcustomeraccountnumber"] => string(8) "12345678"
["maskedpan"] => string(16) "545454######5454"
["merchantcategorycode"] => string(4) "6537"
["merchantcity"] => string(9) "Test City"
["merchantcountryiso2a"] => string(2) "GB"
["merchantname"] => string(13) "Test Merchant"
["merchantnumber"] => string(15) "000123456789012"
["merchantzipcode"] => string(8) "TR45 6ST"
["operatorname"] => string(24) "webservices@merchant.com"
["parenttransactionreference"] => string(15) "60-102-99999999"
["paymenttypedescription"] => string(10) "MASTERCARD"
["requesttypedescription"] => string(6) "REFUND"
["retrievalreferencenumber"] => string(12) "334918601688"
["securityresponseaddress"] => string(1) "0"
["securityresponsepostcode"] => string(1) "0"
["securityresponsesecuritycode"] => string(1) "0"
["settleduedate"] => string(10) "2023-12-15"
["settlestatus"] => string(2) "10"
["stan"] => string(6) "601688"
["transactionreference"] => string(14) "60-70-99999999"
["transactionstartedtimestamp"] => string(19) "2023-12-15 18:00:42"
["transactiontypeindicator"] => string(3) "C52"
}
}
["version"] => string(4) "1.00"
}
{
"requestreference": "W60-B6c1u7bY",
"response": [{
"accounttypedescription": "CFT",
"acquirerresponsecode": "00",
"acquirerresponsemessage": "Approved or completed Successfully",
"authcode": "ABC123",
"baseamount": "1",
"chargedescription": "Charge description",
"cryptocurrencyindicator": "0",
"currencyiso3a": "GBP",
"dccenabled": "0",
"debtrepayment": "0",
"errorcode": "0",
"errormessage": "Ok",
"issuer": "ISSUER NAME",
"issuercountryiso2a": "GB",
"livestatus": "1",
"maskedcustomeraccountnumber": "12345678",
"maskedpan": "545454######5454",
"merchantcategorycode": "6537",
"merchantcity": "Test City",
"merchantcountryiso2a": "GB",
"merchantname": "Test Merchant",
"merchantnumber": "000123456789012",
"merchantzipcode": "TR45 6ST",
"operatorname": "webservices@merchant.com",
"parenttransactionreference": "60-102-99999999",
"paymenttypedescription": "MASTERCARD",
"requesttypedescription": "REFUND",
"retrievalreferencenumber": "334918601688",
"securityresponseaddress": "0",
"securityresponsepostcode": "0",
"securityresponsesecuritycode": "0",
"settleduedate": "2023-12-15",
"settlestatus": "10",
"stan": "601688",
"transactionreference": "60-70-99999999",
"transactionstartedtimestamp": "2023-12-15 18:00:42",
"transactiontypeindicator": "C52"
}],
"secrand": "nN",
"version": "1.00"
}
<responseblock version="3.67">
<requestreference>W60-1Yj4kh3A</requestreference>
<response type="REFUND">
<acquirerresponsecode>00</acquirerresponsecode>
<acquirerresponsemessage>Approved or completed Successfully</acquirerresponsemessage>
<authcode>ABC123</authcode>
<billing>
<amount currencycode="GBP">1</amount>
<dcc enabled="0"/>
<payment type="MASTERCARD">
<issuer>ISSUER NAME</issuer>
<issuercountry>GB</issuercountry>
<pan>545454######5454</pan>
</payment>
</billing>
<customer>
<accountnumber type="ACCOUNT">999999</accountnumber>
</customer>
<error>
<code>0</code>
<message>Ok</message>
</error>
<live>1</live>
<merchant>
<chargedescription>Charge description</chargedescription>
<debtrepayment>0</debtrepayment>
<merchantcategorycode>6537</merchantcategorycode>
<merchantcity>Test City</merchantcity>
<merchantcountryiso2a>GB</merchantcountryiso2a>
<merchantname>Test Merchant</merchantname>
<merchantnumber>000104900099999</merchantnumber>
<merchantzipcode>TR45 6ST</merchantzipcode>
<operatorname>webservices@merchant.com</operatorname>
<transactiontypeindicator>C52</transactiontypeindicator>
</merchant>
<operation>
<accounttypedescription>CFT</accounttypedescription>
<cryptocurrencyindicator>0</cryptocurrencyindicator>
<parenttransactionreference>60-102-99999999</parenttransactionreference>
</operation>
<other>
<retrievalreferencenumber>335212345678</retrievalreferencenumber>
<stan>607892</stan>
</other>
<security>
<address>0</address>
<postcode>0</postcode>
<securitycode>0</securitycode>
</security>
<settlement>
<settleduedate>2023-12-18</settleduedate>
<settlestatus>10</settlestatus>
</settlement>
<timestamp>2023-12-18 15:51:25</timestamp>
<transactionreference>60-70-99999999</transactionreference>
</response>
<secrand>8A8Rzl2O</secrand>
</responseblock>
Payout Feldspezifikation
Payout Spezifikation des Anfragefeldes
|
Feld |
Format | Beschreibung | ||
| accounttypedescription XPath: /operation/accounttypedescription |
Alpha (20) | Muss "CFT" lauten. | ||
| baseamount XPath: /Rechnung/Betrag |
Numerisch (13) |
Der Erstattungsbetrag in Basiseinheiten, ohne Kommas oder Dezimalpunkte. z.B. €10,99 würde als "1099" übermittelt werden, aber ¥246 würde als "246" übermittelt werden. |
||
| billingcountryiso2a XPath: /abrechnung/land |
Alpha (2) |
Das Land, in dem die Rechnungsadresse des Empfängers liegt. Diese muss im ISO2A-Format angegeben werden. Klicken Sie hier für eine vollständige Liste der Ländercodes. Erforderlich bei der Bearbeitung von Payouts , wenn Trust Payments ein PEP oder ein Sanktionsscreening des Empfängers durchführt. Hinweis: Es wird kein ungültiges Feld zurückgegeben, wenn dieses erforderliche Feld nicht enthalten ist. |
||
| billingdob XPath: /abrechnung/dob |
Datum JJJJ-MM-TT |
Das Geburtsdatum des Empfängers. Erforderlich bei der Bearbeitung von Payouts , wenn Trust Payments ein PEP oder ein Sanktionsscreening des Empfängers durchführt. Hinweis: Ein ungültiges Feld wird zurückgegeben, wenn dieses erforderliche Feld nicht enthalten ist und das verwendete Website-Referenz für MoneySend aktiviert ist. |
||
| billingfirstname XPath: /abrechnung/name/erste |
Alphanumerisch einschließlich Symbole (127) |
Die Adresse des Empfängers lautet Rechnungsvorname. Erforderlich bei der Bearbeitung von Payouts , wenn Trust Payments ein PEP oder ein Sanktionsscreening des Empfängers durchführt. Hinweis: Ein ungültiges Feld wird zurückgegeben, wenn dieses erforderliche Feld nicht enthalten ist und das verwendete sitereference für MoneySend aktiviert ist. |
||
| billinglastname XPath: /abrechnung/name/last |
Alphanumerisch einschließlich Symbole (127) |
Die Adresse des Empfängers lautet Rechnungsnachname. Erforderlich bei der Bearbeitung von Payouts , wenn Trust Payments ein PEP oder ein Sanktionsscreening des Empfängers durchführt. Hinweis: Ein ungültiges Feld wird zurückgegeben, wenn dieses erforderliche Feld nicht enthalten ist und das verwendete sitereference für MoneySend aktiviert ist. |
||
| currencyiso3a XPath: /Rechnung/Betrag/@Währungscode |
Alpha (3) |
Die Währung , in der die Transaktion abgewickelt werden soll. Klicken Sie hier für eine vollständige Liste der verfügbaren Währungen. |
||
| requesttypedescriptions XPath: /@type |
Alphanumerisch & Bindestriche (25) |
Die erforderliche Anforderungstyp ist "REFUND". | ||
| sitereference XPath: /operation/sitereference |
Alphanumerisch & Unterstrich (50) |
Eine eindeutige Referenz, die Ihr Konto identifiziert. Sie erhalten diese, wenn Sie sich zum ersten Mal bei uns anmelden. | ||
| billingcounty XPath: /abrechnung/landkreis |
Alphanumerisch einschließlich Symbole (127) |
Der Bezirk, in dem die Rechnungsadresse des Empfängers liegt. Bei US-amerikanischen und kanadischen Adressen ist der zweistellige Provinzcode anzugeben, z. B. für British Columbia "BC". Erforderlich für Visa Direktzahlungen, die mit in Kanada ausgestellten Karten verarbeitet werden. Erforderlich für Mastercard MoneySend Zahlungen, bei denen das Empfängerland (billingcountryiso2a) "US" (Vereinigte Staaten) oder "CA" (Kanada) ist. |
||
| billingstreet XPath: /Rechnung/Straße |
Alphanumerisch einschließlich Symbole (127) |
Die Straße, die für die Rechnungsadresse des Empfängers eingegeben wurde. Erforderlich für Visa Direktzahlungen, die mit in Kanada ausgestellten Karten verarbeitet werden. |
||
| billingtown XPath: /abrechnung/stadt |
Alphanumerisch einschließlich Symbole (127) |
Der Ort, der für die Rechnungsadresse des Empfängers eingegeben wurde. Erforderlich für Visa Direktzahlungen, die mit in Kanada ausgestellten Karten verarbeitet werden. |
||
|
Felder für Fondsüberweisungen Für Mastercard Zahlungen mit transactiontypeindicator = "C52": ALLE Felder hier sind erforderlich. |
||||
| | cftsourceoffunds XPath: /merchant/cftsourceoffunds |
Numerisch (2) |
Quelle der Mittel für die Payout. "01" - Kredit |
|
| | customeraccountnumbertype XPath: /customer/accountnumber/@type |
Alpha (7) |
Einreichen entweder "CARD" oder "ACCOUNT". |
|
| customeraccountnumber XPath: /customer/accountnumber |
Numerisch (20) |
Wenn customeraccountnumbertype ist "ACCOUNT"geben Sie die Kontonummer des Absenders an. Wenn customeraccountnumbertype ist "CARD"geben Sie die Kartennummer des Absenders an. |
||
|
Kontaktfelder des Absenders Für Mastercard Zahlungen mit transactiontypeindicator = "C52": ALLE Felder hier sind erforderlich. |
||||
| | customercountryiso2a XPath: /customer/country |
Alpha (2) |
Das Land des Absenders im ISO2A-Format. |
|
| | customercounty XPath: /Kunde/Landkreis |
Alphanumerisch einschließlich Symbole (127) |
Der Landkreis für die Adresse des Absenders. Bei US-amerikanischen und kanadischen Adressen ist der zweistellige Provinzcode anzugeben, z. B. für British Columbia "BC". Erforderlich für Mastercard MoneySend Zahlungen, bei denen das Land des Absenders (customercountryiso2a) "US" (Vereinigte Staaten) oder "CA" (Kanada) ist. |
|
| | customerfirstname XPath: /customer/name/first |
Alphanumerisch einschließlich Symbole (127) |
Der Vorname des Absenders. |
|
| | customerlastname XPath: /customer/name/last |
Alphanumerisch einschließlich Symbole (127) |
Der Nachname des Absenders. |
|
| | customerpremise XPath: /Kunde/Vor-Ort |
Alphanumerisch einschließlich Symbole (25) |
Name/Nummer der Eigenschaft des Absenders. Fakultativ für Mastercard MoneySend Zahlungen , wenn customerstreet eingereicht wird. |
|
| | customerstreet XPath: /customer/street |
Alphanumerisch einschließlich Symbole (127) |
Der Straßenname des Absenders. Fakultativ für Mastercard MoneySend Zahlungen , wenn customerpremise eingereicht wird. |
|
| | customertown XPath: /customer/town |
Alphanumerisch einschließlich Symbole (127) |
Die Stadt des Absenders. |
|
| expirydate XPath: /abrechnung/zahlung/expirydate |
Datum MM/JJJJ |
Das Ablaufdatum der Karte. Erforderlich, wenn pan eingereicht wird. Fakultativ, wenn parenttransactionreference eingereicht wird. |
||
| pan XPath: /abrechnung/zahlung/pan |
Numerisch (12-19) |
Die Kartennummer des Kunden. Erforderlich, wenn parenttransactionreference NICHT eingereicht wird. |
||
| parenttransactionreference XPath: /operation/parenttransactionreference |
Alphanumerisch & Bindestriche (25) |
Senden Sie die Transaktionsnummer einer früheren AUTH, ACCOUNTCHECK oder Payout (CFT REFUND ) Anfrage und wir werden die in unseren Unterlagen gespeicherte Karte des Kunden abrufen und den Betrag auf diese Karte gutschreiben. Alle Felder, die mit "billing-" und "customer-", wird auch von der übergeordneten Anfrage geerbt, falls vorhanden. Vererbte Felder müssen in dieser neuen Anfrage Payout nicht enthalten sein (auch wenn sie in dieser Spezifikation als erforderlich bezeichnet werden), aber Sie haben immer noch die Möglichkeit, neue Abrechnungs- und Kundenfelder zu übermitteln, die dann alle vererbten Daten außer Kraft setzen. Erforderlich, wenn pan NICHT eingereicht wird. |
||
| transactiontypeindicator XPath: /merchant/transactiontypeindicator |
Alphanumerisch (3) |
Gibt die Mastercard MoneySend Transaktionsart an - Unterstützte Werte:
Erforderlich auf Mastercard für alle MoneySend Zahlungstransaktionen. Hinweis: Eine ungültige Feldantwort wird zurückgegeben, wenn dieses erforderliche Feld für die Zahlungsarten Mastercard nicht enthalten ist und die verwendete sitereference für MoneySend aktiviert ist. |
||
| billingpremise XPath: /abrechnung/premise |
Alphanumerisch einschließlich Symbole (25) |
Der Name/die Nummer der Immobilie für die Rechnungsadresse des Empfängers. |
||
| orderreference XPath: /merchant/orderreference |
Alphanumerisch einschließlich Symbole (25) |
Es wird dringend empfohlen, eine eindeutige Referenz zur Identifizierung jedes eingereichten Antrags zu übermitteln. |
||
Payout Antwortfeld-Spezifikation
| Feld | Format | Beschreibung | |
| accounttypedescription XPath: /operation/accounttypedescription |
Alpha (20) |
"CFT" wird in der Antwort zurückgegeben. |
|
| baseamount XPath: /billing/amount |
Numerisch (13) | Der Erstattungsbetrag in Basiseinheiten, ohne Kommas oder Dezimalpunkte. z.B. €10,99 würde als "1099" übermittelt werden, aber ¥246 würde als "246" übermittelt werden. | |
| chargedescription XPath: /merchant/chargedescription |
Alphanumerisch einschließlich Leerzeichen und Sonderzeichen (25) |
charge description ist ein Feld, das wir der erwerbenden Bank während einer Transaktion zur Verfügung stellen. Es handelt sich um eine grundlegende Beschreibung der Transaktion, die auf dem Kontoauszug des Kunden angezeigt wird. |
|
| cryptocurrencyindicator XPath: /operation/cryptocurrencyindicator |
Numerisch (1) |
Zeigt an, ob die Transaktion als Kauf einer Kryptowährung gekennzeichnet ist:
|
|
| currencyiso3a XPath: /billing/amount/@currencycode |
Alpha (3) |
Die Währung der Transaktion. Klicken Sie hier für eine vollständige Liste der verfügbaren Währungen. |
|
| dccenabled XPath: /billing/dcc/@enabled |
Numerisch (1) |
Zeigt an, ob Ihr Konto konfiguriert ist für DCC:
|
|
| debtrepayment XPath: /merchant/debtrepayment |
Numerisch (1) |
Gibt an, ob die Transaktion als Schuldentilgung gekennzeichnet ist:
|
|
| errorcode XPath: /error/code |
Numerisch (1-5) |
Die Fehlercode (errorcode) sollte verwendet werden, um festzustellen, ob die Anfrage erfolgreich war oder nicht.
Klicken Sie hier für eine vollständige Liste der errorcode und Nachrichtenwerte. |
|
| errormessage XPath: /error/message |
Alphanumerisch (255) |
Hier finden Sie eine kurze Erklärung für die Fehlerursache.
Bei erfolgreichen Transaktionen wird dies als "Ok" zurückgegeben. Klicken Sie hier für eine vollständige Liste der errorcode und Nachrichtenwerte. |
|
| issuer XPath: /billing/payment/issuer |
Alphanumerisch (255) | Der Kartenaussteller des Kunden. | |
| issuercountryiso2a XPath: /billing/payment/issuercountry |
Alpha (2) |
Das Land, in dem der Kartenaussteller des Kunden ansässig ist. Klicken Sie hier für eine vollständige Liste der Ländercodes. |
|
| livestatus XPath: /live |
Numerisch (1) |
|
|
| maskedpan XPath: /billing/payment/pan |
Alphanumerisch einschließlich "#" (12-19) |
Wenn tokenisedpayment wird nicht zurückgegeben: Wenn tokenisedpayment wird mit dem Wert 1 zurückgegeben: |
|
| merchantnumber XPath: /merchant/merchantnumber |
Alphanumerisch (32) |
Die Händlernummer, die zur Bearbeitung der Transaktion verwendet wurde. Wird von der erwerbenden Bank zur Verfügung gestellt. |
|
| operatorname XPath: /merchant/operatorname |
Alphanumerisch (255) | Der Wert dieses Feldes enthält den Namen des Benutzers, der die Anfrage bearbeitet hat. | |
| paymenttypedescription XPath: /billing/payment/@type |
Alpha (20) | Zahlungsmethode (z. B. "VISA" oder "MASTERCARD"). | |
| requesttypedescription XPath: /@type |
Alpha (20) |
"REFUND" wird in der Antwort zurückgegeben. |
|
| securityresponseaddress XPath: /security/address |
Numerisch (1) |
Das Ergebnis der AVS prüft. |
|
| securityresponsepostcode XPath: /security/postcode |
Numerisch (1) |
Das Ergebnis der AVS prüft. |
|
| securityresponsesecuritycode XPath: /security/securitycode |
Numerisch (1) |
Das Ergebnis der Sicherheitscode-Prüfungen. |
|
| settleduedate XPath: /settlement/settleduedate |
Datum JJJJ-MM-TT | Das Datum, an dem die Transaktion abgewickelt wird. | |
| settlestatus XPath: /settlement/settlestatus |
Numerisch (3) |
Ein numerischer Wert, der verwendet wird, um den Fortschritt von Abrechnung in Bezug auf diese Transaktion anzuzeigen. Klicken Sie hier für weitere Informationen über die Werte, die zurückgegeben werden können. |
|
| transactionreference XPath: /transactionreference |
Alphanumerisch einschließlich Bindestriche (25) |
Eine eindeutige Referenz für die Transaktion, die von Trust Payments zugewiesen wird. Sie benötigen diese Referenz, um eine Erstattung durchzuführen oder die Transaktion zu aktualisieren. | |
| transactionstartedtimestamp XPath: /timestamp |
Datum Uhrzeit JJJJ-MM-TT hh:mm:ss | Der Zeitpunkt, zu dem die Transaktion bearbeitet wurde. | |
| acquireradvicecode XPath: /acquireradvicecode |
Numerisch (1) |
Ein numerischer Wert, der nach einer wiederholten Zahlungsanforderung zurückgegeben wird und angibt, ob weitere Zahlungen verarbeitet werden können.
Kartierung:
Dies hängt von Ihrer Bank ab. Bitte kontaktieren Sie Ihre Bank für weitere Informationen. |
|
| acquirerresponsecode XPath: /acquirerresponsecode |
Alphanumerisch (255) |
Wird von Ihrem Acquirer verwendet, um das Ergebnis der Anfrage anzuzeigen. Dies hängt von Ihrer Bank ab. Bitte kontaktieren Sie Ihre Bank für weitere Informationen. |
|
| acquirerresponsemessage XPath: /acquirerresponsemessage |
Alphanumerisch (255) |
Wird von Ihrem Acquirer verwendet, um das Ergebnis der Anfrage anzuzeigen. Dies hängt von Ihrer Bank ab. Bitte kontaktieren Sie Ihre Bank für weitere Informationen. |
|
| authcode XPath: /authcode |
Alphanumerisch (255) |
Der Autorisierung Code, der von der ausstellenden Bank bereitgestellt wird. Dieser ist je nach Bank unterschiedlich. Wird nur zurückgegeben, wenn die Transaktion genehmigt ist. |
|
| customeraccountnumbertype XPath: /customer/accountnumber/@type |
Alpha (7) |
Entweder "CARD" oder "ACCOUNT". Wird zurückgesendet, wenn es in der Anfrage enthalten ist. |
|
| errordata XPath: /error/data |
Alphanumerisch (255) |
Zusätzliche Informationen zur Behebung des Fehlers. Wird nur zurückgegeben, wenn ein Fehler aufgetreten ist. |
|
| maskedcustomeraccountnumber XPath: /customer/accountnumber |
Numerisch (20) |
Wenn der Kontonummern-Typ "ACCOUNT", die Kontonummer des Absenders. Wenn der Kontonummern-Typ "CARD", die Kartennummer des Absenders. Der in der Antwort zurückgegebene Wert ist in einem maskierten Format, z. B. "411111#######1111". Wird zurückgesendet, wenn es in der Anfrage enthalten ist. |
|
| merchantcategorycode XPath: /merchant/merchantcategorycode |
Alphanumerisch (255) |
Es handelt sich dabei um Angaben zu dem Konto, das für die Bearbeitung der Transaktion verwendet wird. Um diese Felder zu ändern, wenden Sie sich bitte an unser Support-Team. Die zurückgegebenen Werte hängen von der Konfiguration Ihres Kontos ab. |
|
| merchantcity XPath: /merchant/merchantcity |
Alphanumerisch (127) |
Es handelt sich dabei um Angaben zu dem Konto, das für die Bearbeitung der Transaktion verwendet wird. Um diese Felder zu ändern, wenden Sie sich bitte an unser Support-Team. Die zurückgegebenen Werte hängen von der Konfiguration Ihres Kontos ab. |
|
| merchantcountryiso2a XPath: /merchant/merchantcountryiso2a |
Alpha (2) |
Es handelt sich dabei um Angaben zu dem Konto, das für die Bearbeitung der Transaktion verwendet wird. Um diese Felder zu ändern, wenden Sie sich bitte an unser Support-Team. Die zurückgegebenen Werte hängen von der Konfiguration Ihres Kontos ab. |
|
| merchantname XPath: /merchant/merchantname |
Alphanumerisch (255) |
Es handelt sich dabei um Angaben zu dem Konto, das für die Bearbeitung der Transaktion verwendet wird. Um diese Felder zu ändern, wenden Sie sich bitte an unser Support-Team. Die zurückgegebenen Werte hängen von der Konfiguration Ihres Kontos ab. |
|
| merchantstatecode XPath: /merchant/merchantstatecode |
Alphanumerisch (127) |
Es handelt sich dabei um Angaben zu dem Konto, das für die Bearbeitung der Transaktion verwendet wird. Um diese Felder zu ändern, wenden Sie sich bitte an unser Support-Team. Die zurückgegebenen Werte hängen von der Konfiguration Ihres Kontos ab. |
|
| merchantzipcode XPath: /merchant/merchantzipcode |
Alphanumerisch (10) |
Es handelt sich dabei um Angaben zu dem Konto, das für die Bearbeitung der Transaktion verwendet wird. Um diese Felder zu ändern, wenden Sie sich bitte an unser Support-Team. Die zurückgegebenen Werte hängen von der Konfiguration Ihres Kontos ab. |
|
| orderreference XPath: /merchant/orderreference |
Alphanumerisch einschließlich Symbole (25) |
Ihre eindeutige Auftragsnummer, die im System Trust Payments gespeichert werden kann. Dieses Feld wird zurückgegeben, wenn es in der Anfrage übermittelt oder von einem Elternteil geerbt wurde. |
|
| parenttransactionreference XPath: /operation/parenttransactionreference |
Alphanumerisch & Bindestriche (25) |
Die transactionreference eines früheren Ersuchens, aus dem die wichtigsten Details hervorgegangen sind vererbt. Dieses Feld wird zurückgegeben, wenn es in der Anfrage übermittelt wurde. |
|
|
retrievalreferencenumber |
Alphanumerisch (255) |
Ein ISO-Begriff. Dieser wird verwendet, um auf die Quelltransaktion zu verweisen. Dies hängt von Ihrer anwerbenden Bank ab. |
|
|
stan |
ISO 8583 |
Die STAN (System Trace Audit Number), die mit der Transaktion verbunden ist. Dies entspricht der Norm ISO 8583. Dieses Feld wird zurückgegeben, falls vorhanden. |
|
| tokenisedpayment XPath: /billing/payment/pan/@tokenised |
Numerisch (1) |
Wenn dieses Feld mit dem Wert 1 zurückgegeben wird, bedeutet dies, dass die Transaktion unter Verwendung eines Tokens verarbeitet wurde. Dieses Feld wird zurückgegeben, wenn die Zahlung mit einem Token durchgeführt wurde. |
|
| tokentype XPath: /billing/payment/pan/@tokentype |
Alphanumerisch (50) |
Dient zur Identifizierung der Art des für diese Zahlung verwendeten Tokens (z. B. "VISATOKEN"). Dieses Feld wird zurückgegeben, wenn die Zahlung mit einem Token durchgeführt wurde. |
|
| transactiontypeindicator XPath: /merchant/transactiontypeindicator |
Alphanumerisch (3) |
Wird zurückgesendet, wenn es in der Anfrage enthalten ist. |
|
| walletdisplayname XPath: /billing/payment/wallet/displayname |
Alphanumerisch (255) |
Diese enthält normalerweise die letzten vier Ziffern der Kartennummer des Kunden (z. B. "1111"). Dieses Feld wird zurückgegeben, wenn die Zahlung mit einer Brieftasche durchgeführt wurde. |
|
| walletsource XPath: /billing/payment/wallet/source |
Alphanumerisch (20) |
Dient zur Identifizierung der Art der für diese Zahlung verwendeten Brieftasche (z. B. "APPLEPAY"). Dieses Feld wird zurückgegeben, wenn die Zahlung mit einer Brieftasche durchgeführt wurde. |
Payout Abrechnung
Der Ablauf von Abrechnung hängt von dem Protokoll ab, das für die Durchführung der Payout verwendet wird.
Visa Direct
Überweisungen, die über Visa Direct abgewickelt werden, werden in der Regel in weniger als 30 Minuten an den Empfänger überwiesen. Die Website settlestatus der Übertragung wird sofort auf 100.
Mastercard MoneySend & Glücksspiel-Zahlungen
Während die Gelder in der Regel in weniger als 30 Minuten an den Empfänger überwiesen werden, müssen MoneySend & Gaming Payments zunächst settlestatus=10. Ein Batch-Prozess läuft täglich und aktualisiert die settlestatus der erfolgreichen Überweisungen an 100.
Andere
Payouts die nicht als Visa Direct oder Mastercard MoneySend & Gaming Payments verarbeitet werden, folgen dem gleichen Abrechnung Ablauf wie eine normale E-Commerce AUTH oder REFUND Anfrage:
- Wenn die Anfrage Payout erfolgreich ist, settlestatus=0
- Abrechnung wird täglich in Stapeln durchgeführt, wonach Payouts aktualisiert wird, um settlestatus=100 um den Erfolg anzuzeigen Abrechnung.
- Die Überweisung wird normalerweise innerhalb von 24 Stunden abgeschlossen.
Zusätzliche Hinweise
Politisch exponierte Personen (PEP) oder Sanktionsscreening
Anträge zur Bearbeitung von Payouts , bei denen Trust Payments ein PEP oder ein Sanktionsscreening beim Empfänger durchführt, unterliegen strengen Anforderungen. Die folgenden Felder müssen in der Anfrage Payout angegeben werden:
Bei Nichtabgabe kann die Fehlermeldung 60044 "Empfänger-Screening fehlgeschlagen" zurückgegeben werden.
- billingcountryiso2a
- billingdob
- billingfirstname
- billinglastname
Anleitung zum Testen
Bei der Prüfung können Sie die folgenden Angaben zur Prüfkarte verwenden:
- Visa Karte "4111 1111 1111 1111" oder Mastercard "5100 0000 0000 0511".
- Legen Sie das Ablaufdatum auf ein beliebiges gültiges Datum in der Zukunft fest.
- Verwenden Sie den Sicherheitscode "123".
Sie können auch verschiedene baseamount Werte, um das Ergebnis der Anfrage zu beeinflussen:
- baseamount 70000 gibt eine abgelehnt Antwort aus der Testbank.
- baseamount 60010 gibt eine Bank-Systemfehler aus der Testbank.
- baseamount 1050 gibt eine zugelassen Antwort aus der Testbank.
Bitte erstellen und übermitteln Sie beim Testen Ihren eigenen Absender-/Empfängernamen, Ihre Adresse, Ihr Geburtsdatum und/oder Ihre Kontonummer usw. als Beispiel.
