Een Account Funding Transaction (AFT) is elke transactie waarbij een kaartrekening wordt gedebiteerd om een andere rekening te financieren. De rekening die wordt gefinancierd kan een rekening zijn van de kaarthouder bij de handelaar (bijv. een handelsrekening, prepaidrekening of digitale portemonnee) of een andere persoon of entiteit (bijv. geldoverboeking). De rekening die wordt gefinancierd kan een kaartrekening of een depositorekening zijn.
Visa en Mastercard vereisen dat informatie over de Afzender/Betaler en de Ontvanger/Betaler, inclusief details over de rekening die wordt gefinancierd, wordt verstrekt in alle transacties voor het financieren van rekeningen.
Deze pagina specificeert de veldnamen die Trust Payments oplossingen gebruiken om een transactie te markeren als een Account Funding Transaction (AFT) en de vereiste informatie over de afzender/betaler en ontvanger/begunstigde te verstrekken. Voorbeeldverzoeken voor elke Trust Payments oplossing zijn opgenomen om winkeliers te helpen bij het voldoen aan de vereisten voor het verwerken van Account Funding Transacties.
Over Klant Categorie Codes (MCC)
Uw Klant Categorie Code (MCC) is een viercijferig nummer dat u is toegewezen door uw koper. Het wordt gebruikt om het bedrijf te classificeren aan de hand van het type producten of diensten dat het levert. Als u niet zeker bent van de waarde van uw Klant Categorie Code, neem dan contact op met ons ondersteuningsteam.
De onderstaande voorbeelden zijn specifiek voor de Klant Categorie Code (MCC) en use case van de betreffende merchant. Controleer je MCC met ons support team en gebruik de gegeven voorbeelden om er zeker van te zijn dat je de juiste informatie invult in je verzoeken.
MCC 4829
Handelaars die geclassificeerd zijn met deze MCC staan klanten toe om geld over te maken via een elektronische overschrijving / bankoverschrijving / remittance naar een vermelde entiteit. Voor deze MCC verplichten Visa en Mastercard dat deze transacties dienovereenkomstig worden gemarkeerd en dat aanvullende afzender- en ontvangerinformatie wordt opgenomen in het verzoek.
Het volgende is een voorbeeld van een POST naar Payment Pages die de vereiste velden bevat voor verkopers met MCC 4829:
<html>
<body>
<!-- HTML form POST instruction and endpoint information -->
<form method="POST" action="https://payments.securetrading.net/process/payments/details">
<!-- End of HTML form POST instruction and endpoint information -->
<!-- sitereference; stprofile; and version information -->
<input type="hidden" name="sitereference" value="{{site_reference}}">
<input type="hidden" name="stprofile" value="default">
<input type="hidden" name="version" value="2">
<!-- End of sitereference; stprofile; and version information -->
<!-- Account funding flagging -->
<input type="hidden" name="accountfunding" value="1">
<input type="hidden" name="transactiontypeindicator" value="F07">
<!-- End of Account funding flagging -->
<!-- Sender information -->
<input type="hidden" name="billingdob" value="2001-01-01">
<input type="hidden" name="billingfirstname" value="Jay">
<input type="hidden" name="billinglastname" value="Doe">
<input type="hidden" name="billingpremise" value="No 789">
<input type="hidden" name="billingstreet" value="Test Street">
<input type="hidden" name="billingtown" value="Bangor">
<input type="hidden" name="billingcounty" value="Gwynedd">
<input type="hidden" name="billingpostcode" value="TR45 6ST">
<input type="hidden" name="billingcountryiso2a " value="GB">
<!-- End of sender information -->
<!-- Recipient information -->
<input type="hidden" name="customerfirstname" value="John">
<input type="hidden" name="customerlastname" value="Smith">
<input type="hidden" name="customercountryiso2a" value="GB">
<input type="hidden" name="customeraccountnumber" value="12345678">
<input type="hidden" name="customeraccountnumbertype" value="ACCOUNT">
<!-- End of recipient information -->
<!-- Amount and currency information -->
<input type="hidden" name="currencyiso3a" value="GBP">
<input type="hidden" name="mainamount" value="100.00">
<!-- End of Amount and currency information -->
<!-- HTML submit Pay button information -->
<input type="submit" value="Pay">
<!-- End of HTML submit Pay button information -->
</form>
</body>
</html>
Vervang <DOMAIN>
met een ondersteund domein. Klik hier voor een volledige lijst.
Het volgende payload voorbeeld bevat de velden die vereist zijn voor handelaren met MCC 4829:
{
"payload":{
"accountfunding":"1",
"accounttypedescription":"ECOM",
"baseamount":"1050",
"billingcountryiso2a":"GB",
"billingcounty":"Gwynedd",
"billingdob":"2001-01-01",
"billingfirstname":"Jay",
"billinglastname":"Doe",
"billingpremise":"No 789",
"billingstreet":"Test Street",
"billingtown":"Bangor",
"currencyiso3a":"GBP",
"customeraccountnumber":"123456789",
"customeraccountnumbertype":"ACCOUNT",
"customercountryiso2a":"GB",
"customerfirstname":"John",
"customerlastname":"Smith",
"requesttypedescriptions":["THREEDQUERY","AUTH"],
"sitereference":"{{site_reference}}",
"transactiontypeindicator":"F07"
},
"iat":1559033849,
"iss":"{{jwt_username}}"
}
Het volgende payload voorbeeld bevat de velden die vereist zijn voor handelaren met MCC 4829:
{
"payload":{
"accountfunding":"1",
"accounttypedescription":"ECOM",
"billingdob":"2001-01-01",
"billingfirstname":"Jay",
"billinglastname":"Doe",
"billingpremise":"No 789",
"billingstreet":"Test Street",
"billingtown":"Bangor",
"billingcounty":"Gwynedd",
"billingcountryiso2a":"GB",
"baseamount":"1050",
"currencyiso3a":"GBP",
"customeraccountnumber":"123456789",
"customeraccountnumbertype":"ACCOUNT",
"customercountryiso2a":"GB",
"customerfirstname":"John",
"customerlastname":"Smith",
"requesttypedescriptions":["THREEDQUERY","AUTH"],
"sitereference":"{{site_reference}}",
"termurl":"https://payments.securetrading.net/process/payments/mobilesdklistener",
"transactiontypeindicator":"F07"
},
"iat":1559033849,
"iss":"{{jwt_username}}"
}
Het volgende AUTH aanvraagvoorbeeld bevat de velden die verplicht worden gesteld door Visa en Mastercard voor verkopers met categoriecode 4829:
#!/usr/bin/python
import securetrading
stconfig = securetrading.Config()
stconfig.username = "{{wsapi_username}}"
stconfig.password = "{{wsapi_password}}"
st = securetrading.Api(stconfig)
auth = {
"accountfunding": "1",
"accounttypedescription": "MOTO",
"baseamount": "1050",
"billingcountryiso2a": "GB",
"billingcounty": "Gwynedd",
"billingdob":"2001-01-01",
"billingfirstname": "Jay",
"billinglastname": "Doe",
"billingpremise": "No 789",
"billingstreet": "Test Street",
"billingtown": "Bangor",
"currencyiso3a": "GBP",
"customeraccountnumber": "123456789",
"customeraccountnumbertype": "ACCOUNT",
"customercountryiso2a": "GB",
"customerfirstname": "John",
"customerlastname": "Smith",
"expirydate": "01/35",
"pan": "4111111111111111",
"securitycode": "123",
"requesttypedescriptions": ["AUTH"],
"sitereference": "{{site_reference}}",
"transactiontypeindicator": "F07"
}
strequest = securetrading.Request()
strequest.update(auth)
stresponse = st.process(strequest) #stresponse contains the transaction response
<?php
if (!($autoload = realpath(__DIR__ . '/../../../autoload.php')) && !($autoload = realpath(__DIR__ . '/../vendor/autoload.php'))) {
throw new Exception('Composer autoloader file could not be found.');
}
require_once($autoload);
$configData = array(
'username' => '{{wsapi_username}}',
'password' => '{{wsapi_password}}',
);
$requestData = array(
'accountfunding' => '1',
'accounttypedescription' => 'MOTO',
'baseamount' => '1050',
'billingcountryiso2a' => 'GB',
'billingcounty' => 'Gwynedd',
'billingdob' => '2001-01-01',
'billingfirstname' => 'Jay',
'billinglastname' => 'Doe',
'billingpremise' => 'No 789',
'billingstreet' => 'Test Street',
'billingtown' => 'Bangor',
'currencyiso3a' => 'GBP',
'customeraccountnumber' => '123456789',
'customeraccountnumbertype' => 'ACCOUNT',
'customercountryiso2a' => 'GB',
'customerfirstname' => 'John',
'customerlastname' => 'Smith',
'expirydate' => '01/35',
'pan' => '4111111111111111',
'securitycode' => '123',
'requesttypedescriptions' => array('AUTH'),
'sitereference' => '{{site_reference}}',
'transactiontypeindicator' => 'F07'
);
$api = \Securetrading\api($configData);
$response = $api->process($requestData);
var_dump($response->toArray());
?>
curl --user {{wsapi_username}}:{{wsapi_password}} <DOMAIN>/json/ -H "Content-type: application/json" -H "Accept: application/json" -X POST -d '{
"alias":"{{wsapi_username}}",
"version": "1.00",
"request": [{
"accountfunding":"1",
"accounttypedescription":"MOTO",
"baseamount":"1050",
"billingcountryiso2a":"GB",
"billingcounty":"Gwynedd",
"billingdob":"2001-01-01",
"billingfirstname":"Jay",
"billinglastname":"Doe",
"billingpremise":"No 789",
"billingstreet":"Test Street",
"billingtown":"Bangor",
"currencyiso3a":"GBP",
"customeraccountnumber":"123456789",
"customeraccountnumbertype":"ACCOUNT",
"customercountryiso2a":"GB",
"customerfirstname":"John",
"customerlastname":"Smith",
"expirydate":"01/35",
"pan":"4111111111111111",
"securitycode":"123",
"requesttypedescriptions":["AUTH"],
"sitereference":"{{site_reference}}",
"transactiontypeindicator":"F07"
}]
}'
{
"alias":"{{wsapi_username}}",
"version":"1.00",
"request":[{
"accountfunding":"1",
"accounttypedescription":"MOTO",
"baseamount":"1050",
"billingcountryiso2a":"GB",
"billingcounty":"Gwynedd",
"billingdob":"2001-01-01",
"billingfirstname":"Jay",
"billinglastname":"Doe",
"billingpremise":"No 789",
"billingstreet":"Test Street",
"billingtown":"Bangor",
"currencyiso3a":"GBP",
"customeraccountnumber":"123456789",
"customeraccountnumbertype":"ACCOUNT",
"customercountryiso2a":"GB",
"customerfirstname":"John",
"customerlastname":"Smith",
"expirydate":"01/35",
"pan":"4111111111111111",
"securitycode":"123",
"requesttypedescriptions":["AUTH"],
"sitereference":"{{site_reference}}",
"transactiontypeindicator":"F07"
}]
}
<requestblock version="3.67">
<alias>{{wsapi_username}}</alias>
<request type="AUTH">
<billing>
<amount currencycode="GBP">1050</amount>
<country>GB</country>
<county>Gwynedd</county>
<dob>2001-01-01</dob>
<name>
<first>Jay</first>
<last>Doe</last>
</name>
<payment>
<pan>4111111111111111</pan>
<expirydate>01/35</expirydate>
<securitycode>123</securitycode>
</payment>
<premise>No 789</premise>
<street>Test Street</street>
<town>Bangor</town>
</billing>
<customer>
<accountnumber type="ACCOUNT">12345678</accountnumber>
<country>GB</country>
<name>
<first>John</first>
<last>Smith</last>
</name>
</customer>
<merchant>
<accountfunding>1</accountfunding>
<transactiontypeindicator>F07</transactiontypeindicator>
</merchant>
<operation>
<accounttypedescription>MOTO</accounttypedescription>
<sitereference>{{site_reference}}</sitereference>
</operation>
</request>
</requestblock>
Vervang <DOMAIN>
met een ondersteund domein. Klik hier voor een volledige lijst.
MCC 6540
Deze MCC moet gebruikt worden door Handelaars wier hoofdactiviteit bestaat uit de verkoop van en/of het herladen van opgeslagen waarde kaarten/rekeningen (inclusief Visa Prepaid Kaarten) bij niet-financiële instellingen. Voor deze MCC mandateren Visa en Mastercard dat deze transacties dienovereenkomstig gemarkeerd worden en dat bijkomende informatie over afzender en ontvanger in de aanvraag wordt opgenomen.
Het volgende is een voorbeeld van een POST naar Payment Pages met de velden die vereist zijn voor verkopers met MCC 6540:
<html>
<body>
<!-- HTML form POST instruction and endpoint information -->
<form method="POST" action="https://payments.securetrading.net/process/payments/details">
<!-- End of HTML form POST instruction and endpoint information -->
<!-- sitereference; stprofile; and version information -->
<input type="hidden" name="sitereference" value="{{site_reference}}">
<input type="hidden" name="stprofile" value="default">
<input type="hidden" name="version" value="2">
<!-- End of sitereference; stprofile; and version information -->
<!-- Account funding flagging -->
<input type="hidden" name="accountfunding" value="1">
<input type="hidden" name="transactiontypeindicator" value="F61">
<!-- End of Account funding flagging -->
<!-- Sender information -->
<input type="hidden" name="billingdob" value="2001-01-01">
<input type="hidden" name="billingfirstname" value="Jay">
<input type="hidden" name="billinglastname" value="Doe">
<input type="hidden" name="billingpremise" value="No 789">
<input type="hidden" name="billingstreet" value="Test Street">
<input type="hidden" name="billingtown" value="Bangor">
<input type="hidden" name="billingcounty" value="Gwynedd">
<input type="hidden" name="billingpostcode" value="TR45 6ST">
<input type="hidden" name="billingcountryiso2a " value="GB">
<!-- End of sender information -->
<!-- Recipient information -->
<input type="hidden" name="customerfirstname" value="John">
<input type="hidden" name="customerlastname" value="Smith">
<input type="hidden" name="customercountryiso2a" value="GB">
<input type="hidden" name="customeraccountnumber" value="12345678">
<input type="hidden" name="customeraccountnumbertype" value="ACCOUNT">
<!-- End of recipient information -->
<!-- Amount and currency information -->
<input type="hidden" name="currencyiso3a" value="GBP">
<input type="hidden" name="mainamount" value="100.00">
<!-- End of Amount and currency information -->
<!-- HTML submit Pay button information -->
<input type="submit" value="Pay">
<!-- End of HTML submit Pay button information -->
</form>
</body>
</html>
Vervang <DOMAIN>
met een ondersteund domein. Klik hier voor een volledige lijst.
Het volgende payload voorbeeld bevat de velden die vereist zijn voor handelaren met MCC 6540:
{
"payload":{
"accountfunding":"1",
"accounttypedescription":"ECOM",
"baseamount":"1050",
"billingcountryiso2a":"GB",
"billingcounty":"Gwynedd",
"billingdob":"2001-01-01",
"billingfirstname":"Jay",
"billinglastname":"Doe",
"billingpremise":"No 789",
"billingstreet":"Test Street",
"billingtown":"Bangor",
"currencyiso3a":"GBP",
"customeraccountnumber":"123456789",
"customeraccountnumbertype":"ACCOUNT",
"customercountryiso2a":"GB",
"customerfirstname":"John",
"customerlastname":"Smith",
"requesttypedescriptions":["THREEDQUERY","AUTH"],
"sitereference":"{{site_reference}}",
"transactiontypeindicator":"F61"
},
"iat":1559033849,
"iss":"{{jwt_username}}"
}
Het volgende payload voorbeeld bevat de velden die vereist zijn voor handelaren met MCC 6540:
{
"payload":{
"accountfunding":"1",
"accounttypedescription":"ECOM",
"billingdob":"2001-01-01",
"billingfirstname":"Jay",
"billinglastname":"Doe",
"billingpremise":"No 789",
"billingstreet":"Test Street",
"billingtown":"Bangor",
"billingcounty":"Gwynedd",
"billingcountryiso2a":"GB",
"baseamount":"1050",
"currencyiso3a":"GBP",
"customeraccountnumber":"123456789",
"customeraccountnumbertype":"ACCOUNT",
"customercountryiso2a":"GB",
"customerfirstname":"John",
"customerlastname":"Smith",
"requesttypedescriptions":["THREEDQUERY","AUTH"],
"sitereference":"{{site_reference}}",
"termurl":"https://payments.securetrading.net/process/payments/mobilesdklistener",
"transactiontypeindicator":"F61"
},
"iat":1559033849,
"iss":"{{jwt_username}}"
}
Het volgende aanvraagvoorbeeld AUTH bevat de velden die verplicht zijn gesteld door Visa en Mastercard voor verkopers met categoriecode 6540:
#!/usr/bin/python
import securetrading
stconfig = securetrading.Config()
stconfig.username = "{{wsapi_username}}"
stconfig.password = "{{wsapi_password}}"
st = securetrading.Api(stconfig)
auth = {
"accountfunding": "1",
"accounttypedescription": "MOTO",
"baseamount": "1050",
"billingcountryiso2a": "GB",
"billingcounty": "Gwynedd",
"billingdob":"2001-01-01",
"billingfirstname": "Jay",
"billinglastname": "Doe",
"billingpremise": "No 789",
"billingstreet": "Test Street",
"billingtown": "Bangor",
"currencyiso3a": "GBP",
"customeraccountnumber": "123456789",
"customeraccountnumbertype": "ACCOUNT",
"customercountryiso2a": "GB",
"customerfirstname": "John",
"customerlastname": "Smith",
"expirydate": "01/35",
"pan": "4111111111111111",
"securitycode": "123",
"requesttypedescriptions": ["AUTH"],
"sitereference": "{{site_reference}}",
"transactiontypeindicator": "F61"
}
strequest = securetrading.Request()
strequest.update(auth)
stresponse = st.process(strequest) #stresponse contains the transaction response
<?php
if (!($autoload = realpath(__DIR__ . '/../../../autoload.php')) && !($autoload = realpath(__DIR__ . '/../vendor/autoload.php'))) {
throw new Exception('Composer autoloader file could not be found.');
}
require_once($autoload);
$configData = array(
'username' => '{{wsapi_username}}',
'password' => '{{wsapi_password}}',
);
$requestData = array(
'accountfunding' => '1',
'accounttypedescription' => 'MOTO',
'baseamount' => '1050',
'billingcountryiso2a' => 'GB',
'billingcounty' => 'Gwynedd',
'billingdob' => '2001-01-01',
'billingfirstname' => 'Jay',
'billinglastname' => 'Doe',
'billingpremise' => 'No 789',
'billingstreet' => 'Test Street',
'billingtown' => 'Bangor',
'currencyiso3a' => 'GBP',
'customeraccountnumber' => '123456789',
'customeraccountnumbertype' => 'ACCOUNT',
'customercountryiso2a' => 'GB',
'customerfirstname' => 'John',
'customerlastname' => 'Smith',
'expirydate' => '01/35',
'pan' => '4111111111111111',
'securitycode' => '123',
'requesttypedescriptions' => array('AUTH'),
'sitereference' => '{{site_reference}}',
'transactiontypeindicator' => 'F61'
);
$api = \Securetrading\api($configData);
$response = $api->process($requestData);
var_dump($response->toArray());
?>
curl --user {{wsapi_username}}:{{wsapi_password}} <DOMAIN>/json/ -H "Content-type: application/json" -H "Accept: application/json" -X POST -d '{
"alias":"{{wsapi_username}}",
"version": "1.00",
"request": [{
"accountfunding":"1",
"accounttypedescription":"MOTO",
"baseamount":"1050",
"billingcountryiso2a":"GB",
"billingcounty":"Gwynedd",
"billingdob":"2001-01-01",
"billingfirstname":"Jay",
"billinglastname":"Doe",
"billingpremise":"No 789",
"billingstreet":"Test Street",
"billingtown":"Bangor",
"currencyiso3a":"GBP",
"customeraccountnumber":"123456789",
"customeraccountnumbertype":"ACCOUNT",
"customercountryiso2a":"GB",
"customerfirstname":"John",
"customerlastname":"Smith",
"expirydate":"01/35",
"pan":"4111111111111111",
"securitycode":"123",
"requesttypedescriptions":["AUTH"],
"sitereference":"{{site_reference}}",
"transactiontypeindicator":"F61"
}]
}'
{
"alias":"{{wsapi_username}}",
"version":"1.00",
"request":[{
"accountfunding":"1",
"accounttypedescription":"MOTO",
"baseamount":"1050",
"billingcountryiso2a":"GB",
"billingcounty":"Gwynedd",
"billingdob":"2001-01-01",
"billingfirstname":"Jay",
"billinglastname":"Doe",
"billingpremise":"No 789",
"billingstreet":"Test Street",
"billingtown":"Bangor",
"currencyiso3a":"GBP",
"customeraccountnumber":"123456789",
"customeraccountnumbertype":"ACCOUNT",
"customercountryiso2a":"GB",
"customerfirstname":"John",
"customerlastname":"Smith",
"expirydate":"01/35",
"pan":"4111111111111111",
"securitycode":"123",
"requesttypedescriptions":["AUTH"],
"sitereference":"{{site_reference}}",
"transactiontypeindicator":"F61"
}]
}
<requestblock version="3.67">
<alias>{{wsapi_username}}</alias>
<request type="AUTH">
<billing>
<amount currencycode="GBP">1050</amount>
<country>GB</country>
<county>Gwynedd</county>
<dob>2001-01-01</dob>
<name>
<first>Jay</first>
<last>Doe</last>
</name>
<payment>
<pan>4111111111111111</pan>
<expirydate>01/35</expirydate>
<securitycode>123</securitycode>
</payment>
<premise>No 789</premise>
<street>Test Street</street>
<town>Bangor</town>
</billing>
<customer>
<accountnumber type="ACCOUNT">12345678</accountnumber>
<country>GB</country>
<name>
<first>John</first>
<last>Smith</last>
</name>
</customer>
<merchant>
<accountfunding>1</accountfunding>
<transactiontypeindicator>F61</transactiontypeindicator>
</merchant>
<operation>
<accounttypedescription>MOTO</accounttypedescription>
<sitereference>{{site_reference}}</sitereference>
</operation>
</request>
</requestblock>
Vervang <DOMAIN>
met een ondersteund domein. Klik hier voor een volledige lijst.
MCC 6211
Handelaren die geclassificeerd zijn met deze MCC hebben in alle jurisdicties waarin ze verkopen een vergunning om effecten, aandelen, obligaties, grondstoffen en beleggingsfondsen te kopen, verkopen en bemiddelen. Voor deze MCC, Visa verplichten dat deze transacties dienovereenkomstig worden gemarkeerd en dat aanvullende informatie over de afzender en ontvanger in het verzoek wordt opgenomen. Mastercard Het is de bedoeling dat de MCC vanaf augustus 2025 dezelfde vereisten oplegt.
Het volgende is een voorbeeld van een POST naar Payment Pages die de vereiste velden bevat voor handelaren met MCC 6211:
<html>
<body>
<!-- HTML form POST instruction and endpoint information -->
<form method="POST" action="https://payments.securetrading.net/process/payments/details">
<!-- End of HTML form POST instruction and endpoint information -->
<!-- sitereference; stprofile; and version information -->
<input type="hidden" name="sitereference" value="{{site_reference}}">
<input type="hidden" name="stprofile" value="default">
<input type="hidden" name="version" value="2">
<!-- End of sitereference; stprofile; and version information -->
<!-- Account funding flagging -->
<input type="hidden" name="accountfunding" value="1">
<input type="hidden" name="transactiontypeindicator" value="F52">
<!-- End of Account funding flagging -->
<!-- Sender information -->
<input type="hidden" name="billingdob" value="2001-01-01">
<input type="hidden" name="billingfirstname" value="Jay">
<input type="hidden" name="billinglastname" value="Doe">
<input type="hidden" name="billingpremise" value="No 789">
<input type="hidden" name="billingstreet" value="Test Street">
<input type="hidden" name="billingtown" value="Bangor">
<input type="hidden" name="billingcounty" value="Gwynedd">
<input type="hidden" name="billingpostcode" value="TR45 6ST">
<input type="hidden" name="billingcountryiso2a " value="GB">
<!-- End of sender information -->
<!-- Recipient information -->
<input type="hidden" name="customerfirstname" value="John">
<input type="hidden" name="customerlastname" value="Smith">
<input type="hidden" name="customercountryiso2a" value="GB">
<input type="hidden" name="customeraccountnumber" value="12345678">
<input type="hidden" name="customeraccountnumbertype" value="ACCOUNT">
<!-- End of recipient information -->
<!-- Amount and currency information -->
<input type="hidden" name="currencyiso3a" value="GBP">
<input type="hidden" name="mainamount" value="100.00">
<!-- End of Amount and currency information -->
<!-- HTML submit Pay button information -->
<input type="submit" value="Pay">
<!-- End of HTML submit Pay button information -->
</form>
</body>
</html>
Vervang <DOMAIN>
met een ondersteund domein. Klik hier voor een volledige lijst.
Het volgende payload voorbeeld bevat de velden die vereist zijn voor handelaren met MCC 6211:
{
"payload":{
"accountfunding":"1",
"accounttypedescription":"ECOM",
"baseamount":"1050",
"billingcountryiso2a":"GB",
"billingcounty":"Gwynedd",
"billingdob":"2001-01-01",
"billingfirstname":"Jay",
"billinglastname":"Doe",
"billingpremise":"No 789",
"billingstreet":"Test Street",
"billingtown":"Bangor",
"currencyiso3a":"GBP",
"customeraccountnumber":"123456789",
"customeraccountnumbertype":"ACCOUNT",
"customercountryiso2a":"GB",
"customerfirstname":"John",
"customerlastname":"Smith",
"requesttypedescriptions":["THREEDQUERY","AUTH"],
"sitereference":"{{site_reference}}",
"transactiontypeindicator":"F52"
},
"iat":1559033849,
"iss":"{{jwt_username}}"
}
Het volgende payload voorbeeld bevat de velden die vereist zijn voor handelaren met MCC 6211:
{
"payload":{
"accountfunding":"1",
"accounttypedescription":"ECOM",
"billingdob":"2001-01-01",
"billingfirstname":"Jay",
"billinglastname":"Doe",
"billingpremise":"No 789",
"billingstreet":"Test Street",
"billingtown":"Bangor",
"billingcounty":"Gwynedd",
"billingcountryiso2a":"GB",
"baseamount":"1050",
"currencyiso3a":"GBP",
"customeraccountnumber":"123456789",
"customeraccountnumbertype":"ACCOUNT",
"customercountryiso2a":"GB",
"customerfirstname":"John",
"customerlastname":"Smith",
"requesttypedescriptions":["THREEDQUERY","AUTH"],
"sitereference":"{{site_reference}}",
"termurl":"https://payments.securetrading.net/process/payments/mobilesdklistener",
"transactiontypeindicator":"F52"
},
"iat":1559033849,
"iss":"{{jwt_username}}"
}
Het volgende aanvraagvoorbeeld AUTH bevat de velden die verplicht zijn via Visa en Mastercard voor verkopers met categoriecode 6211:
#!/usr/bin/python
import securetrading
stconfig = securetrading.Config()
stconfig.username = "{{wsapi_username}}"
stconfig.password = "{{wsapi_password}}"
st = securetrading.Api(stconfig)
auth = {
"accountfunding": "1",
"accounttypedescription": "MOTO",
"baseamount": "1050",
"billingcountryiso2a": "GB",
"billingcounty": "Gwynedd",
"billingdob":"2001-01-01",
"billingfirstname": "Jay",
"billinglastname": "Doe",
"billingpremise": "No 789",
"billingstreet": "Test Street",
"billingtown": "Bangor",
"currencyiso3a": "GBP",
"customeraccountnumber": "123456789",
"customeraccountnumbertype": "ACCOUNT",
"customercountryiso2a": "GB",
"customerfirstname": "John",
"customerlastname": "Smith",
"expirydate": "01/35",
"pan": "4111111111111111",
"securitycode": "123",
"requesttypedescriptions": ["AUTH"],
"sitereference": "{{site_reference}}",
"transactiontypeindicator": "F52"
}
strequest = securetrading.Request()
strequest.update(auth)
stresponse = st.process(strequest) #stresponse contains the transaction response
<?php
if (!($autoload = realpath(__DIR__ . '/../../../autoload.php')) && !($autoload = realpath(__DIR__ . '/../vendor/autoload.php'))) {
throw new Exception('Composer autoloader file could not be found.');
}
require_once($autoload);
$configData = array(
'username' => '{{wsapi_username}}',
'password' => '{{wsapi_password}}',
);
$requestData = array(
'accountfunding' => '1',
'accounttypedescription' => 'MOTO',
'baseamount' => '1050',
'billingcountryiso2a' => 'GB',
'billingcounty' => 'Gwynedd',
'billingdob' => '2001-01-01',
'billingfirstname' => 'Jay',
'billinglastname' => 'Doe',
'billingpremise' => 'No 789',
'billingstreet' => 'Test Street',
'billingtown' => 'Bangor',
'currencyiso3a' => 'GBP',
'customeraccountnumber' => '123456789',
'customeraccountnumbertype' => 'ACCOUNT',
'customercountryiso2a' => 'GB',
'customerfirstname' => 'John',
'customerlastname' => 'Smith',
'expirydate' => '01/35',
'pan' => '4111111111111111',
'securitycode' => '123',
'requesttypedescriptions' => array('AUTH'),
'sitereference' => '{{site_reference}}',
'transactiontypeindicator' => 'F52'
);
$api = \Securetrading\api($configData);
$response = $api->process($requestData);
var_dump($response->toArray());
?>
curl --user {{wsapi_username}}:{{wsapi_password}} <DOMAIN>/json/ -H "Content-type: application/json" -H "Accept: application/json" -X POST -d '{
"alias":"{{wsapi_username}}",
"version": "1.00",
"request": [{
"accountfunding":"1",
"accounttypedescription":"MOTO",
"baseamount":"1050",
"billingcountryiso2a":"GB",
"billingcounty":"Gwynedd",
"billingdob":"2001-01-01",
"billingfirstname":"Jay",
"billinglastname":"Doe",
"billingpremise":"No 789",
"billingstreet":"Test Street",
"billingtown":"Bangor",
"currencyiso3a":"GBP",
"customeraccountnumber":"123456789",
"customeraccountnumbertype":"ACCOUNT",
"customercountryiso2a":"GB",
"customerfirstname":"John",
"customerlastname":"Smith",
"expirydate":"01/35",
"pan":"4111111111111111",
"securitycode":"123",
"requesttypedescriptions":["AUTH"],
"sitereference":"{{site_reference}}",
"transactiontypeindicator": "F52"
}]
}'
{
"alias":"{{wsapi_username}}",
"version":"1.00",
"request":[{
"accountfunding":"1",
"accounttypedescription":"MOTO",
"baseamount":"1050",
"billingcountryiso2a":"GB",
"billingcounty":"Gwynedd",
"billingdob":"2001-01-01",
"billingfirstname":"Jay",
"billinglastname":"Doe",
"billingpremise":"No 789",
"billingstreet":"Test Street",
"billingtown":"Bangor",
"currencyiso3a":"GBP",
"customeraccountnumber":"123456789",
"customeraccountnumbertype":"ACCOUNT",
"customercountryiso2a":"GB",
"customerfirstname":"John",
"customerlastname":"Smith",
"expirydate":"01/35",
"pan":"4111111111111111",
"securitycode":"123",
"requesttypedescriptions":["AUTH"],
"sitereference":"{{site_reference}}",
"transactiontypeindicator": "F52"
}]
}
<requestblock version="3.67">
<alias>{{wsapi_username}}</alias>
<request type="AUTH">
<billing>
<amount currencycode="GBP">1050</amount>
<country>GB</country>
<county>Gwynedd</county>
<dob>2001-01-01</dob>
<name>
<first>Jay</first>
<last>Doe</last>
</name>
<payment>
<pan>4111111111111111</pan>
<expirydate>01/35</expirydate>
<securitycode>123</securitycode>
</payment>
<premise>No 789</premise>
<street>Test Street</street>
<town>Bangor</town>
</billing>
<customer>
<accountnumber type="ACCOUNT">12345678</accountnumber>
<country>GB</country>
<name>
<first>John</first>
<last>Smith</last>
</name>
</customer>
<merchant>
<accountfunding>1</accountfunding>
<transactiontypeindicator>F52</transactiontypeindicator>
</merchant>
<operation>
<accounttypedescription>MOTO</accounttypedescription>
<sitereference>{{site_reference}}</sitereference>
</operation>
</request>
</requestblock>
Vervang <DOMAIN>
met een ondersteund domein. Klik hier voor een volledige lijst.
MCC 6051
Deze MCC wordt gebruikt voor de financiering van een rekening (met uitzondering van prepaid kaartladingen), de aankoop van buitenlandse Munt, liquide en cryptocurrency activa (bijvoorbeeld: cryptocurrency), postwissels of reischeques bij niet-financiële instellingen zoals Munt beurzen of postwisselhandelaren (een verhandelbare overboeking op papier - geen geldoverdracht).
Deze MCC moet ook worden gebruikt voor de terugbetaling van een lening of schuld als de entiteit die de schuld aanhoudt geen financiële instelling is.
Een merchant die liquide en cryptocurrency activa zoals cryptocurrency verkoopt, moet alle vereiste gegevens opnemen in het autorisatie verzoek en clearingrecord. Alle andere transacties op dezelfde winkelierslocatie moeten het juiste MCC voor die transacties gebruiken.
Voor deze MCC, Visa verplichten dat deze transacties dienovereenkomstig worden gemarkeerd en dat aanvullende informatie over afzender en ontvanger in het verzoek wordt opgenomen. Mastercard Het is de bedoeling dat de MCC vanaf augustus 2025 dezelfde vereisten oplegt.
Het volgende is een voorbeeld van een POST naar Payment Pages met de velden die vereist zijn voor verkopers met MCC 6051:
<html>
<body>
<!-- HTML form POST instruction and endpoint information -->
<form method="POST" action="https://payments.securetrading.net/process/payments/details">
<!-- End of HTML form POST instruction and endpoint information -->
<!-- sitereference; stprofile; and version information -->
<input type="hidden" name="sitereference" value="{{site_reference}}">
<input type="hidden" name="stprofile" value="default">
<input type="hidden" name="version" value="2">
<!-- End of sitereference; stprofile; and version information -->
<!-- Account funding flagging -->
<input type="hidden" name="accountfunding" value="1">
<input type="hidden" name="transactiontypeindicator" value="F52">
<!-- End of Account funding flagging -->
<!-- Sender information -->
<input type="hidden" name="billingdob" value="2001-01-01">
<input type="hidden" name="billingfirstname" value="Jay">
<input type="hidden" name="billinglastname" value="Doe">
<input type="hidden" name="billingpremise" value="No 789">
<input type="hidden" name="billingstreet" value="Test Street">
<input type="hidden" name="billingtown" value="Bangor">
<input type="hidden" name="billingcounty" value="Gwynedd">
<input type="hidden" name="billingpostcode" value="TR45 6ST">
<input type="hidden" name="billingcountryiso2a " value="GB">
<!-- End of sender information -->
<!-- Recipient information -->
<input type="hidden" name="customerfirstname" value="John">
<input type="hidden" name="customerlastname" value="Smith">
<input type="hidden" name="customercountryiso2a" value="GB">
<input type="hidden" name="customeraccountnumber" value="12345678">
<input type="hidden" name="customeraccountnumbertype" value="ACCOUNT">
<!-- End of recipient information -->
<!-- Amount and currency information -->
<input type="hidden" name="currencyiso3a" value="GBP">
<input type="hidden" name="mainamount" value="100.00">
<!-- End of Amount and currency information -->
<!-- HTML submit Pay button information -->
<input type="submit" value="Pay">
<!-- End of HTML submit Pay button information -->
</form>
</body>
</html>
Vervang <DOMAIN>
met een ondersteund domein. Klik hier voor een volledige lijst.
Het volgende payload voorbeeld bevat de velden die vereist zijn voor handelaren met MCC 6051:
{
"payload":{
"accountfunding":"1",
"accounttypedescription":"ECOM",
"baseamount":"1050",
"billingcountryiso2a":"GB",
"billingcounty":"Gwynedd",
"billingdob":"2001-01-01",
"billingfirstname":"Jay",
"billinglastname":"Doe",
"billingpremise":"No 789",
"billingstreet":"Test Street",
"billingtown":"Bangor",
"currencyiso3a":"GBP",
"customeraccountnumber":"123456789",
"customeraccountnumbertype":"ACCOUNT",
"customercountryiso2a":"GB",
"customerfirstname":"John",
"customerlastname":"Smith",
"requesttypedescriptions":["THREEDQUERY","AUTH"],
"sitereference":"{{site_reference}}",
"transactiontypeindicator":"F52"
},
"iat":1559033849,
"iss":"{{jwt_username}}"
}
Het volgende payload voorbeeld bevat de velden die vereist zijn voor handelaren met MCC 6051:
{
"payload":{
"accountfunding":"1",
"accounttypedescription":"ECOM",
"billingdob":"2001-01-01",
"billingfirstname":"Jay",
"billinglastname":"Doe",
"billingpremise":"No 789",
"billingstreet":"Test Street",
"billingtown":"Bangor",
"billingcounty":"Gwynedd",
"billingcountryiso2a":"GB",
"baseamount":"1050",
"currencyiso3a":"GBP",
"customeraccountnumber":"123456789",
"customeraccountnumbertype":"ACCOUNT",
"customercountryiso2a":"GB",
"customerfirstname":"John",
"customerlastname":"Smith",
"requesttypedescriptions":["THREEDQUERY","AUTH"],
"sitereference":"{{site_reference}}",
"termurl":"https://payments.securetrading.net/process/payments/mobilesdklistener",
"transactiontypeindicator":"F52"
},
"iat":1559033849,
"iss":"{{jwt_username}}"
}
Het volgende aanvraagvoorbeeld AUTH bevat de velden die verplicht zijn via Visa en Mastercard voor verkopers met categoriecode 6051:
#!/usr/bin/python
import securetrading
stconfig = securetrading.Config()
stconfig.username = "{{wsapi_username}}"
stconfig.password = "{{wsapi_password}}"
st = securetrading.Api(stconfig)
auth = {
"accountfunding": "1",
"accounttypedescription": "MOTO",
"baseamount": "1050",
"billingcountryiso2a": "GB",
"billingcounty": "Gwynedd",
"billingdob":"2001-01-01",
"billingfirstname": "Jay",
"billinglastname": "Doe",
"billingpremise": "No 789",
"billingstreet": "Test Street",
"billingtown": "Bangor",
"currencyiso3a": "GBP",
"customeraccountnumber": "123456789",
"customeraccountnumbertype": "ACCOUNT",
"customercountryiso2a": "GB",
"customerfirstname": "John",
"customerlastname": "Smith",
"expirydate": "01/35",
"pan": "4111111111111111",
"securitycode": "123",
"requesttypedescriptions": ["AUTH"],
"sitereference": "{{site_reference}}",
"transactiontypeindicator": "F52"
}
strequest = securetrading.Request()
strequest.update(auth)
stresponse = st.process(strequest) #stresponse contains the transaction response
<?php
if (!($autoload = realpath(__DIR__ . '/../../../autoload.php')) && !($autoload = realpath(__DIR__ . '/../vendor/autoload.php'))) {
throw new Exception('Composer autoloader file could not be found.');
}
require_once($autoload);
$configData = array(
'username' => '{{wsapi_username}}',
'password' => '{{wsapi_password}}',
);
$requestData = array(
'accountfunding' => '1',
'accounttypedescription' => 'MOTO',
'baseamount' => '1050',
'billingcountryiso2a' => 'GB',
'billingcounty' => 'Gwynedd',
'billingdob' => '2001-01-01',
'billingfirstname' => 'Jay',
'billinglastname' => 'Doe',
'billingpremise' => 'No 789',
'billingstreet' => 'Test Street',
'billingtown' => 'Bangor',
'currencyiso3a' => 'GBP',
'customeraccountnumber' => '123456789',
'customeraccountnumbertype' => 'ACCOUNT',
'customercountryiso2a' => 'GB',
'customerfirstname' => 'John',
'customerlastname' => 'Smith',
'expirydate' => '01/35',
'pan' => '4111111111111111',
'securitycode' => '123',
'requesttypedescriptions' => array('AUTH'),
'sitereference' => '{{site_reference}}',
'transactiontypeindicator' => 'F52'
);
$api = \Securetrading\api($configData);
$response = $api->process($requestData);
var_dump($response->toArray());
?>
curl --user {{wsapi_username}}:{{wsapi_password}} <DOMAIN>/json/ -H "Content-type: application/json" -H "Accept: application/json" -X POST -d '{
"alias":"{{wsapi_username}}",
"version": "1.00",
"request": [{
"accountfunding":"1",
"accounttypedescription":"MOTO",
"baseamount":"1050",
"billingcountryiso2a":"GB",
"billingcounty":"Gwynedd",
"billingdob":"2001-01-01",
"billingfirstname":"Jay",
"billinglastname":"Doe",
"billingpremise":"No 789",
"billingstreet":"Test Street",
"billingtown":"Bangor",
"currencyiso3a":"GBP",
"customeraccountnumber":"123456789",
"customeraccountnumbertype":"ACCOUNT",
"customercountryiso2a":"GB",
"customerfirstname":"John",
"customerlastname":"Smith",
"expirydate":"01/35",
"pan":"4111111111111111",
"securitycode":"123",
"requesttypedescriptions":["AUTH"],
"sitereference":"{{site_reference}}",
"transactiontypeindicator":"F52"
}]
}'
{
"alias":"{{wsapi_username}}",
"version":"1.00",
"request":[{
"accountfunding":"1",
"accounttypedescription":"MOTO",
"baseamount":"1050",
"billingcountryiso2a":"GB",
"billingcounty":"Gwynedd",
"billingdob":"2001-01-01",
"billingfirstname":"Jay",
"billinglastname":"Doe",
"billingpremise":"No 789",
"billingstreet":"Test Street",
"billingtown":"Bangor",
"currencyiso3a":"GBP",
"customeraccountnumber":"123456789",
"customeraccountnumbertype":"ACCOUNT",
"customercountryiso2a":"GB",
"customerfirstname":"John",
"customerlastname":"Smith",
"expirydate":"01/35",
"pan":"4111111111111111",
"securitycode":"123",
"requesttypedescriptions":["AUTH"],
"sitereference":"{{site_reference}}",
"transactiontypeindicator":"F52"
}]
}
<requestblock version="3.67">
<alias>{{wsapi_username}}</alias>
<request type="AUTH">
<billing>
<amount currencycode="GBP">1050</amount>
<country>GB</country>
<county>Gwynedd</county>
<dob>2001-01-01</dob>
<name>
<first>Jay</first>
<last>Doe</last>
</name>
<payment>
<pan>4111111111111111</pan>
<expirydate>01/35</expirydate>
<securitycode>123</securitycode>
</payment>
<premise>No 789</premise>
<street>Test Street</street>
<town>Bangor</town>
</billing>
<customer>
<accountnumber type="ACCOUNT">12345678</accountnumber>
<country>GB</country>
<name>
<first>John</first>
<last>Smith</last>
</name>
</customer>
<merchant>
<accountfunding>1</accountfunding>
<transactiontypeindicator>F52</transactiontypeindicator>
</merchant>
<operation>
<accounttypedescription>MOTO</accounttypedescription>
<sitereference>{{site_reference}}</sitereference>
</operation>
</request>
</requestblock>
Vervang <DOMAIN>
met een ondersteund domein. Klik hier voor een volledige lijst.
MCC 6012
Deze MCC wordt gebruikt door financiële instellingen voor de aankoop van goederen of diensten of de terugbetaling van leningen en schulden.
"Financiële instelling" omvat banken, spaarbanken, spaarkassen en kredietverenigingen. Bijvoorbeeld: de aankoop van cheques, andere financiële producten of promotieartikelen, deposito's, de financiering van een rekening, de aankoop of heroplading van een kaart met opgeslagen waarde, de aankoop van buitenlandse Munt, liquide middelen, postwissels (een verhandelbare overboeking op papier - geen geldoverdracht), reischeques en vergoedingen voor leningen of diensten voor financieel advies.
Deze MCC wordt ook gebruikt voor de terugbetaling van een schuld, lening of creditcardtegoed door een kaarthouder aan de financiële instelling.
Voor deze MCC, Visa mandateren dat deze transacties dienovereenkomstig worden gemarkeerd en dat aanvullende informatie over afzender en ontvanger in het verzoek wordt opgenomen. Mastercard mandateert niet het markeren van Rekeningfinancieringstransacties voor MCC 6012 niet verplicht.
Het volgende is een voorbeeld van een POST naar Payment Pages die de vereiste velden bevat voor verkopers met MCC 6012:
<html>
<body>
<!-- HTML form POST instruction and endpoint information -->
<form method="POST" action="https://payments.securetrading.net/process/payments/details">
<!-- End of HTML form POST instruction and endpoint information -->
<!-- sitereference; stprofile; and version information -->
<input type="hidden" name="sitereference" value="{{site_reference}}">
<input type="hidden" name="stprofile" value="default">
<input type="hidden" name="version" value="2">
<!-- End of sitereference; stprofile; and version information -->
<!-- Account funding flagging -->
<input type="hidden" name="accountfunding" value="1">
<!-- End of Account funding flagging -->
<!-- Sender information -->
<input type="hidden" name="billingdob" value="2001-01-01">
<input type="hidden" name="billingfirstname" value="Jay">
<input type="hidden" name="billinglastname" value="Doe">
<input type="hidden" name="billingpremise" value="No 789">
<input type="hidden" name="billingstreet" value="Test Street">
<input type="hidden" name="billingtown" value="Bangor">
<input type="hidden" name="billingcounty" value="Gwynedd">
<input type="hidden" name="billingpostcode" value="TR45 6ST">
<input type="hidden" name="billingcountryiso2a " value="GB">
<!-- End of sender information -->
<!-- Recipient information -->
<input type="hidden" name="customerfirstname" value="John">
<input type="hidden" name="customerlastname" value="Smith">
<input type="hidden" name="customercountryiso2a" value="GB">
<input type="hidden" name="customeraccountnumber" value="12345678">
<input type="hidden" name="customeraccountnumbertype" value="ACCOUNT">
<!-- End of recipient information -->
<!-- Amount and currency information -->
<input type="hidden" name="currencyiso3a" value="GBP">
<input type="hidden" name="mainamount" value="100.00">
<!-- End of Amount and currency information -->
<!-- HTML submit Pay button information -->
<input type="submit" value="Pay">
<!-- End of HTML submit Pay button information -->
</form>
</body>
</html>
Vervang <DOMAIN>
met een ondersteund domein. Klik hier voor een volledige lijst.
Het volgende payload voorbeeld bevat de velden die vereist zijn voor handelaren met MCC 6012:
{
"payload":{
"accountfunding":"1",
"accounttypedescription":"ECOM",
"baseamount":"1050",
"billingcountryiso2a":"GB",
"billingcounty":"Gwynedd",
"billingdob":"2001-01-01",
"billingfirstname":"Jay",
"billinglastname":"Doe",
"billingpremise":"No 789",
"billingstreet":"Test Street",
"billingtown":"Bangor",
"currencyiso3a":"GBP",
"customeraccountnumber":"123456789",
"customeraccountnumbertype":"ACCOUNT",
"customercountryiso2a":"GB",
"customerfirstname":"John",
"customerlastname":"Smith",
"requesttypedescriptions":["THREEDQUERY","AUTH"],
"sitereference":"{{site_reference}}"
},
"iat":1559033849,
"iss":"{{jwt_username}}"
}
Het volgende payload voorbeeld bevat de velden die vereist zijn voor handelaren met MCC 6012:
{
"payload":{
"accountfunding":"1",
"accounttypedescription":"ECOM",
"billingdob":"2001-01-01",
"billingfirstname":"Jay",
"billinglastname":"Doe",
"billingpremise":"No 789",
"billingstreet":"Test Street",
"billingtown":"Bangor",
"billingcounty":"Gwynedd",
"billingcountryiso2a":"GB",
"baseamount":"1050",
"currencyiso3a":"GBP",
"customeraccountnumber":"123456789",
"customeraccountnumbertype":"ACCOUNT",
"customercountryiso2a":"GB",
"customerfirstname":"John",
"customerlastname":"Smith",
"requesttypedescriptions":["THREEDQUERY","AUTH"],
"sitereference":"{{site_reference}}",
"termurl":"https://payments.securetrading.net/process/payments/mobilesdklistener"
},
"iat":1559033849,
"iss":"{{jwt_username}}"
}
Het volgende AUTH aanvraagvoorbeeld bevat de velden die verplicht zijn via Visa en Mastercard voor verkopers met categoriecode 6012:
#!/usr/bin/python
import securetrading
stconfig = securetrading.Config()
stconfig.username = "{{wsapi_username}}"
stconfig.password = "{{wsapi_password}}"
st = securetrading.Api(stconfig)
auth = {
"accountfunding": "1",
"accounttypedescription": "MOTO",
"baseamount": "1050",
"billingcountryiso2a": "GB",
"billingcounty": "Gwynedd",
"billingdob":"2001-01-01",
"billingfirstname": "Jay",
"billinglastname": "Doe",
"billingpremise": "No 789",
"billingstreet": "Test Street",
"billingtown": "Bangor",
"currencyiso3a": "GBP",
"customeraccountnumber": "123456789",
"customeraccountnumbertype": "ACCOUNT",
"customercountryiso2a": "GB",
"customerfirstname": "John",
"customerlastname": "Smith",
"expirydate": "01/35",
"pan": "4111111111111111",
"securitycode": "123",
"requesttypedescriptions": ["AUTH"],
"sitereference": "{{site_reference}}"
}
strequest = securetrading.Request()
strequest.update(auth)
stresponse = st.process(strequest) #stresponse contains the transaction response
<?php
if (!($autoload = realpath(__DIR__ . '/../../../autoload.php')) && !($autoload = realpath(__DIR__ . '/../vendor/autoload.php'))) {
throw new Exception('Composer autoloader file could not be found.');
}
require_once($autoload);
$configData = array(
'username' => '{{wsapi_username}}',
'password' => '{{wsapi_password}}',
);
$requestData = array(
'accountfunding' => '1',
'accounttypedescription' => 'MOTO',
'baseamount' => '1050',
'billingcountryiso2a' => 'GB',
'billingcounty' => 'Gwynedd',
'billingdob' => '2001-01-01',
'billingfirstname' => 'Jay',
'billinglastname' => 'Doe',
'billingpremise' => 'No 789',
'billingstreet' => 'Test Street',
'billingtown' => 'Bangor',
'currencyiso3a' => 'GBP',
'customeraccountnumber' => '123456789',
'customeraccountnumbertype' => 'ACCOUNT',
'customercountryiso2a' => 'GB',
'customerfirstname' => 'John',
'customerlastname' => 'Smith',
'expirydate' => '01/35',
'pan' => '4111111111111111',
'securitycode' => '123',
'requesttypedescriptions' => array('AUTH'),
'sitereference' => '{{site_reference}}'
);
$api = \Securetrading\api($configData);
$response = $api->process($requestData);
var_dump($response->toArray());
?>
curl --user {{wsapi_username}}:{{wsapi_password}} <DOMAIN>/json/ -H "Content-type: application/json" -H "Accept: application/json" -X POST -d '{
"alias":"{{wsapi_username}}",
"version": "1.00",
"request": [{
"accountfunding":"1",
"accounttypedescription":"MOTO",
"baseamount":"1050",
"billingcountryiso2a":"GB",
"billingcounty":"Gwynedd",
"billingdob":"2001-01-01",
"billingfirstname":"Jay",
"billinglastname":"Doe",
"billingpremise":"No 789",
"billingstreet":"Test Street",
"billingtown":"Bangor",
"currencyiso3a":"GBP",
"customeraccountnumber":"123456789",
"customeraccountnumbertype":"ACCOUNT",
"customercountryiso2a":"GB",
"customerfirstname":"John",
"customerlastname":"Smith",
"expirydate":"01/35",
"pan":"4111111111111111",
"securitycode":"123",
"requesttypedescriptions":["AUTH"],
"sitereference":"{{site_reference}}"
}]
}'
{
"alias":"{{wsapi_username}}",
"version":"1.00",
"request":[{
"accountfunding":"1",
"accounttypedescription":"MOTO",
"baseamount":"1050",
"billingcountryiso2a":"GB",
"billingcounty":"Gwynedd",
"billingdob":"2001-01-01",
"billingfirstname":"Jay",
"billinglastname":"Doe",
"billingpremise":"No 789",
"billingstreet":"Test Street",
"billingtown":"Bangor",
"currencyiso3a":"GBP",
"customeraccountnumber":"123456789",
"customeraccountnumbertype":"ACCOUNT",
"customercountryiso2a":"GB",
"customerfirstname":"John",
"customerlastname":"Smith",
"expirydate":"01/35",
"pan":"4111111111111111",
"securitycode":"123",
"requesttypedescriptions":["AUTH"],
"sitereference":"{{site_reference}}"
}]
}
<requestblock version="3.67">
<alias>{{wsapi_username}}</alias>
<request type="AUTH">
<billing>
<amount currencycode="GBP">1050</amount>
<country>GB</country>
<county>Gwynedd</county>
<dob>2001-01-01</dob>
<name>
<first>Jay</first>
<last>Doe</last>
</name>
<payment>
<pan>4111111111111111</pan>
<expirydate>01/35</expirydate>
<securitycode>123</securitycode>
</payment>
<premise>No 789</premise>
<street>Test Street</street>
<town>Bangor</town>
</billing>
<customer>
<accountnumber type="ACCOUNT">12345678</accountnumber>
<country>GB</country>
<name>
<first>John</first>
<last>Smith</last>
</name>
</customer>
<merchant>
<accountfunding>1</accountfunding>
</merchant>
<operation>
<accounttypedescription>MOTO</accounttypedescription>
<sitereference>{{site_reference}}</sitereference>
</operation>
</request>
</requestblock>
Vervang <DOMAIN>
met een ondersteund domein. Klik hier voor een volledige lijst.
Specificatie veld
De vereiste velden in een Account Funding Transaction (AFT) autorisatie verzoek zijn hetzelfde als een standaard AUTH verzoek, met de volgende verschillen:
Veld | Formaat | Beschrijving | ||
Velden voor rekeningfinanciering Deze extra velden zijn nodig om Account Funding Transactions (AFT) mogelijk te maken. |
||||
| accountfunding XPath: /merchant/rekeningbeheer |
Numeriek (1) |
Geef 1 op om aan te geven dat de transactie een Account Funding Transaction (AFT) is. |
|
| transactiontypeindicator XPath: /merchant/transactiontypeindicator |
Alfanumeriek (3) |
Voer hieronder de waarde in die overeenkomt met je MCC:
|
|
Velden afzender Voor AFT-verzoeken (Account Funding Transaction) AUTH vertegenwoordigen velden met het voorvoegsel "billing" gegevens die geassocieerd zijn met de verzender van fondsen. |
||||
| billingcountryiso2a XPath: /billing/country |
Alpha (2) |
Het land voor het adres van de verzender. Dit moet in ISO2A-formaat zijn. |
|
| billingdob XPath: /billing/dob |
Datum JJJJ-MM-DD |
De geboortedatum van de afzender. |
|
| billingfirstname XPath: /factuur/naam/eerste |
Alfanumeriek, inclusief symbolen (127) |
De voornaam van de afzender. |
|
| billinglastname XPath: /factuur/naam/laatst |
Alfanumeriek, inclusief symbolen (127) |
De achternaam van de afzender. |
|
| billingpremise XPath: /billing/premise |
Alfanumeriek, inclusief symbolen (25) |
Het huisnummer of de eerste regel van het adres van de afzender. |
|
| billingstreet XPath: /factuur/straat |
Alfanumeriek, inclusief symbolen (127) |
De straat die is ingevoerd voor het adres van de afzender. |
|
| billingtown XPath: /factuur/stad |
Alfanumeriek, inclusief symbolen (127) |
De stad die is ingevoerd voor het adres van de afzender. |
|
| billingcounty XPath: /billing/county |
Alfanumeriek, inclusief symbolen (127) |
De provincie die is ingevoerd voor het adres van de afzender. Voor adressen in de VS en Canada moet je de staat- of provinciecode van twee tekens opgeven, bijvoorbeeld "BC" voor British Columbia. Vereist wanneer het land van de afzender (billingcountryiso2a) "US" (Verenigde Staten) of "CA" (Canada) is. |
|
Velden ontvanger Voor AFT-verzoeken (Account Funding Transaction) AUTH vertegenwoordigen velden met het voorvoegsel "klant" gegevens die geassocieerd zijn met de ontvanger van fondsen. |
||||
| customeraccountnumber XPath: /customer/accountnumber |
Numeriek (20) |
Als het type rekeningnummer "ACCOUNT" is, het rekeningnummer van de ontvanger. Wanneer de customeraccountnumber waarde in het verzoek een kaartnummer is, wordt dit gemaskeerd (bijv. "559139######0504") in het antwoord, wanneer het wordt weergegeven in Portal en geretourneerd in URL-kennisgeving(s) (indien ingeschakeld). |
|
| customeraccountnumbertype XPath: /customer/accountnumber/@type |
Alfa (7) |
Ofwel "CARD" of "ACCOUNT". Wanneer de customeraccountnumber waarde in het verzoek een kaartnummer is, zal de customeraccountnumbertype waarde in het antwoord, wanneer weergegeven in Portal en geretourneerd in URL-kennisgeving(s) (indien ingeschakeld): "CARD". |
|
| customercountryiso2a XPath: /klant/land |
Alpha (2) |
Het land van de ontvanger. Dit moet in ISO2A-formaat zijn. Klik hier voor een volledige lijst van landcodes. Vereist als het ontvangende land (customercountryiso2a) "CA" (Canada) is. |
|
| customerfirstname XPath: /klant/naam/eerste |
Alfanumeriek, inclusief symbolen (127) |
De voornaam van de ontvanger. |
|
| customerlastname XPath: /klant/naam/achternaam |
Alfanumeriek, inclusief symbolen (127) |
De achternaam van de ontvanger. |
|
customercounty XPath: /klant/provincie |
Alfanumeriek, inclusief symbolen (127) |
Het district van de ontvanger. Voor adressen in de VS en Canada moet je de staat- of provinciecode van twee tekens opgeven, bijvoorbeeld "BC" voor British Columbia. Vereist als het ontvangende land (customercountryiso2a) "CA" (Canada) is. |
||
customerpremise XPath: /klant/premise |
Alfanumeriek, inclusief symbolen (25) |
De naam/het nummer van het eigendom van de ontvanger. Vereist als het ontvangende land (customercountryiso2a) "CA" (Canada) is. |
||
customerstreet XPath: /customer/street |
Alfanumeriek, inclusief symbolen (127) |
De straatnaam van de ontvanger. Vereist als het ontvangende land (customercountryiso2a) "CA" (Canada) is. |
||
customertown XPath: /customer/town |
Alfanumeriek, inclusief symbolen (127) |
De stad van de ontvanger. Vereist als het ontvangende land (customercountryiso2a) "CA" (Canada) is. |
||
customermiddlename XPath: /klant/naam/midden |
Alfanumeriek, inclusief symbolen (127) |
De middelste naam van de ontvanger. Vereist als het ontvangende land (customercountryiso2a) "ZA" (Zuid-Afrika) is. |
FAQ
Wat is een financieringstransactie?
Een financieringstransactie is vergelijkbaar met een gewone aankoop, maar in plaats van goederen of diensten te kopen, wordt er geld overgemaakt tussen twee rekeningen, die beide eigendom zijn van de merchant. Voorbeelden hiervan zijn het opwaarderen van een prepaidkaart of het financieren van een digitale portemonnee of peer-to-peer betaalrekening. Op Visa worden financieringstransacties ook gebruikt voor het kopen van risicovolle effecten en cryptovaluta.
Zijn AFT- en MoneySend -financiering onderworpen aan dezelfde snelheidslimieten en sanctiescreening als OCT (Original Credit Transfer) en CFT (Cardholder Funds Transfer)?
Ja. Er zijn snelheidslimieten en Anti-Money Laundering (AML) controles uitgevoerd op AFT en MoneySend financiering. Dit is om het betalingslandschap te beschermen tegen het witwassen van geld, overtredingen van sancties en andere financiële misdrijven.
Moeten winkeliers zich registreren bij de kaartsystemen?
Ja. Dit kan namens u worden gedaan door Trust Payments. Echter, Mastercard vereist meer details om P2P handelaren te registreren dan vereist is voor niet-P2P handelaren. Voordat ze conforme MoneySend financieringstransacties kunnen starten, moeten P2P merchants hun AML beleid indienen om het registratieproces met Mastercard te voltooien.
Wat is het verschil tussen P2P en niet-P2P?
- Non-P2P is wanneer de kaarthouder zijn kaart gebruikt om een saldo op te waarderen op een rekening in handen van een handelaar die ofwel in het bestand staat bij de handelaar of is ingevoerd op het POI (Point of Interaction). Pas als de rekening is opgewaardeerd, kan de kaarthouder die rekening gebruiken om transacties te doen of betalingen te initiëren naar andere kaarthouders of rekeningen.
- Bij P2P is er geen saldo vereist en wordt het geld direct van de kaart in het bestand gehaald om naar de ontvangende partij te gaan.
Hoe testen winkeliers deze wijzigingen?
Testen is nu beschikbaar voor winkeliers met behulp van hun test site referentie. Onze integratieteams staan klaar om winkeliers te ondersteunen bij het implementeren van deze wijzigingen.
Als de wijzigingen klaar zijn om te worden vrijgegeven voor de productieomgeving, neem dan contact op met integrationsupport@trustpayments.com zodat de live site referentie dienovereenkomstig kan worden geconfigureerd.
Wanneer kunnen winkeliers deze wijzigingen doorvoeren?
Handelaren moeten de wijzigingen zo snel mogelijk doorvoeren.
Er worden geen wijzigingen aangebracht in de configuratie van een merchant zonder zijn actieve medewerking.
Als je vragen hebt over het integratieproces, neem dan contact op met je accountmanager of ons Support Team.
Wat gebeurt er als handelaren de vereiste wijzigingen niet doorvoeren?
Deze vereisten worden bepaald door de regels van het kaartsysteem. Als de vereiste wijzigingen niet binnen de deadline zijn doorgevoerd, kunnen de kaartsystemen eisen dat alle niet-conforme transacties worden geweigerd.
Verwante artikelen
AUTH Specificatie
Dit artikel bevat codevoorbeelden en veldspecificaties voor standaard autorisatie verzoeken.