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 are used to credit funds to another bank account.
This page describes the requests your system needs to submit in order to process Payouts with Trust Payments and how to handle the responses returned. This includes descriptions of the required Sender/Payer and Recipient/Payee information.
Documentation for the following verticals are included to assist merchants in meeting Payout processing requirements:
Your Merchant Category Code (MCC) is a four-digit number assigned to you by your acquirer. It is used to classify the business by the type of products or services it provides. If you are unsure of the value of your merchant category code, please contact our Support Team.
Gaming Payouts (MCC 7995)
The merchant is processing a payout of gambling winnings to their customer.
Person-to-Person Money Transfer Payouts (MCC 4829)
The merchant is processing a payout to complete a money transfer for their customer.
Crypto, Forex, & Securities Payouts (MCC 6051 & 6211)
The merchant is processing a payout of the proceeds of trades or contract for differences (CFD) to their customer.
Business Disbursement Payouts (All other MCCs)
The merchant is processing a payout to their customer for reasons not listed above (e.g. Insurance payout for a customer claim).
You may also come across these terms:
- Payouts are also known as Credit Fund Transfers (CFT) or Original Credit Transfers (OCT).
- Visa Direct — For processing payouts to Visa cards. Learn more.
- Mastercard Gaming & Gambling Payments Program — Send gaming payouts to Mastercard cards. Learn more.
- Mastercard MoneySend — Process non-gaming payouts to Mastercard cards. Learn more.
Voraussetzungen
You will need to have a CFT account associated with your Trust Payments site reference. If you are unsure if your site reference supports this, we recommend contacting your account manager or our Support Team for clarification.
Prozessübersicht
Um eine Payout zu verarbeiten, müssen Sie eine Payout Anfrage über unsere Webservices API übermitteln. Codebeispiele finden Sie unten.
Alle Payout erfordern die Angaben CFT “ und REFUND“.
Es gibt zwei Möglichkeiten, die Kartendaten des Empfängers anzugeben:
-
Verwendung von Feldern pan und expirydate:
- Submit the recipient's card number and expiry date directly in the request.
- Use this approach when no prior transaction exists on our system for that card.
- Empfohlen für Händler und Partner, die Kartendaten erfassen und in Webservices einbinden.
-
Verwendung von parenttransactionreference field:
- Reference a previous transaction stored on our system.
- The card details are retrieved automatically, so you do not need to include them in the request.
- Empfohlen für Händler und Partner, die Payment Pages, JavaScript Library Warenkorb-Plugins zur Erfassung von Kartendaten nutzen.
Gaming Payouts (MCC 7995)
The merchant is processing a payout of gambling winnings to their customer.
#!/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. Vollständige Domainliste anzeigen.
#!/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",
"parenttransactionreference": "23-9-80001",
"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',
'parenttransactionreference' => '23-9-80001',
'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",
"parenttransactionreference": "23-9-80001",
"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",
"parenttransactionreference":"23-9-80001",
"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>
</billing>
<operation>
<accounttypedescription>CFT</accounttypedescription>
<parenttransactionreference>23-9-80001</parenttransactionreference>
<sitereference>site12346</sitereference>
</operation>
</request>
</requestblock>
Ersetzen Sie <DOMAIN> mit einer unterstützten Domäne. Vollständige Domainliste anzeigen.
{
'requestreference': 'Agv3epv31',
'version': '1.00',
'responses': [{
'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'
}]
}
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>
Person-to-Person Money Transfer Payouts (MCC 4829)
The merchant is processing a payout to complete a money transfer for their customer.
#!/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": "C07"
}
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' => 'C07'
);
$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": "C07"
}]
}'
{
"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":"C07"
}]
}
<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>C07</transactiontypeindicator>
</merchant>
<operation>
<accounttypedescription>CFT</accounttypedescription>
<sitereference>site12346</sitereference>
</operation>
</request>
</requestblock>
Ersetzen Sie <DOMAIN> mit einer unterstützten Domäne. Vollständige Domainliste anzeigen.
#!/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",
"parenttransactionreference": "23-9-80001",
"requesttypedescriptions": ["REFUND"],
"sitereference": "site12346",
"transactiontypeindicator": "C07"
}
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',
'parenttransactionreference' => '23-9-80001',
'requesttypedescriptions' => array('REFUND'),
'sitereference' => 'site12346',
'transactiontypeindicator' => 'C07'
);
$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",
"parenttransactionreference": "23-9-80001",
"requesttypedescriptions": ["REFUND"],
"sitereference": "site12346",
"transactiontypeindicator": "C07"
}]
}'
{
"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",
"parenttransactionreference":"23-9-80001",
"requesttypedescriptions":["REFUND"],
"sitereference":"site12346",
"transactiontypeindicator":"C07"
}]
}
<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>
</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>C07</transactiontypeindicator>
</merchant>
<operation>
<accounttypedescription>CFT</accounttypedescription>
<parenttransactionreference>23-9-80001</parenttransactionreference>
<sitereference>site12346</sitereference>
</operation>
</request>
</requestblock>
Ersetzen Sie <DOMAIN> mit einer unterstützten Domäne. Vollständige Domainliste anzeigen.
{
'requestreference': 'Agv3epv31',
'version': '1.00',
'responses': [{
'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': 'C07'
}]
}
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) "C07"
}
}
["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": "C07"
}],
"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>C07</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>
Crypto, Forex, & Securities Payouts (MCC 6051 & 6211)
The merchant is processing a payout of the proceeds of trades or contract for differences (CFD) to their customer. In this scenario, the sender and recipient are the customer.
#!/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. Vollständige Domainliste anzeigen.
#!/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",
"parenttransactionreference": "23-9-80001",
"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',
'parenttransactionreference' => '23-9-80001',
'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",
"parenttransactionreference": "23-9-80001",
"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",
"parenttransactionreference":"23-9-80001",
"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>
</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>
<parenttransactionreference>23-9-80001</parenttransactionreference>
<sitereference>site12346</sitereference>
</operation>
</request>
</requestblock>
Ersetzen Sie <DOMAIN> mit einer unterstützten Domäne. Vollständige Domainliste anzeigen.
{
'requestreference': 'Agv3epv31',
'version': '1.00',
'responses': [{
'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'
}]
}
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>
Business Disbursement Payouts (All other MCCs)
The merchant is processing a payout to their customer for reasons not listed above (e.g. Insurance payout for a customer claim). In this scenario, the sender is the merchant or business sending the funds, and the recipient is the customer. When not provided in the request, the sender information is automatically sourced from Trust Payments.
#!/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. Vollständige Domainliste anzeigen.
#!/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",
"parenttransactionreference": "23-9-80001",
"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',
'parenttransactionreference' => '23-9-80001',
'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",
"parenttransactionreference": "23-9-80001",
"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",
"parenttransactionreference":"23-9-80001",
"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>
</billing>
<merchant>
<transactiontypeindicator>C55</transactiontypeindicator>
</merchant>
<operation>
<accounttypedescription>CFT</accounttypedescription>
<parenttransactionreference>23-9-80001</parenttransactionreference>
<sitereference>site12346</sitereference>
</operation>
</request>
</requestblock>
Ersetzen Sie <DOMAIN> mit einer unterstützten Domäne. Vollständige Domainliste anzeigen.
{
'requestreference': 'Agv3epv31',
'version': '1.00',
'responses': [{
'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'
}]
}
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>
Payout Feldspezifikation
Payout Spezifikation des Anfragefeldes
|
Feld |
Format | Beschreibung | |
Essential fields | |||
| Erforderlich | accounttypedescription XPath: /operation/accounttypedescription |
Alpha (20) | Muss "CFT" lauten. |
| Erforderlich | 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. |
| Erforderlich | currencyiso3a XPath: /Rechnung/Betrag/@Währungscode |
Alpha (3) |
Die Währung , in der die Transaktion abgewickelt werden soll. |
| Erforderlich | requesttypedescriptions XPath: /@type |
Alphanumerisch & Bindestriche (25) |
Die erforderliche Anforderungstyp ist "REFUND". |
| Erforderlich | 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. |
| Bedingt | expirydate XPath: /abrechnung/zahlung/expirydate |
Datum MM/JJJJ |
Das Ablaufdatum der Karte. Erforderlich, wenn pan eingereicht wird. Fakultativ, wenn parenttransactionreference eingereicht wird. |
| Bedingt | pan XPath: /abrechnung/zahlung/pan |
Numerisch (12-19) |
Die Kartennummer des Kunden. Erforderlich, wenn parenttransactionreference NICHT eingereicht wird. |
| Bedingt | 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. |
| Optional | orderreference XPath: /merchant/orderreference |
Alphanumerisch einschließlich Symbole (25) |
Es wird dringend empfohlen, eine eindeutige Referenz zur Identifizierung jedes eingereichten Antrags zu übermitteln. |
Felder für Fondsüberweisungen | |||
| Bedingt | cftsourceoffunds XPath: /merchant/cftsourceoffunds |
Numerisch (2) |
Die Quelle der Mittel für die Payout. „01“ – Gutschrift Required for: If Business Disbursement: |
| Bedingt | customeraccountnumbertype XPath: /customer/accountnumber/@type |
Alpha (7) |
Einreichen entweder "CARD" oder "ACCOUNT". Required for: If Business Disbursement: |
| Bedingt | customeraccountnumber XPath: /customer/accountnumber |
Numeric (34) |
Wenn customeraccountnumbertype ist "ACCOUNT"geben Sie die Kontonummer des Absenders an. Wenn customeraccountnumbertype ist "CARD"geben Sie die Kartennummer des Absenders an. Required for: If Business Disbursement: |
| Bedingt | transactiontypeindicator XPath: /merchant/transactiontypeindicator |
Alphanumerisch (3) |
Gibt die Mastercard MoneySend Transaktionsart an - Unterstützte Werte: "C07" — Person-to-Person Transfer
|
Kontaktfelder des Absenders | |||
| Bedingt | customercountryiso2a XPath: /customer/country |
Alpha (2) |
Das Land des Absenders im ISO2A-Format. Required for: If Business Disbursement: |
| Bedingt | 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". Required if BOTH conditions are met: Required for: If Business Disbursement: |
| Bedingt | customerfirstname XPath: /customer/name/first |
Alphanumerisch einschließlich Symbole (127) |
Der Vorname des Absenders. Required for: If Business Disbursement: |
| Bedingt | customerlastname XPath: /customer/name/last |
Alphanumerisch einschließlich Symbole (127) |
Der Nachname des Absenders. Required for: If Business Disbursement: |
| Bedingt | customermiddlename XPath: /customer/name/middle |
Alphanumerisch einschließlich Symbole (127) |
Der/die zweite(n) Name(n) des Kunden. Required if BOTH of these conditions apply: For other verticals, this field is optional. |
| Bedingt | customerpremise XPath: /Kunde/Vor-Ort |
Alphanumerisch einschließlich Symbole (25) |
Name/Nummer der Eigenschaft des Absenders. Required for: If Business Disbursement: The customerpremise field can be submitted in addition to / instead of customerstreet. |
| Bedingt | customerstreet XPath: /customer/street |
Alphanumerisch einschließlich Symbole (127) |
Der Straßenname des Absenders. Required for: If Business Disbursement: The customerstreet field can be submitted in addition to / instead of customerpremise. |
| Bedingt | customertown XPath: /customer/town |
Alphanumerisch einschließlich Symbole (127) |
Die Stadt des Absenders. Required for: If Business Disbursement: |
| Optional | customerpostcode XPath: /customer/postcode |
Alphanumerisch (25) | The sender's postcode or ZIP code. This must be a valid postcode/ZIP code for the customercountryiso2a submitted. |
Recipient contact fields | |||
| Erforderlich | billingcountryiso2a XPath: /abrechnung/land |
Alpha (2) |
Das Land, in dem die Rechnungsadresse des Empfängers liegt. Diese muss im ISO2A-Format angegeben werden. |
| Erforderlich | billingdob XPath: /abrechnung/dob |
Datum JJJJ-MM-TT | Das Geburtsdatum des Empfängers. |
| Erforderlich | billingfirstname XPath: /abrechnung/name/erste |
Alphanumerisch einschließlich Symbole (127) |
Die Adresse des Empfängers lautet Rechnungsvorname. |
| Erforderlich | billinglastname XPath: /abrechnung/name/last |
Alphanumerisch einschließlich Symbole (127) |
Die Adresse des Empfängers lautet Rechnungsnachname. |
| Bedingt | 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". Required if BOTH conditions are met: Required if BOTH conditions are met: |
| Bedingt | billingmiddlename XPath: /billing/name/middle |
Alphanumerisch einschließlich Symbole (127) |
Der/die mittlere(n) Rechnungsname(n) des Kunden. Required if BOTH of these conditions apply: For other verticals, this field is optional. |
| Bedingt | billingstreet XPath: /Rechnung/Straße |
Alphanumerisch einschließlich Symbole (127) |
Die Straße, die für die Rechnungsadresse des Empfängers eingegeben wurde. Erforderlich, wenn |
| Bedingt | billingtown XPath: /abrechnung/stadt |
Alphanumerisch einschließlich Symbole (127) |
Der Ort, der für die Rechnungsadresse des Empfängers eingegeben wurde. Erforderlich, wenn |
| Optional | billingpostcode XPath: /billing/postcode |
Alphanumerisch (25) | Die Rechnungspostleitzahl oder die Postleitzahl. Es muss sich um eine gültige Postleitzahl für den billingcountryiso2a vorgelegt. |
| Optional | billingpremise XPath: /abrechnung/premise |
Alphanumerisch einschließlich Symbole (25) |
Der Name/die Nummer der Immobilie für die Rechnungsadresse des Empfängers. |
Payout Antwortfeld-Spezifikation
| Feld | Format | Beschreibung | |
| Zurückgeschickt | accounttypedescription XPath: /operation/accounttypedescription |
Alpha (20) | "CFT" wird in der Antwort zurückgegeben. |
| Zurückgeschickt | 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. |
| Zurückgeschickt | 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. |
| Zurückgeschickt | cryptocurrencyindicator XPath: /operation/cryptocurrencyindicator |
Numerisch (1) |
Zeigt an, ob die Transaktion als Kauf einer Kryptowährung gekennzeichnet ist:
|
| Zurückgeschickt | currencyiso3a XPath: /billing/amount/@currencycode |
Alpha (3) |
Die Währung der Transaktion. |
| Zurückgeschickt | dccenabled XPath: /billing/dcc/@enabled |
Numerisch (1) |
Zeigt an, ob Ihr Konto für DCC:
|
| Zurückgeschickt | debtrepayment XPath: /merchant/debtrepayment |
Numerisch (1) |
Gibt an, ob die Transaktion als Schuldenrückzahlunggekennzeichnet ist:
|
| Zurückgeschickt | errorcode XPath: /error/code |
Numerisch (1-5) |
Die Fehlercode (errorcode) sollte verwendet werden, um festzustellen, ob die Anfrage erfolgreich war oder nicht.
|
| Zurückgeschickt | 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. |
| Zurückgeschickt | issuer XPath: /billing/payment/issuer |
Alphanumerisch (255) | Der Kartenaussteller des Kunden. |
| Zurückgeschickt | issuercountryiso2a XPath: /billing/payment/issuercountry |
Alpha (2) |
Das Land, in dem der Kartenaussteller des Kunden ansässig ist. |
| Zurückgeschickt | livestatus XPath: /live |
Numerisch (1) |
|
| Zurückgeschickt | 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: |
| Zurückgeschickt | 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. |
| Zurückgeschickt | operatorname XPath: /merchant/operatorname |
Alphanumerisch (255) | Der Wert dieses Feldes enthält den Namen des Benutzers, der die Anfrage bearbeitet hat. |
| Zurückgeschickt | paymenttypedescription XPath: /billing/payment/@type |
Alpha (20) | Zahlungsmethode (z. B. "VISA" oder "MASTERCARD"). |
| Zurückgeschickt | requesttypedescription XPath: /@type |
Alpha (20) | "REFUND" wird in der Antwort zurückgegeben. |
| Zurückgeschickt | securityresponseaddress XPath: /security/address |
Numerisch (1) |
Das Ergebnis der AVS prüft. |
| Zurückgeschickt | securityresponsepostcode XPath: /security/postcode |
Numerisch (1) |
Das Ergebnis der AVS prüft. |
| Zurückgeschickt | securityresponsesecuritycode XPath: /security/securitycode |
Numerisch (1) |
Das Ergebnis der Sicherheitscode-Prüfungen. |
| Zurückgeschickt | settleduedate XPath: /settlement/settleduedate |
Datum JJJJ-MM-TT | Das Datum, an dem die Transaktion abgewickelt wird. |
| Zurückgeschickt | settlestatus XPath: /settlement/settlestatus |
Numerisch (3) |
Ein numerischer Wert, der verwendet wird, um den Fortschritt von Abrechnung in Bezug auf diese Transaktion anzuzeigen. |
| Zurückgeschickt | transactionreference XPath: /transactionreference |
Alphanumerisch einschließlich Bindestriche (25) |
Eine eindeutige Referenz für die von Trust Payments zugewiesene Transaktion. Sie benötigen diese Referenz, um eine Rückerstattung oder Aktualisierung der Transaktion. |
| Zurückgeschickt | transactionstartedtimestamp XPath: /timestamp |
Datum Uhrzeit JJJJ-MM-TT hh:mm:ss | Der Zeitpunkt, zu dem die Transaktion bearbeitet wurde. |
| Bedingt | 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. |
| Bedingt | 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. |
| Bedingt | 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. |
| Bedingt | 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. |
| Bedingt | customeraccountnumbertype XPath: /customer/accountnumber/@type |
Alpha (7) |
Entweder "CARD" oder "ACCOUNT". When the customeraccountnumber value submitted in the request is a card number, this field will be populated with "CARD" in the response. |
| Bedingt | errordata XPath: /error/data |
Alphanumerisch (255) |
Zusätzliche Informationen zur Behebung des Fehlers. Wird nur zurückgegeben, wenn ein Fehler aufgetreten ist. |
| Bedingt | maskedcustomeraccountnumber XPath: /customer/accountnumber |
Numeric (34) |
If account number type is “ACCOUNT”, the account number of the sender. When the customeraccountnumber value submitted in the request is a card number, this will be masked (e.g. “559139######0504”) in the response, when displayed in Portal and returned in URL notification(s) (if enabled). Wird zurückgesendet, wenn es in der Anfrage enthalten ist. |
| Bedingt | merchantcategorycode XPath: /merchant/merchantcategorycode |
Alphanumerisch (255) |
Dies sind Angaben zu dem Konto, das für die Abwicklung der Transaktion verwendet wird. Um diese Felder zu ändern, wenden Sie sich bitte wenden Sie sich an unser Support-Team. Die zurückgegebenen Werte hängen von der Konfiguration Ihres Kontos ab. |
| Bedingt | merchantcity XPath: /merchant/merchantcity |
Alphanumerisch (127) |
Dies sind Angaben zu dem Konto, das für die Abwicklung der Transaktion verwendet wird. Um diese Felder zu ändern, wenden Sie sich bitte wenden Sie sich an unser Support-Team. Die zurückgegebenen Werte hängen von der Konfiguration Ihres Kontos ab. |
| Bedingt | merchantcountryiso2a XPath: /merchant/merchantcountryiso2a |
Alpha (2) |
Dies sind Angaben zu dem Konto, das für die Abwicklung der Transaktion verwendet wird. Um diese Felder zu ändern, wenden Sie sich bitte wenden Sie sich an unser Support-Team. Die zurückgegebenen Werte hängen von der Konfiguration Ihres Kontos ab. |
| Bedingt | merchantname XPath: /merchant/merchantname |
Alphanumerisch (255) |
Dies sind Angaben zu dem Konto, das für die Abwicklung der Transaktion verwendet wird. Um diese Felder zu ändern, wenden Sie sich bitte wenden Sie sich an unser Support-Team. Die zurückgegebenen Werte hängen von der Konfiguration Ihres Kontos ab. |
| Bedingt | merchantstatecode XPath: /merchant/merchantstatecode |
Alphanumerisch (127) |
Dies sind Angaben zu dem Konto, das für die Abwicklung der Transaktion verwendet wird. Um diese Felder zu ändern, wenden Sie sich bitte wenden Sie sich an unser Support-Team. Die zurückgegebenen Werte hängen von der Konfiguration Ihres Kontos ab. |
| Bedingt | merchantzipcode XPath: /merchant/merchantzipcode |
Alphanumerisch (10) |
Dies sind Angaben zu dem Konto, das für die Abwicklung der Transaktion verwendet wird. Um diese Felder zu ändern, wenden Sie sich bitte wenden Sie sich an unser Support-Team. Die zurückgegebenen Werte hängen von der Konfiguration Ihres Kontos ab. |
| Bedingt | 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. |
| Bedingt | 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. |
| Bedingt | retrievalreferencenumber XPath: /other/retrievalreferencenumber |
Alphanumerisch (255) |
Ein ISO-Begriff. Dieser wird verwendet, um auf die Quelltransaktion zu verweisen. Dies hängt von Ihrer anwerbenden Bank ab. |
| Bedingt | stan XPath: /other/stan |
ISO 8583 |
Die mit der Transaktion verbundene STAN System Trace Audit Number). Diese entspricht der ISO 8583-Standard. Dieses Feld wird zurückgegeben, falls vorhanden. |
| Bedingt | 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. |
| Bedingt | 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. |
| Bedingt | transactiontypeindicator XPath: /merchant/transactiontypeindicator |
Alphanumerisch (3) |
"C07" — Person-to-Person Transfer Wird zurückgesendet, wenn es in der Anfrage enthalten ist. |
| Bedingt | 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. |
| Bedingt | 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.
Mastercard MoneySend
While the funds are typically transferred to the recipient in less than 30 minutes, MoneySend payouts will initially have settlestatus=10. Ein Batch-Prozess läuft täglich und aktualisiert die settlestatus der erfolgreichen Überweisungen an 100.
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 Gaming and Gambling Payments Program and everything else
Payouts that are processed via the Mastercard Gaming and Gambling Payments Program, or anything outside of the above, will follow the same settlement flow as a standard e-commerce AUTH or REFUND request:
- 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 Ihre eigenen Platzhalter für Absender-/Empfängernamen, Adresse, Geburtsdatum und/oder Kontonummer usw..
FAQ
Why has my Payout request been declined?
Payouts are sent to the card issuer for authorisation, and a decline response (error code 70000) indicates that the card issuer has chosen to decline the request. Trust Payments is unable to provide specific reasons for the decline, as this decision is made by the card issuer directly. We recommend contacting your card issuer to find out why the payout was declined.
What is a business application identifier?
A business application identifier (BAI) is a unique reference code assigned to your business within the Trust Payments platform, used specifically for Visa Direct payouts and account funding transactions. A specific BAI is assigned based on your merchant type. For more information, contact our Support Team.
What is a transaction type indicator?
A transaction type indicator (TTI) is a required value included in Mastercard Moneysend payout and funding transaction requests, which specifies the type of transaction being processed. For more information, contact our Support Team.
