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 worden gebruikt om geld bij te schrijven op een andere bankrekening. Gebruikelijke voorbeelden hiervan zijn:
- Klanten toestaan om geld op te nemen van hun rekening bij jou.
- Een verzekeringsclaim uitbetalen aan een klant.
Payouts zijn ook bekend als Credit Fund Transfers (CFT) of Original Credit Transfers (OCT).
Payouts naar Visa-merkkaarten worden verwerkt via het Visa Direct-protocol.
Klik hier voor meer informatie.
Kansspelen Payouts naar Mastercard-branded kaarten worden verwerkt via het Mastercard Gaming and Gambling Payments Program.
Klik hier voor meer informatie.
Non-Gaming Payouts naar Mastercard-branded kaarten worden verwerkt via het Mastercard MoneySend Programma.
Klik hier voor meer informatie.
Vereisten
Aan uw Trust Payments account moet een CFT Merchant Number gekoppeld zijn. Als u niet zeker weet of uw handelaarsnummer dit ondersteunt, raden wij u aan contact op te nemen met uw bank voor opheldering. Zorg er bovendien voor dat u de richtlijnen van uw bank volgt voordat u verder gaat.
Voorbeelden van verzoeken/antwoorden
Om een Payout te verwerken, moet je een Payout verzoek indienen met behulp van onze Webservices API. Zie de onderstaande codevoorbeelden.
Om een Payout succesvol te verwerken, is het noodzakelijk dat je verzoek het volgende bevat:
- accounttypedescription=CFT
- requesttypedescriptions=REFUND
Voorbeeld aanvraag
#!/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. Klik hier voor een volledige lijst.
Voorbeeld van een antwoord
{
u 'requestreference': u 'Agv3epv31',
u 'version': u '1.00',
u 'responses': [{
u 'accounttypedescription': u 'CFT',
u 'acquirerresponsecode': u '00',
u 'acquirerresponsemessage': u 'Approved or completed Successfully',
u 'authcode': u 'ABC123',
u 'baseamount': u '1',
u 'chargedescription': u 'Charge description',
u 'cryptocurrencyindicator': u '0',
u 'currencyiso3a': u 'GBP',
u 'dccenabled': u '0',
u 'debtrepayment': u '0',
u 'errorcode': u '0',
u 'errormessage': u 'Ok',
u 'issuer': u 'ISSUER NAME',
u 'issuercountryiso2a': u 'GB',
u 'livestatus': u '1',
u 'maskedpan': u '411111######1111',
u 'merchantcategorycode': u '7995',
u 'merchantcity': u 'Test City',
u 'merchantcountryiso2a': u 'GB',
u 'merchantname': u 'Test Merchant',
u 'merchantnumber': u '000104900099999',
u 'merchantzipcode': u 'TR45 6ST',
u 'operatorname': u 'webservices@merchant.com',
u 'parenttransactionreference': u '60-102-99999999',
u 'paymenttypedescription': u 'VISA',
u 'requesttypedescription': u 'REFUND',
u 'retrievalreferencenumber': u '334918601688',
u 'securityresponseaddress': u '0',
u 'securityresponsepostcode': u '0',
u 'securityresponsesecuritycode': u '0',
u 'settleduedate': u '2023-12-15',
u 'settlestatus': u '100',
u 'stan': u '601688',
u 'transactionreference': u '60-70-99999999',
u 'transactionstartedtimestamp': u '2023-12-15 18:00:42'
}]
}
array(3) {
["requestreference"] => string(9) "A19beknpr"
["responses"] => array(1) {
[0] => array(35) {
["accounttypedescription"] => string(3) "CFT"
["acquirerresponsecode"] => string(2) "00"
["acquirerresponsemessage"] => string(34) "Approved or completed Successfully"
["authcode"] => string(6) "ABC123"
["baseamount"] => string(1) "1"
["chargedescription"] => string(18) "Charge description"
["cryptocurrencyindicator"] => string(1) "0"
["currencyiso3a"] => string(3) "GBP"
["dccenabled"] => string(1) "0"
["debtrepayment"] => string(1) "0"
["errorcode"] => string(1) "0"
["errormessage"] => string(2) "Ok"
["issuer"] => string(11) "ISSUER NAME"
["issuercountryiso2a"] => string(2) "GB"
["livestatus"] => string(1) "1"
["maskedpan"] => string(16) "411111######1111"
["merchantcategorycode"] => string(4) "7995"
["merchantcity"] => string(9) "Test City"
["merchantcountryiso2a"] => string(2) "GB"
["merchantname"] => string(13) "Test Merchant"
["merchantnumber"] => string(15) "000104900099999"
["merchantzipcode"] => string(8) "TR45 6ST"
["operatorname"] => string(24) "webservices@merchant.com"
["parenttransactionreference"] => string(15) "60-102-99999999"
["paymenttypedescription"] => string(4) "VISA"
["requesttypedescription"] => string(6) "REFUND"
["retrievalreferencenumber"] => string(12) "334918601688"
["securityresponseaddress"] => string(1) "0"
["securityresponsepostcode"] => string(1) "0"
["securityresponsesecuritycode"] => string(1) "0"
["settleduedate"] => string(10) "2023-12-15"
["settlestatus"] => string(3) "100"
["stan"] => string(6) "601688"
["transactionreference"] => string(14) "60-70-99999999"
["transactionstartedtimestamp"] => string(19) "2023-12-15 18:00:42"
}
}
["version"] => string(4) "1.00"
}
{
"requestreference": "W57-Ncn48qwu",
"response": [{
"accounttypedescription": "CFT",
"acquirerresponsecode": "00",
"acquirerresponsemessage": "Approved or completed Successfully",
"authcode": "ABC123",
"baseamount": "1",
"chargedescription": "Charge description",
"cryptocurrencyindicator": "0",
"currencyiso3a": "GBP",
"dccenabled": "0",
"debtrepayment": "0",
"errorcode": "0",
"errormessage": "Ok",
"issuer": "ISSUER NAME",
"issuercountryiso2a": "GB",
"livestatus": "1",
"maskedpan": "411111######1111",
"merchantcategorycode": "7995",
"merchantcity": "Test City",
"merchantcountryiso2a": "GB",
"merchantname": "Test Merchant",
"merchantnumber": "000104900099999",
"merchantzipcode": "TR45 6ST",
"operatorname": "webservices@merchant.com",
"parenttransactionreference": "60-102-99999999",
"paymenttypedescription": "VISA",
"requesttypedescription": "REFUND",
"retrievalreferencenumber": "334918601688",
"securityresponseaddress": "0",
"securityresponsepostcode": "0",
"securityresponsesecuritycode": "0",
"settleduedate": "2023-12-15",
"settlestatus": "100",
"stan": "601688",
"transactionreference": "60-70-99999999",
"transactionstartedtimestamp": "2023-12-15 18:00:42"
}],
"secrand": "nN",
"version": "1.00"
}
<responseblock version="3.67">
<requestreference>W57-6yBtc6n0</requestreference>
<response type="REFUND">
<acquirerresponsecode>00</acquirerresponsecode>
<acquirerresponsemessage>Approved or completed Successfully</acquirerresponsemessage>
<authcode>ABC123</authcode>
<billing>
<amount currencycode="GBP">1</amount>
<dcc enabled="0"/>
<payment type="VISA">
<issuer>ISSUER NAME</issuer>
<issuercountry>GB</issuercountry>
<pan>411111######1111</pan>
</payment>
</billing>
<error>
<code>0</code>
<message>Ok</message>
</error>
<live>1</live>
<merchant>
<chargedescription>Charge description</chargedescription>
<debtrepayment>0</debtrepayment>
<merchantcategorycode>7995</merchantcategorycode>
<merchantcity>Test City</merchantcity>
<merchantcountryiso2a>GB</merchantcountryiso2a>
<merchantname>Test Merchant</merchantname>
<merchantnumber>000104900099999</merchantnumber>
<merchantzipcode>TR45 6ST</merchantzipcode>
<operatorname>webservices@merchant.com</operatorname>
</merchant>
<operation>
<accounttypedescription>CFT</accounttypedescription>
<cryptocurrencyindicator>0</cryptocurrencyindicator>
<parenttransactionreference>60-102-99999999</parenttransactionreference>
</operation>
<other>
<retrievalreferencenumber>335212345678</retrievalreferencenumber>
<stan>575503</stan>
</other>
<security>
<address>0</address>
<postcode>0</postcode>
<securitycode>0</securitycode>
</security>
<settlement>
<settleduedate>2023-12-18</settleduedate>
<settlestatus>100</settlestatus>
</settlement>
<timestamp>2023-12-18 15:55:59</timestamp>
<transactionreference>57-70-73675503</transactionreference>
</response>
<secrand>cWq80RAf8JgxC1dv</secrand>
</responseblock>
Voorbeeld aanvraag
#!/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. Klik hier voor een volledige lijst.
Voorbeeld van een antwoord
{
u 'requestreference': u 'Agv3epv31',
u 'version': u '1.00',
u 'responses': [{
u 'accounttypedescription': u 'CFT',
u 'acquirerresponsecode': u '00',
u 'acquirerresponsemessage': u 'Approved or completed Successfully',
u 'authcode': u 'ABC123',
u 'baseamount': u '1',
u 'chargedescription': u 'Charge description',
u 'cryptocurrencyindicator': u '0',
u 'currencyiso3a': u 'GBP',
u 'dccenabled': u '0',
u 'debtrepayment': u '0',
u 'errorcode': u '0',
u 'errormessage': u 'Ok',
u 'issuer': u 'ISSUER NAME',
u 'issuercountryiso2a': u 'GB',
u 'livestatus': u '1',
u 'maskedcustomeraccountnumber': u '12345678',
u 'maskedpan': u '545454######5454',
u 'merchantcategorycode': u '6537',
u 'merchantcity': u 'Test City',
u 'merchantcountryiso2a': u 'GB',
u 'merchantname': u 'Test Merchant',
u 'merchantnumber': u '000123456789012',
u 'merchantzipcode': u 'TR45 6ST',
u 'operatorname': u 'webservices@merchant.com',
u 'parenttransactionreference': u '60-102-99999999',
u 'paymenttypedescription': u 'MASTERCARD',
u 'requesttypedescription': u 'REFUND',
u 'retrievalreferencenumber': u '334918601688',
u 'securityresponseaddress': u '0',
u 'securityresponsepostcode': u '0',
u 'securityresponsesecuritycode': u '0',
u 'settleduedate': u '2023-12-15',
u 'settlestatus': u '10',
u 'stan': u '601688',
u 'transactionreference': u '60-70-99999999',
u 'transactionstartedtimestamp': u '2023-12-15 18:00:42',
u 'transactiontypeindicator': u 'C55'
}]
}
array(3) {
["requestreference"] => string(9) "A19beknpr"
["responses"] => array(1) {
[0] => array(37) {
["accounttypedescription"] => string(3) "CFT"
["acquirerresponsecode"] => string(2) "00"
["acquirerresponsemessage"] => string(34) "Approved or completed Successfully"
["authcode"] => string(6) "ABC123"
["baseamount"] => string(1) "1"
["chargedescription"] => string(18) "Charge description"
["cryptocurrencyindicator"] => string(1) "0"
["currencyiso3a"] => string(3) "GBP"
["dccenabled"] => string(1) "0"
["debtrepayment"] => string(1) "0"
["errorcode"] => string(1) "0"
["errormessage"] => string(2) "Ok"
["issuer"] => string(11) "ISSUER NAME"
["issuercountryiso2a"] => string(2) "GB"
["livestatus"] => string(1) "1"
["maskedcustomeraccountnumber"] => string(8) "12345678"
["maskedpan"] => string(16) "545454######5454"
["merchantcategorycode"] => string(4) "6537"
["merchantcity"] => string(9) "Test City"
["merchantcountryiso2a"] => string(2) "GB"
["merchantname"] => string(13) "Test Merchant"
["merchantnumber"] => string(15) "000123456789012"
["merchantzipcode"] => string(8) "TR45 6ST"
["operatorname"] => string(24) "webservices@merchant.com"
["parenttransactionreference"] => string(15) "60-102-99999999"
["paymenttypedescription"] => string(10) "MASTERCARD"
["requesttypedescription"] => string(6) "REFUND"
["retrievalreferencenumber"] => string(12) "334918601688"
["securityresponseaddress"] => string(1) "0"
["securityresponsepostcode"] => string(1) "0"
["securityresponsesecuritycode"] => string(1) "0"
["settleduedate"] => string(10) "2023-12-15"
["settlestatus"] => string(2) "10"
["stan"] => string(6) "601688"
["transactionreference"] => string(14) "60-70-99999999"
["transactionstartedtimestamp"] => string(19) "2023-12-15 18:00:42"
["transactiontypeindicator"] => string(3) "C55"
}
}
["version"] => string(4) "1.00"
}
{
"requestreference": "W60-B6c1u7bY",
"response": [{
"accounttypedescription": "CFT",
"acquirerresponsecode": "00",
"acquirerresponsemessage": "Approved or completed Successfully",
"authcode": "ABC123",
"baseamount": "1",
"chargedescription": "Charge description",
"cryptocurrencyindicator": "0",
"currencyiso3a": "GBP",
"dccenabled": "0",
"debtrepayment": "0",
"errorcode": "0",
"errormessage": "Ok",
"issuer": "ISSUER NAME",
"issuercountryiso2a": "GB",
"livestatus": "1",
"maskedcustomeraccountnumber": "12345678",
"maskedpan": "545454######5454",
"merchantcategorycode": "6537",
"merchantcity": "Test City",
"merchantcountryiso2a": "GB",
"merchantname": "Test Merchant",
"merchantnumber": "000123456789012",
"merchantzipcode": "TR45 6ST",
"operatorname": "webservices@merchant.com",
"parenttransactionreference": "60-102-99999999",
"paymenttypedescription": "MASTERCARD",
"requesttypedescription": "REFUND",
"retrievalreferencenumber": "334918601688",
"securityresponseaddress": "0",
"securityresponsepostcode": "0",
"securityresponsesecuritycode": "0",
"settleduedate": "2023-12-15",
"settlestatus": "10",
"stan": "601688",
"transactionreference": "60-70-99999999",
"transactionstartedtimestamp": "2023-12-15 18:00:42",
"transactiontypeindicator": "C55"
}],
"secrand": "nN",
"version": "1.00"
}
<responseblock version="3.67">
<requestreference>W60-1Yj4kh3A</requestreference>
<response type="REFUND">
<acquirerresponsecode>00</acquirerresponsecode>
<acquirerresponsemessage>Approved or completed Successfully</acquirerresponsemessage>
<authcode>ABC123</authcode>
<billing>
<amount currencycode="GBP">1</amount>
<dcc enabled="0"/>
<payment type="MASTERCARD">
<issuer>ISSUER NAME</issuer>
<issuercountry>GB</issuercountry>
<pan>545454######5454</pan>
</payment>
</billing>
<customer>
<accountnumber type="ACCOUNT">999999</accountnumber>
</customer>
<error>
<code>0</code>
<message>Ok</message>
</error>
<live>1</live>
<merchant>
<chargedescription>Charge description</chargedescription>
<debtrepayment>0</debtrepayment>
<merchantcategorycode>6537</merchantcategorycode>
<merchantcity>Test City</merchantcity>
<merchantcountryiso2a>GB</merchantcountryiso2a>
<merchantname>Test Merchant</merchantname>
<merchantnumber>000104900099999</merchantnumber>
<merchantzipcode>TR45 6ST</merchantzipcode>
<operatorname>webservices@merchant.com</operatorname>
<transactiontypeindicator>C55</transactiontypeindicator>
</merchant>
<operation>
<accounttypedescription>CFT</accounttypedescription>
<cryptocurrencyindicator>0</cryptocurrencyindicator>
<parenttransactionreference>60-102-99999999</parenttransactionreference>
</operation>
<other>
<retrievalreferencenumber>335212345678</retrievalreferencenumber>
<stan>607892</stan>
</other>
<security>
<address>0</address>
<postcode>0</postcode>
<securitycode>0</securitycode>
</security>
<settlement>
<settleduedate>2023-12-18</settleduedate>
<settlestatus>10</settlestatus>
</settlement>
<timestamp>2023-12-18 15:51:25</timestamp>
<transactionreference>60-70-99999999</transactionreference>
</response>
<secrand>8A8Rzl2O</secrand>
</responseblock>
Voorbeeld aanvraag
#!/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. Klik hier voor een volledige lijst.
Voorbeeld van een antwoord
{
u 'requestreference': u 'Agv3epv31',
u 'version': u '1.00',
u 'responses': [{
u 'accounttypedescription': u 'CFT',
u 'acquirerresponsecode': u '00',
u 'acquirerresponsemessage': u 'Approved or completed Successfully',
u 'authcode': u 'ABC123',
u 'baseamount': u '1',
u 'chargedescription': u 'Charge description',
u 'cryptocurrencyindicator': u '0',
u 'currencyiso3a': u 'GBP',
u 'dccenabled': u '0',
u 'debtrepayment': u '0',
u 'errorcode': u '0',
u 'errormessage': u 'Ok',
u 'issuer': u 'ISSUER NAME',
u 'issuercountryiso2a': u 'GB',
u 'livestatus': u '1',
u 'maskedcustomeraccountnumber': u '12345678',
u 'maskedpan': u '545454######5454',
u 'merchantcategorycode': u '6537',
u 'merchantcity': u 'Test City',
u 'merchantcountryiso2a': u 'GB',
u 'merchantname': u 'Test Merchant',
u 'merchantnumber': u '000123456789012',
u 'merchantzipcode': u 'TR45 6ST',
u 'operatorname': u 'webservices@merchant.com',
u 'parenttransactionreference': u '60-102-99999999',
u 'paymenttypedescription': u 'MASTERCARD',
u 'requesttypedescription': u 'REFUND',
u 'retrievalreferencenumber': u '334918601688',
u 'securityresponseaddress': u '0',
u 'securityresponsepostcode': u '0',
u 'securityresponsesecuritycode': u '0',
u 'settleduedate': u '2023-12-15',
u 'settlestatus': u '10',
u 'stan': u '601688',
u 'transactionreference': u '60-70-99999999',
u 'transactionstartedtimestamp': u '2023-12-15 18:00:42',
u 'transactiontypeindicator': u 'C52'
}]
}
array(3) {
["requestreference"] => string(9) "A19beknpr"
["responses"] => array(1) {
[0] => array(37) {
["accounttypedescription"] => string(3) "CFT"
["acquirerresponsecode"] => string(2) "00"
["acquirerresponsemessage"] => string(34) "Approved or completed Successfully"
["authcode"] => string(6) "ABC123"
["baseamount"] => string(1) "1"
["chargedescription"] => string(18) "Charge description"
["cryptocurrencyindicator"] => string(1) "0"
["currencyiso3a"] => string(3) "GBP"
["dccenabled"] => string(1) "0"
["debtrepayment"] => string(1) "0"
["errorcode"] => string(1) "0"
["errormessage"] => string(2) "Ok"
["issuer"] => string(11) "ISSUER NAME"
["issuercountryiso2a"] => string(2) "GB"
["livestatus"] => string(1) "1"
["maskedcustomeraccountnumber"] => string(8) "12345678"
["maskedpan"] => string(16) "545454######5454"
["merchantcategorycode"] => string(4) "6537"
["merchantcity"] => string(9) "Test City"
["merchantcountryiso2a"] => string(2) "GB"
["merchantname"] => string(13) "Test Merchant"
["merchantnumber"] => string(15) "000123456789012"
["merchantzipcode"] => string(8) "TR45 6ST"
["operatorname"] => string(24) "webservices@merchant.com"
["parenttransactionreference"] => string(15) "60-102-99999999"
["paymenttypedescription"] => string(10) "MASTERCARD"
["requesttypedescription"] => string(6) "REFUND"
["retrievalreferencenumber"] => string(12) "334918601688"
["securityresponseaddress"] => string(1) "0"
["securityresponsepostcode"] => string(1) "0"
["securityresponsesecuritycode"] => string(1) "0"
["settleduedate"] => string(10) "2023-12-15"
["settlestatus"] => string(2) "10"
["stan"] => string(6) "601688"
["transactionreference"] => string(14) "60-70-99999999"
["transactionstartedtimestamp"] => string(19) "2023-12-15 18:00:42"
["transactiontypeindicator"] => string(3) "C52"
}
}
["version"] => string(4) "1.00"
}
{
"requestreference": "W60-B6c1u7bY",
"response": [{
"accounttypedescription": "CFT",
"acquirerresponsecode": "00",
"acquirerresponsemessage": "Approved or completed Successfully",
"authcode": "ABC123",
"baseamount": "1",
"chargedescription": "Charge description",
"cryptocurrencyindicator": "0",
"currencyiso3a": "GBP",
"dccenabled": "0",
"debtrepayment": "0",
"errorcode": "0",
"errormessage": "Ok",
"issuer": "ISSUER NAME",
"issuercountryiso2a": "GB",
"livestatus": "1",
"maskedcustomeraccountnumber": "12345678",
"maskedpan": "545454######5454",
"merchantcategorycode": "6537",
"merchantcity": "Test City",
"merchantcountryiso2a": "GB",
"merchantname": "Test Merchant",
"merchantnumber": "000123456789012",
"merchantzipcode": "TR45 6ST",
"operatorname": "webservices@merchant.com",
"parenttransactionreference": "60-102-99999999",
"paymenttypedescription": "MASTERCARD",
"requesttypedescription": "REFUND",
"retrievalreferencenumber": "334918601688",
"securityresponseaddress": "0",
"securityresponsepostcode": "0",
"securityresponsesecuritycode": "0",
"settleduedate": "2023-12-15",
"settlestatus": "10",
"stan": "601688",
"transactionreference": "60-70-99999999",
"transactionstartedtimestamp": "2023-12-15 18:00:42",
"transactiontypeindicator": "C52"
}],
"secrand": "nN",
"version": "1.00"
}
<responseblock version="3.67">
<requestreference>W60-1Yj4kh3A</requestreference>
<response type="REFUND">
<acquirerresponsecode>00</acquirerresponsecode>
<acquirerresponsemessage>Approved or completed Successfully</acquirerresponsemessage>
<authcode>ABC123</authcode>
<billing>
<amount currencycode="GBP">1</amount>
<dcc enabled="0"/>
<payment type="MASTERCARD">
<issuer>ISSUER NAME</issuer>
<issuercountry>GB</issuercountry>
<pan>545454######5454</pan>
</payment>
</billing>
<customer>
<accountnumber type="ACCOUNT">999999</accountnumber>
</customer>
<error>
<code>0</code>
<message>Ok</message>
</error>
<live>1</live>
<merchant>
<chargedescription>Charge description</chargedescription>
<debtrepayment>0</debtrepayment>
<merchantcategorycode>6537</merchantcategorycode>
<merchantcity>Test City</merchantcity>
<merchantcountryiso2a>GB</merchantcountryiso2a>
<merchantname>Test Merchant</merchantname>
<merchantnumber>000104900099999</merchantnumber>
<merchantzipcode>TR45 6ST</merchantzipcode>
<operatorname>webservices@merchant.com</operatorname>
<transactiontypeindicator>C52</transactiontypeindicator>
</merchant>
<operation>
<accounttypedescription>CFT</accounttypedescription>
<cryptocurrencyindicator>0</cryptocurrencyindicator>
<parenttransactionreference>60-102-99999999</parenttransactionreference>
</operation>
<other>
<retrievalreferencenumber>335212345678</retrievalreferencenumber>
<stan>607892</stan>
</other>
<security>
<address>0</address>
<postcode>0</postcode>
<securitycode>0</securitycode>
</security>
<settlement>
<settleduedate>2023-12-18</settleduedate>
<settlestatus>10</settlestatus>
</settlement>
<timestamp>2023-12-18 15:51:25</timestamp>
<transactionreference>60-70-99999999</transactionreference>
</response>
<secrand>8A8Rzl2O</secrand>
</responseblock>
Payout veldspecificatie
Payout specificatie verzoekveld
|
Veld |
Formaat | Beschrijving | ||
| accounttypedescription XPath: /operatie/accounttypedescription |
Alpha (20) | Moet "CFT" zijn. | ||
| 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". |
||
| billingcountryiso2a XPath: /factuur/land |
Alpha (2) |
Het land voor het factuuradres van de ontvanger. Dit moet in ISO2A-formaat zijn. Klik hier voor een volledige lijst van landcodes. Vereist bij het verwerken van Payouts waarbij Trust Payments een PEP of sanctiescreening uitvoert op de ontvanger. Opmerking: er wordt geen antwoord voor ongeldige velden teruggestuurd als dit verplichte veld niet is opgenomen. |
||
| billingdob XPath: /billing/dob |
Datum JJJJ-MM-DD |
De geboortedatum van de ontvanger. Vereist bij het verwerken van Payouts waarbij Trust Payments een PEP of sanctiescreening uitvoert op de ontvanger. Opmerking: er wordt een ongeldig veldantwoord teruggestuurd als dit verplichte veld niet is opgenomen en de gebruikte site referentie is ingeschakeld voor MoneySend. |
||
| billingfirstname XPath: /factuur/naam/eerste |
Alfanumeriek, inclusief symbolen (127) |
De ontvanger Voornaam facturatie. Vereist bij het verwerken van Payouts waarbij Trust Payments een PEP of sanctiescreening uitvoert op de ontvanger. Opmerking: er wordt een ongeldig veldantwoord teruggestuurd als dit verplichte veld niet is opgenomen en de gebruikte sitereference is ingeschakeld voor MoneySend. |
||
| billinglastname XPath: /factuur/naam/laatste |
Alfanumeriek, inclusief symbolen (127) |
De ontvanger Achternaam facturatie. Vereist bij het verwerken van Payouts waarbij Trust Payments een PEP of sanctiescreening uitvoert op de ontvanger. Opmerking: er wordt een ongeldig veldantwoord teruggestuurd als dit verplichte veld niet is opgenomen en de gebruikte sitereference is ingeschakeld voor MoneySend. |
||
| currencyiso3a XPath: /factuur/bedrag/@currencycode |
Alpha (3) |
De Munt waarin de transactie zal worden verwerkt. Klik hier voor een volledige lijst van beschikbare munteenheden. |
||
| requesttypedescriptions XPath: /@type |
Alfanumeriek en koppeltekens (25) |
De vereiste Verzoektype is "REFUND". | ||
| 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. | ||
| 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. Vereist voor Visa Direct-betalingen die worden verwerkt met in Canada uitgegeven kaarten. Vereist voor Mastercard MoneySend Betalingen waarbij het ontvangende land (billingcountryiso2a) "US" (Verenigde Staten) of "CA" (Canada) is. |
||
| billingstreet XPath: /factuur/straat |
Alfanumeriek, inclusief symbolen (127) |
De straat die is ingevoerd voor het factuuradres van de ontvanger. Vereist voor Visa Direct-betalingen die worden verwerkt met in Canada uitgegeven kaarten. |
||
| billingtown XPath: /factuur/stad |
Alfanumeriek, inclusief symbolen (127) |
De stad die is ingevoerd voor het factuuradres van de ontvanger. Vereist voor Visa Direct-betalingen die worden verwerkt met in Canada uitgegeven kaarten. |
||
|
Overdrachtsvelden Voor Mastercard betalingen met transactietypeindicator = "C52": ALLE velden hier zijn verplicht. |
||||
| | cftsourceoffunds XPath: /merchant/cftsourceoffunds |
Numeriek (2) |
De geldbron voor de Payout. "01" - Credit |
|
| | customeraccountnumbertype XPath: /customer/accountnumber/@type |
Alfa (7) |
Stuur "CARD" of "ACCOUNT". |
|
| customeraccountnumber XPath: /customer/accountnumber |
Numeriek (20) |
Als customeraccountnumbertype is "ACCOUNT"Voer het rekeningnummer van de verzender in. Als customeraccountnumbertype is "CARD"Voer het kaartnummer van de verzender in. |
||
|
Contactvelden afzender Voor Mastercard betalingen met transactietypeindicator = "C52": ALLE velden hier zijn verplicht. |
||||
| | customercountryiso2a XPath: /customer/country |
Alpha (2) |
Het land van de verzender in ISO2A-formaat. |
|
| | 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. Vereist voor Mastercard MoneySend Betalingen waarbij het land van de afzender (customercountryiso2a) "US" (Verenigde Staten) of "CA" (Canada) is. |
|
| | customerfirstname XPath: /customer/name/first |
Alfanumeriek, inclusief symbolen (127) |
De voornaam van de afzender. |
|
| | customerlastname XPath: /customer/name/last |
Alfanumeriek, inclusief symbolen (127) |
De achternaam van de afzender. |
|
| | customerpremise XPath: /klant/premise |
Alfanumeriek, inclusief symbolen (25) |
De naam/het nummer van het eigendom van de afzender. Optioneel voor Mastercard MoneySend Betalingen als customerstreet is ingediend. |
|
| | customerstreet XPath: /customer/street |
Alfanumeriek, inclusief symbolen (127) |
De straatnaam van de afzender. Optioneel voor Mastercard MoneySend Betalingen als customerpremise is ingediend. |
|
| | customertown XPath: /customer/town |
Alfanumeriek, inclusief symbolen (127) |
De stad van de afzender. |
|
| expirydate XPath: /factuur/betaling/expirydate |
Datum MM/JJJJ |
De vervaldatum van de kaart. Vereist wanneer pan wordt ingediend. Optioneel wanneer parenttransactionreference wordt ingediend. |
||
| pan XPath: /factuur/betaling/pan |
Numeriek (12-19) |
Het kaartnummer van de klant. Vereist wanneer parenttransactionreference NIET is ingediend. |
||
| parenttransactionreference XPath: /operatie/parenttransactionreference |
Alfanumeriek & 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. |
||
| transactietypeindicator XPath: /merchant/transactietypeindicator |
Alfanumeriek (3) |
Specificeert het Mastercard MoneySend Transactietype - Ondersteunde waarden:
Vereist door Mastercard voor alle MoneySend betalingstransacties. Opmerking: er wordt een ongeldig veldantwoord teruggestuurd als dit verplichte veld niet is opgenomen voor Mastercard betalingstypen en de gebruikte sitereference is ingeschakeld voor MoneySend. |
||
| billingpremise XPath: /billing/premise |
Alfanumeriek, inclusief symbolen (25) |
De naam/het nummer van het eigendom voor het factuuradres van de ontvanger. |
||
| 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. |
||
Payout specificatie antwoordveld
| Veld | Formaat | Beschrijving | |
| accounttypedescription XPath: /operation/accounttypedescription |
Alpha (20) |
"CFT" wordt geretourneerd in het antwoord. |
|
| 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". | |
| 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. |
|
| cryptocurrencyindicator XPath: /operation/cryptocurrencyindicator |
Numeriek (1) |
Geeft aan of de transactie is gemarkeerd als een aankoop van cryptocurrency:
|
|
| currencyiso3a XPath: /billing/amount/@currencycode |
Alpha (3) |
De Munt van de transactie. Klik hier voor een volledige lijst van beschikbare munteenheden. |
|
| dccenabled XPath: /billing/dcc/@enabled |
Numeriek (1) |
Geeft aan of uw account is geconfigureerd voor DCC:
|
|
| debtrepayment XPath: /merchant/debtrepayment |
Numeriek (1) |
Geeft aan of een transactie gemarkeerd is als schuldaflossing:
|
|
| errorcode XPath: /error/code |
Numeriek (1-5) |
De foutcode (errorcode) moet worden gebruikt om te bepalen of het verzoek succesvol was of niet.
Klik hier voor een volledige lijst van errorcode en berichtwaarden. |
|
| 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". Klik hier voor een volledige lijst van errorcode en berichtwaarden. |
|
| issuer XPath: /billing/payment/issuer |
Alfanumeriek (255) | De uitgever van de kaart van de klant. | |
| issuercountryiso2a XPath: /billing/payment/issuercountry |
Alpha (2) |
Het land voor de uitgever van de kaart van de klant. |
|
| livestatus XPath: /live |
Numeriek (1) |
|
|
| maskedpan XPath: /billing/payment/pan |
Alfanumeriek, inclusief "#" (12-19) |
Als tokenisedpayment wordt niet teruggestuurd: Als tokenisedpayment wordt teruggestuurd met waarde 1: |
|
| merchantnumber XPath: /merchant/merchantnumber |
Alfanumeriek (32) |
Het handelaarsnummer dat werd gebruikt om de transactie te verwerken. Verstrekt door de wervende bank. |
|
| operatorname XPath: /merchant/operatorname |
Alfanumeriek (255) | De waarde van dit veld bevat de naam van de gebruiker die het verzoek heeft verwerkt. | |
| paymenttypedescription XPath: /billing/payment/@type |
Alpha (20) | Betalingsmethode (bijv. "VISA" of "MASTERCARD"). | |
| requesttypedescription XPath: /@type |
Alpha (20) |
"REFUND" wordt geretourneerd in het antwoord. |
|
| securityresponseaddress XPath: /security/address |
Numeriek (1) |
Het resultaat van AVS controles. |
|
| securityresponsepostcode XPath: /security/postcode |
Numeriek (1) |
Het resultaat van AVS controles. |
|
| securityresponsesecuritycode XPath: /security/securitycode |
Numeriek (1) |
Het resultaat van beveiligingscodecontroles. |
|
| settleduedate XPath: /settlement/settleduedate |
Datum JJJJ-MM-DD | De datum waarop de transactie zal worden afgewikkeld. | |
| 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. Klik hier voor meer informatie over waarden die kunnen worden 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 uit te voeren of de transactie bij te werken. | |
| transactionstartedtimestamp XPath: /timestamp |
Datum tijd JJJJ-MM-DD hh:mm:ss | Het tijdstip waarop de transactie werd verwerkt. | |
| 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. |
|
| 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. |
|
| 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. |
|
| 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. |
|
| customeraccountnumbertype XPath: /customer/accountnumber/@type |
Alfa (7) |
Ofwel "CARD" of "ACCOUNT". Wordt geretourneerd als dit wordt opgegeven in het verzoek. |
|
| 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. |
|
| maskedcustomeraccountnumber XPath: /customer/accountnumber |
Numeriek (20) |
Als het type rekeningnummer "ACCOUNT", het rekeningnummer van de verzender. Als het type rekeningnummer "CARD", het kaartnummer van de verzender. De geretourneerde waarde in het antwoord is in een gemaskeerd formaat, bijvoorbeeld "411111#######1111". Wordt geretourneerd als dit wordt opgegeven in het verzoek. |
|
| merchantcategorycode XPath: /merchant/merchantcategorycode |
Alfanumeriek (255) |
Dit zijn gegevens die gekoppeld zijn aan de rekening die gebruikt wordt om de transactie te verwerken. Om deze velden te wijzigen, kunt u contact opnemen met ons Support Team. De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie. |
|
| merchantcity XPath: /merchant/merchantcity |
Alfanumeriek (127) |
Dit zijn gegevens die gekoppeld zijn aan de rekening die gebruikt wordt om de transactie te verwerken. Om deze velden te wijzigen, kunt u contact opnemen met ons Support Team. De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie. |
|
| merchantcountryiso2a XPath: /merchant/merchantcountryiso2a |
Alpha (2) |
Dit zijn gegevens die gekoppeld zijn aan de rekening die gebruikt wordt om de transactie te verwerken. Om deze velden te wijzigen, kunt u contact opnemen met ons Support Team. De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie. |
|
| merchantname XPath: /merchant/merchantname |
Alfanumeriek (255) |
Dit zijn gegevens die gekoppeld zijn aan de rekening die gebruikt wordt om de transactie te verwerken. Om deze velden te wijzigen, kunt u contact opnemen met ons Support Team. De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie. |
|
| merchantstatecode XPath: /merchant/merchantstatecode |
Alfanumeriek (127) |
Dit zijn gegevens die gekoppeld zijn aan de rekening die gebruikt wordt om de transactie te verwerken. Om deze velden te wijzigen, kunt u contact opnemen met ons Support Team. De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie. |
|
| merchantzipcode XPath: /merchant/merchantzipcode |
Alfanumeriek (10) |
Dit zijn gegevens die gekoppeld zijn aan de rekening die gebruikt wordt om de transactie te verwerken. Om deze velden te wijzigen, kunt u contact opnemen met ons Support Team. De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie. |
|
| 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. |
|
| 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. |
|
|
retrievalreferencenumber |
Alfanumeriek (255) |
Een ISO-term. Deze wordt gebruikt om te verwijzen naar de brontransactie. Dit hangt af van uw acquiring bank. |
|
|
stan |
ISO 8583 |
Het STAN (System Trace Audit Number) dat bij de transactie hoort. Dit volgt de ISO 8583-norm. Dit veld wordt teruggegeven indien het beschikbaar is. |
|
| 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. |
|
| 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. |
|
| transactiontypeindicator XPath: /merchant/transactiontypeindicator |
Alfanumeriek (3) |
Wordt geretourneerd als dit wordt opgegeven in het verzoek. |
|
| 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. |
|
| 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.
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 MoneySend & Betalingen voor kansspelen
Hoewel het geld meestal in minder dan 30 minuten naar de ontvanger wordt overgemaakt, hebben MoneySend & Gaming Payments in eerste instantie settlestatus=10. Een batchproces wordt dagelijks uitgevoerd, waarbij de settlestatus van succesvolle overdrachten naar 100.
Andere
Payouts die niet worden verwerkt als Visa Direct of Mastercard MoneySend & Gaming Betalingen volgen dezelfde afwikkeling flow als een standaard e-commerce AUTH of REFUND verzoek:
- 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 dummy/voorbeeldnaam van verzender/ontvanger, adres, geboortedatum en/of rekeningnummer enz. tijdens het testen.
