De volgende inhoud gaat ervan uit dat u de noodzakelijke PCI-certificering hebt verkregen om gevoelige kaarthoudergegevens te verwerken en in te dienen in het verzoek aan onze Webservices API.
Lees dit artikel voor meer informatie.
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.
Vereisten
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.
Procesoverzicht
Om een Payout te verwerken, moet je een Payout verzoek indienen met behulp van onze Webservices API. Zie de onderstaande codevoorbeelden.
Voor alle Payout moeten CFT en REFUND worden opgegeven.
Er zijn twee manieren om de kaartgegevens van de ontvanger door te geven:
-
Velden gebruiken pan en 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.
- Aanbevolen voor handelaren en partners die kaartgegevens vastleggen en opnemen in Webservices .
-
Gebruik van 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.
- Aanbevolen voor verkopers en partners die gebruikmaken van Payment Pages, JavaScript Library winkelwagenplug-ins om kaartgegevens vast te leggen.
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>
Vervang <DOMAIN> met een ondersteund domein. Bekijk de volledige lijst met domeinen.
#!/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>
Vervang <DOMAIN> met een ondersteund domein. Bekijk de volledige lijst met domeinen.
{
'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>
Vervang <DOMAIN> met een ondersteund domein. Bekijk de volledige lijst met domeinen.
#!/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>
Vervang <DOMAIN> met een ondersteund domein. Bekijk de volledige lijst met domeinen.
{
'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>
Vervang <DOMAIN> met een ondersteund domein. Bekijk de volledige lijst met domeinen.
#!/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>
Vervang <DOMAIN> met een ondersteund domein. Bekijk de volledige lijst met domeinen.
{
'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>
Vervang <DOMAIN> met een ondersteund domein. Bekijk de volledige lijst met domeinen.
#!/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>
Vervang <DOMAIN> met een ondersteund domein. Bekijk de volledige lijst met domeinen.
{
'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 veldspecificatie
Payout specificatie verzoekveld
|
Veld |
Formaat | Beschrijving | |
Essential fields | |||
| Verplicht | accounttypedescription XPath: /operatie/accounttypedescription |
Alpha (20) | Moet "CFT" zijn. |
| Verplicht | baseamount XPath: /factuur/bedrag |
Numeriek (13) | Het restitutiebedrag in basiseenheden, zonder komma's of decimalen. B.v. €10,99 zou worden ingediend als "1099", maar ¥246 zou worden ingediend als "246". |
| Verplicht | currencyiso3a XPath: /factuur/bedrag/@currencycode |
Alpha (3) |
De Munt waarin de transactie zal worden verwerkt. |
| Verplicht | requesttypedescriptions XPath: /@type |
Alfanumeriek en koppeltekens (25) |
De vereiste Verzoektype is "REFUND". |
| Verplicht | sitereference XPath: /operatie/sitereference |
Alfanumeriek & underscore (50) |
Een unieke referentie die uw account identificeert. Deze ontvangt u wanneer u zich voor het eerst bij ons aanmeldt. |
| Conditioneel | expirydate XPath: /factuur/betaling/expirydate |
Datum MM/JJJJ |
De vervaldatum van de kaart. Vereist wanneer pan wordt ingediend. Optioneel wanneer parenttransactionreference wordt ingediend. |
| Conditioneel | pan XPath: /factuur/betaling/pan |
Numeriek (12-19) |
Het kaartnummer van de klant. Vereist wanneer parenttransactionreference NIET is ingediend. |
| Conditioneel | parenttransactionreference XPath: /operatie/parenttransactionreference |
Alfanumeriek en koppeltekens (25) |
Stuur de Transactiereferentie van een eerder AUTH, ACCOUNTCHECK of Payout (CFT REFUND ) verzoek in en we zullen de kaart van de klant die is opgeslagen in onze administratie ophalen en het geld op deze kaart bijschrijven. Alle velden die beginnen met "billing" en "customer" wordt ook geërfd van het ouderverzoek, indien beschikbaar. Overgeërfde velden hoeven niet te worden opgenomen in dit nieuwe Payout verzoek (zelfs als deze specificatie aangeeft dat ze vereist zijn), maar u hebt nog steeds de mogelijkheid om nieuwe facturerings- en klantvelden in te dienen en deze zullen alle overgeërfde gegevens overschrijven. Vereist wanneer pan NIET is ingediend. |
| Optioneel | orderreference XPath: /merchant/orderreference |
Alfanumeriek, inclusief symbolen (25) |
We raden ten zeerste aan om een unieke referentie in te dienen om elk ingediend verzoek te identificeren. |
Overdrachtsvelden | |||
| Conditioneel | cftsourceoffunds XPath: /merchant/cftsourceoffunds |
Numeriek (2) |
De bron van de middelen voor de Payout. "01" - Krediet Required for: If Business Disbursement: |
| Conditioneel | customeraccountnumbertype XPath: /customer/accountnumber/@type |
Alfa (7) |
Stuur "CARD" of "ACCOUNT". Required for: If Business Disbursement: |
| Conditioneel | customeraccountnumber XPath: /customer/accountnumber |
Numeric (34) |
Als customeraccountnumbertype is "ACCOUNT"Voer het rekeningnummer van de verzender in. Als customeraccountnumbertype is "CARD"Voer het kaartnummer van de verzender in. Required for: If Business Disbursement: |
| Conditioneel | transactietypeindicator XPath: /merchant/transactietypeindicator |
Alfanumeriek (3) |
Specificeert het Mastercard MoneySend Transactietype - Ondersteunde waarden: "C07" — Person-to-Person Transfer
|
Contactvelden afzender | |||
| Conditioneel | customercountryiso2a XPath: /customer/country |
Alpha (2) |
Het land van de afzender in ISO2A-formaat. Required for: If Business Disbursement: |
| Conditioneel | customercounty XPath: /klant/provincie |
Alfanumeriek, inclusief symbolen (127) |
De provincie voor het adres van de afzender. Voor adressen in de VS en Canada moet je de provinciecode van twee tekens opgeven, bijvoorbeeld "BC" voor British Columbia. Required if BOTH conditions are met: Required for: If Business Disbursement: |
| Conditioneel | customerfirstname XPath: /customer/name/first |
Alfanumeriek, inclusief symbolen (127) |
De voornaam van de afzender. Required for: If Business Disbursement: |
| Conditioneel | customerlastname XPath: /customer/name/last |
Alfanumeriek, inclusief symbolen (127) |
De achternaam van de afzender. Required for: If Business Disbursement: |
| Conditioneel | customermiddlename XPath: /customer/name/middle |
Alfanumeriek, inclusief symbolen (127) |
De middelste naam of namen van de klant. Required if BOTH of these conditions apply: For other verticals, this field is optional. |
| Conditioneel | customerpremise XPath: /klant/premise |
Alfanumeriek, inclusief symbolen (25) |
De naam/het nummer van het eigendom van de afzender. Required for: If Business Disbursement: The customerpremise field can be submitted in addition to / instead of customerstreet. |
| Conditioneel | customerstreet XPath: /customer/street |
Alfanumeriek, inclusief symbolen (127) |
De straatnaam van de afzender. Required for: If Business Disbursement: The customerstreet field can be submitted in addition to / instead of customerpremise. |
| Conditioneel | customertown XPath: /customer/town |
Alfanumeriek, inclusief symbolen (127) |
De stad van de afzender. Required for: If Business Disbursement: |
| Optioneel | customerpostcode XPath: /customer/postcode |
Alfanumeriek (25) | The sender's postcode or ZIP code. This must be a valid postcode/ZIP code for the customercountryiso2a submitted. |
Recipient contact fields | |||
| Verplicht | billingcountryiso2a XPath: /factuur/land |
Alpha (2) |
Het land voor het factuuradres van de ontvanger. Dit moet in ISO2A-formaat zijn. |
| Verplicht | billingdob XPath: /billing/dob |
Datum JJJJ-MM-DD | De geboortedatum van de ontvanger. |
| Verplicht | billingfirstname XPath: /factuur/naam/eerste |
Alfanumeriek, inclusief symbolen (127) |
De ontvanger Voornaam facturatie. |
| Verplicht | billinglastname XPath: /factuur/naam/laatste |
Alfanumeriek, inclusief symbolen (127) |
De ontvanger Achternaam facturatie. |
| Conditioneel | billingcounty XPath: /factuur/provincie |
Alfanumeriek, inclusief symbolen (127) |
Het district voor het factuuradres van de ontvanger. Voor adressen in de VS en Canada moet je de provinciecode van twee tekens opgeven, bijvoorbeeld "BC" voor British Columbia. Required if BOTH conditions are met: Required if BOTH conditions are met: |
| Conditioneel | billingmiddlename XPath: /billing/name/middle |
Alfanumeriek, inclusief symbolen (127) |
De middelste factureringsnaam of -namen van de klant. Required if BOTH of these conditions apply: For other verticals, this field is optional. |
| Conditioneel | billingstreet XPath: /factuur/straat |
Alfanumeriek, inclusief symbolen (127) |
De straat die is ingevoerd voor het factuuradres van de ontvanger. Vereist indien |
| Conditioneel | billingtown XPath: /factuur/stad |
Alfanumeriek, inclusief symbolen (127) |
De stad die is ingevoerd voor het factuuradres van de ontvanger. Vereist indien |
| Optioneel | billingpostcode XPath: /billing/postcode |
Alfanumeriek (25) | De Postcode facturatie of postcode. Dit moet een geldige postcode/ZIP-code zijn voor de billingcountryiso2a ingediend. |
| Optioneel | billingpremise XPath: /billing/premise |
Alfanumeriek, inclusief symbolen (25) |
De naam/het nummer van het eigendom voor het factuuradres van de ontvanger. |
Payout specificatie antwoordveld
| Veld | Formaat | Beschrijving | |
| Geretourneerd | accounttypedescription XPath: /operation/accounttypedescription |
Alpha (20) | "CFT" wordt geretourneerd in het antwoord. |
| Geretourneerd | baseamount XPath: /billing/amount |
Numeriek (13) | Het restitutiebedrag in basiseenheden, zonder komma's of decimalen. B.v. €10,99 zou worden ingediend als "1099", maar ¥246 zou worden ingediend als "246". |
| Geretourneerd | chargedescription XPath: /merchant/chargedescription |
Alfanumeriek, inclusief spaties en speciale tekens (25) |
De charge description is een veld dat wij tijdens een transactie aan de wervende bank verstrekken. Het is een basisbeschrijving van de transactie die wordt weergegeven op het bankafschrift van de klant. |
| Geretourneerd | cryptocurrencyindicator XPath: /operation/cryptocurrencyindicator |
Numeriek (1) |
Geeft aan of de transactie is gemarkeerd als een aankoop van cryptocurrency:
|
| Geretourneerd | currencyiso3a XPath: /billing/amount/@currencycode |
Alpha (3) |
De Munt van de transactie. |
| Geretourneerd | dccenabled XPath: /billing/dcc/@enabled |
Numeriek (1) |
Geeft aan of uw account is geconfigureerd voor DCC:
|
| Geretourneerd | debtrepayment XPath: /merchant/debtrepayment |
Numeriek (1) |
Geeft aan of de transactie is gemarkeerd als schuldaflossing:
|
| Geretourneerd | errorcode XPath: /error/code |
Numeriek (1-5) |
De foutcode (errorcode) moet worden gebruikt om te bepalen of het verzoek succesvol was of niet.
|
| Geretourneerd | errormessage XPath: /error/message |
Alfanumeriek (255) |
Dit geeft een korte uitleg over de oorzaak van de fout. Voor succesvolle transacties wordt dit geretourneerd als "Ok". |
| Geretourneerd | issuer XPath: /billing/payment/issuer |
Alfanumeriek (255) | De uitgever van de kaart van de klant. |
| Geretourneerd | issuercountryiso2a XPath: /billing/payment/issuercountry |
Alpha (2) |
Het land voor de uitgever van de kaart van de klant. |
| Geretourneerd | livestatus XPath: /live |
Numeriek (1) |
|
| Geretourneerd | maskedpan XPath: /billing/payment/pan |
Alfanumeriek, inclusief "#" (12-19) |
Als tokenisedpayment wordt niet teruggestuurd: Als tokenisedpayment wordt teruggestuurd met waarde 1: |
| Geretourneerd | merchantnumber XPath: /merchant/merchantnumber |
Alfanumeriek (32) | Het handelaarsnummer dat werd gebruikt om de transactie te verwerken. Verstrekt door de wervende bank. |
| Geretourneerd | operatorname XPath: /merchant/operatorname |
Alfanumeriek (255) | De waarde van dit veld bevat de naam van de gebruiker die het verzoek heeft verwerkt. |
| Geretourneerd | paymenttypedescription XPath: /billing/payment/@type |
Alpha (20) | Betalingsmethode (bijv. "VISA" of "MASTERCARD"). |
| Geretourneerd | requesttypedescription XPath: /@type |
Alpha (20) | "REFUND" wordt geretourneerd in het antwoord. |
| Geretourneerd | securityresponseaddress XPath: /security/address |
Numeriek (1) |
Het resultaat van AVS controles. |
| Geretourneerd | securityresponsepostcode XPath: /security/postcode |
Numeriek (1) |
Het resultaat van AVS controles. |
| Geretourneerd | securityresponsesecuritycode XPath: /security/securitycode |
Numeriek (1) |
Het resultaat van beveiligingscodecontroles. |
| Geretourneerd | settleduedate XPath: /settlement/settleduedate |
Datum JJJJ-MM-DD | De datum waarop de transactie zal worden afgewikkeld. |
| Geretourneerd | settlestatus XPath: /settlement/settlestatus |
Numeriek (3) |
Een numerieke waarde die wordt gebruikt om de voortgang van afwikkeling met betrekking tot deze transactie aan te geven. |
| Geretourneerd | transactionreference XPath: /transactionreference |
Alfanumeriek, inclusief koppeltekens (25) |
Een unieke referentie voor de transactie toegewezen door Trust Payments. U hebt deze referentie nodig om een terugbetaling of de transactie bij te werken. |
| Geretourneerd | transactionstartedtimestamp XPath: /timestamp |
Datum tijd JJJJ-MM-DD hh:mm:ss | Het tijdstip waarop de transactie werd verwerkt. |
| Conditioneel | acquireradvicecode XPath: /acquireradvicecode |
Numeriek (1) |
Een numerieke waarde die wordt geretourneerd na een verzoek om herhaalde betaling en die aangeeft of verdere betalingen kunnen worden verwerkt. In kaart brengen:
Dit varieert afhankelijk van uw wervende bank. Neem contact op met uw bank voor meer informatie. |
| Conditioneel | acquirerresponsecode XPath: /acquirerresponsecode |
Alfanumeriek (255) |
Gebruikt door uw verwerver om het resultaat van het verzoek aan te geven. Dit varieert afhankelijk van uw wervende bank. Neem contact op met uw bank voor meer informatie. |
| Conditioneel | acquirerresponsemessage XPath: /acquirerresponsemessage |
Alfanumeriek (255) |
Gebruikt door uw verwerver om het resultaat van het verzoek aan te geven. Dit varieert afhankelijk van uw wervende bank. Neem contact op met uw bank voor meer informatie. |
| Conditioneel | authcode XPath: /authcode |
Alfanumeriek (255) |
De autorisatie code verstrekt door de uitgevende bank. Deze zal verschillen afhankelijk van de bank die u gebruikt. Wordt alleen geretourneerd als de transactie is toegestaan. |
| Conditioneel | customeraccountnumbertype XPath: /customer/accountnumber/@type |
Alfa (7) |
Ofwel "CARD" of "ACCOUNT". When the customeraccountnumber value submitted in the request is a card number, this field will be populated with "CARD" in the response. |
| Conditioneel | errordata XPath: /error/data |
Alfanumeriek (255) |
Aanvullende informatie om te helpen bij het oplossen van de fout. Wordt alleen geretourneerd als er een fout is opgetreden. |
| Conditioneel | 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). Wordt geretourneerd als dit wordt opgegeven in het verzoek. |
| Conditioneel | merchantcategorycode XPath: /merchant/merchantcategorycode |
Alfanumeriek (255) |
Dit zijn gegevens die verband houden met de account die wordt gebruikt om de transactie te verwerken. Om deze velden te wijzigen, kunt u contact op met ons ondersteuningsteam. De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie. |
| Conditioneel | merchantcity XPath: /merchant/merchantcity |
Alfanumeriek (127) |
Dit zijn gegevens die verband houden met de account die wordt gebruikt om de transactie te verwerken. Om deze velden te wijzigen, kunt u contact op met ons ondersteuningsteam. De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie. |
| Conditioneel | merchantcountryiso2a XPath: /merchant/merchantcountryiso2a |
Alpha (2) |
Dit zijn gegevens die verband houden met de account die wordt gebruikt om de transactie te verwerken. Om deze velden te wijzigen, kunt u contact op met ons ondersteuningsteam. De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie. |
| Conditioneel | merchantname XPath: /merchant/merchantname |
Alfanumeriek (255) |
Dit zijn gegevens die verband houden met de account die wordt gebruikt om de transactie te verwerken. Om deze velden te wijzigen, kunt u contact op met ons ondersteuningsteam. De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie. |
| Conditioneel | merchantstatecode XPath: /merchant/merchantstatecode |
Alfanumeriek (127) |
Dit zijn gegevens die verband houden met de account die wordt gebruikt om de transactie te verwerken. Om deze velden te wijzigen, kunt u contact op met ons ondersteuningsteam. De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie. |
| Conditioneel | merchantzipcode XPath: /merchant/merchantzipcode |
Alfanumeriek (10) |
Dit zijn gegevens die verband houden met de account die wordt gebruikt om de transactie te verwerken. Om deze velden te wijzigen, kunt u contact op met ons ondersteuningsteam. De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie. |
| Conditioneel | orderreference XPath: /merchant/orderreference |
Alfanumeriek, inclusief symbolen (25) |
Uw unieke bestelreferentie die in het Trust Payments systeem kan worden opgeslagen. Dit veld wordt geretourneerd als het wordt ingediend in het verzoek of wordt geërfd van een ouder. |
| Conditioneel | parenttransactionreference XPath: /operation/parenttransactionreference |
Alfanumeriek en koppeltekens (25) |
De transactionreference van een eerder verzoek, waarvan de belangrijkste details geërfd. Dit veld wordt teruggestuurd indien het in het verzoek is ingediend. |
| Conditioneel | retrievalreferencenumber XPath: /other/retrievalreferencenumber |
Alfanumeriek (255) |
Een ISO-term. Deze wordt gebruikt om te verwijzen naar de brontransactie. Dit hangt af van uw acquiring bank. |
| Conditioneel | stan XPath: /other/stan |
ISO 8583 |
Het STAN System Trace Audit Number) dat aan de transactie is gekoppeld. Dit volgt de ISO 8583-norm. Dit veld wordt teruggegeven indien het beschikbaar is. |
| Conditioneel | tokenisedpayment XPath: /billing/payment/pan/@tokenised |
Numeriek (1) |
Als dit veld wordt teruggestuurd met waarde 1, betekent dit dat de transactie is verwerkt met gebruikmaking van een token. Dit veld wordt geretourneerd als de betaling is verricht met een token. |
| Conditioneel | tokentype XPath: /billing/payment/pan/@tokentype |
Alfanumeriek (50) |
Wordt gebruikt om het type token te identificeren dat voor deze betaling wordt gebruikt (bv. "VISATOKEN"). Dit veld wordt geretourneerd als de betaling is verricht met een token. |
| Conditioneel | transactiontypeindicator XPath: /merchant/transactiontypeindicator |
Alfanumeriek (3) |
"C07" — Person-to-Person Transfer Wordt geretourneerd als dit wordt opgegeven in het verzoek. |
| Conditioneel | walletdisplayname XPath: /billing/payment/wallet/displayname |
Alfanumeriek (255) |
Dit bevat gewoonlijk de laatste vier cijfers van het kaartnummer van de klant (bv. "1111"). Dit veld wordt teruggegeven als de betaling met een portemonnee is verricht. |
| Conditioneel | walletsource XPath: /billing/payment/wallet/source |
Alfanumeriek (20) |
Wordt gebruikt om het type portemonnee te identificeren dat voor deze betaling wordt gebruikt (bijv. "APPLEPAY"). Dit veld wordt teruggegeven als de betaling met een portemonnee is verricht. |
Payout afwikkeling
De stroom afwikkeling is afhankelijk van het protocol dat wordt gebruikt om de Payout uit te voeren.
Mastercard MoneySend
While the funds are typically transferred to the recipient in less than 30 minutes, MoneySend payouts will initially have settlestatus=10. Een batchproces wordt dagelijks uitgevoerd, waarbij de settlestatus van succesvolle overdrachten naar 100.
Visa Direct
Overschrijvingen die worden verwerkt via Visa Direct worden meestal in minder dan 30 minuten overgemaakt naar de ontvanger. De settlestatus van de overdracht wordt onmiddellijk ingesteld op 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:
- Als het Payout verzoek succesvol is, settlestatus=0
- afwikkeling wordt dagelijks in batches uitgevoerd, waarna Payouts wordt bijgewerkt naar settlestatus=100 om een succesvolle afwikkeling aan te geven.
- De overdracht wordt normaal gesproken binnen 24 uur voltooid.
Aanvullende opmerkingen
Politiek prominente personen (PEP) of sanctiescreening
Verzoeken om Payouts te verwerken waarbij Trust Payments een PEP of sanctiescreening uitvoert op de ontvanger, zijn onderworpen aan strikte vereisten. De volgende velden moeten worden opgegeven in het Payout verzoek:
Als u dit niet doet, kan de foutmelding 60044 "Screening ontvanger mislukt" worden teruggestuurd.
- billingcountryiso2a
- billingdob
- billingfirstname
- billinglastname
Richtlijnen voor testen
Bij het testen kun je de volgende testkaartgegevens gebruiken:
- Visa kaart "4111 1111 1111 1111" of Mastercard "5100 0000 0000 0511".
- Stel de vervaldatum in op elke geldige datum in de toekomst.
- Gebruik veiligheidscode "123".
U kunt ook verschillende baseamount waarden om het resultaat van het verzoek te beïnvloeden:
- baseamount 70000 retourneert een geweigerd antwoord van de testbank.
- baseamount 60010 retourneert een systeemfout bank van de testbank.
- baseamount 1050 geeft een geautoriseerd antwoord van de testbank.
Genereer en verzend je eigen plaatsvervangende naam van de afzender/ontvanger, adres, geboortedatum en/of rekeningnummer enz. tijdens het testen.
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.
