Visa en Mastercard hebben bepaald dat alle handelaren die schuldaflossingen verwerken de volgende velden in verzoeken aan Trust Payments moeten opnemen (geldt alleen voor de verzoektypes AUTH en ACCOUNTCHECK).
Dit mandaat geldt alleen voor merchants met bepaalde acquiring banks. Neem contact op met ons Support Team voor meer informatie.
Vereiste: Uw Klant Categorie Code moet ofwel 6012, 6051 of 7299 zijn.
Uw Klant Categorie Code (MCC) is een viercijferig nummer dat door uw verwerver aan u is toegekend. Het wordt gebruikt om het bedrijf in te delen naar het soort 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 Support Team.
Erfenis
Zodra u een AUTH of ACCOUNTCHECK met deze verplichte velden hebt verwerkt, kunnen ze in toekomstige verzoeken worden overgenomen en indien nodig automatisch aan de wervende bank worden doorgegeven.
Voorbeeld aanvraag
Het volgende voorbeeld bevat de velden die verplicht zijn voor handelaren die schuldaflossingen verwerken:
(Payload)
{
"payload":{
"accounttypedescription":"ECOM",
"baseamount":"1050",
"currencyiso3a":"GBP",
"sitereference":"test_site12345",
"requesttypedescriptions":["THREEDQUERY","AUTH"],
"customeraccountnumber":"4111111111111111",
"customeraccountnumbertype":"CARD",
"customerdob":"1990-01-01",
"customerpostcode":"TR45 6ST",
"customerlastname":"Bloggs",
"debtrepayment":"1"
},
"iat":1559033849,
"iss":"jwt.user"
}
Het volgende voorbeeld bevat de velden die verplicht zijn voor handelaren die schuldaflossingen verwerken:
(Payload)
{
"payload":{
"accounttypedescription":"ECOM",
"baseamount":"1050",
"currencyiso3a":"GBP",
"sitereference":"test_site12345",
"termurl":"https:\/\/payments.securetrading.net\/process\/payments\/mobilesdklistener",
"requesttypedescriptions":["THREEDQUERY","AUTH"],
"customeraccountnumber":"4111111111111111",
"customeraccountnumbertype":"CARD",
"customerdob":"1990-01-01",
"customerpostcode":"TR45 6ST",
"customerlastname":"Bloggs",
"debtrepayment":"1"
},
"iat":1559033849,
"iss":"jwt.user"
}
Het volgende voorbeeld bevat de velden die verplicht zijn voor handelaren die schuldaflossingen verwerken:
#!/usr/bin/python
import securetrading
stconfig = securetrading.Config()
stconfig.username = "webservices@example.com"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)
auth = {
"sitereference": "test_site12345",
"requesttypedescriptions": ["AUTH"],
"accounttypedescription": "ECOM",
"currencyiso3a": "GBP",
"baseamount": "1050",
"orderreference": "My_Order_123",
"pan": "4111111111111111",
"expirydate": "12/2020",
"securitycode": "123",
"customeraccountnumber": "4111111111111111",
"customeraccountnumbertype": "CARD",
"customerdob": "1990-01-01",
"customerpostcode": "TR45 6ST",
"customerlastname": "Bloggs",
"debtrepayment": "1"
}
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' => 'webservices@example.com',
'password' => 'Password1^',
);
$requestData = array(
'sitereference' => 'test_site12345',
'requesttypedescriptions' => array('AUTH'),
'accounttypedescription' => 'ECOM',
'currencyiso3a' => 'GBP',
'baseamount' => '1050',
'orderreference' => 'My_Order_123',
'pan' => '4111111111111111',
'expirydate' => '12/2020',
'securitycode' => '123',
'customeraccountnumber' => '4111111111111111',
'customeraccountnumbertype' => 'CARD',
'customerdob' => '1990-01-01',
'customerpostcode' => 'TR45 6ST',
'customerlastname' => 'Bloggs',
'debtrepayment' => '1'
);
$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": [{
"currencyiso3a": "GBP",
"requesttypedescriptions": ["AUTH"],
"sitereference": "test_site12345",
"baseamount": "1050",
"orderreference": "My_Order_123",
"accounttypedescription": "ECOM",
"pan": "4111111111111111",
"expirydate": "12/2020",
"securitycode": "123",
"customeraccountnumber": "4111111111111111",
"customeraccountnumbertype": "CARD",
"customerdob": "1990-01-01",
"customerpostcode": "TR45 6ST",
"customerlastname": "Bloggs",
"debtrepayment": "1"
}]
}'
{
"alias":"webservices@example.com",
"version":"1.00",
"request":[{
"currencyiso3a":"GBP",
"requesttypedescriptions":["AUTH"],
"sitereference":"test_site12345",
"baseamount":"1050",
"orderreference":"My_Order_123",
"accounttypedescription":"ECOM",
"pan":"4111111111111111",
"expirydate":"12/2020",
"securitycode":"123",
"customeraccountnumber":"4111111111111111",
"customeraccountnumbertype":"CARD",
"customerdob":"1990-01-01",
"customerpostcode":"TR45 6ST",
"customerlastname":"Bloggs",
"debtrepayment":"1"
}]
}
<requestblock version="3.67">
<alias>webservices@example.com</alias>
<request type="AUTH">
<merchant>
<orderreference>My_Order_123</orderreference>
<debtrepayment>1</debtrepayment>
</merchant>
<billing>
<payment type="VISA">
<expirydate>12/2020</expirydate>
<pan>4111111111111111</pan>
<securitycode>123</securitycode>
</payment>
<amount currencycode="GBP">1050</amount>
</billing>
<operation>
<sitereference>test_site12345</sitereference>
<accounttypedescription>ECOM</accounttypedescription>
</operation>
<customer>
<name>
<last>Bloggs</last>
</name>
<postcode>TR45 6ST</postcode>
<dob>1990-01-01</dob>
<accountnumber type="CARD">4111111111111111</accountnumber>
</customer>
</request>
</requestblock>
Specificatie veld
De verplichte velden zijn als volgt:
| Veld | Formaat | Beschrijving | |
| customeraccountnumber XPath: /customer/accountnumber |
Numeriek (20) |
Als het type rekeningnummer "ACCOUNT", het rekeningnummer van de rekeninghouder.
Als het type rekeningnummer "CARD", het kaartnummer van de rekeninghouder. De geretourneerde waarde in het antwoord is in een gemaskeerd formaat, bijvoorbeeld "411111#######1111". |
|
| customeraccountnumbertype XPath: /customer/accountnumber/@type |
Alfa (7) | Ofwel "CARD" of "ACCOUNT". | |
| customerdob XPath: /customer/dob |
Datum JJJJ-MM-DD | De geboortedatum van de rekeninghouder. | |
| customerpostcode XPath: /customer/postcode |
Alfanumeriek (25) |
De postcode of het postnummer van de klant.
Dit moet een geldige postcode zijn voor de customercountryiso2a ingediend. |
|
| customerlastname XPath: /customer/name/last |
Alfanumeriek, inclusief symbolen (127) |
De achternaam van de klant. | |
| debtrepayment XPath: /merchant/debtrepayment |
Numeriek (1) |
Geeft aan of de transactie is gemarkeerd als schuldaflossing:
Opmerking: Uw site kan worden geconfigureerd om deze vlag standaard automatisch met waarde 0 of 1 in te dienen bij elke transactie. (Neem contact op met ons Support Team om deze wijziging door te voeren). |
