Cryptocurrency Indicator

Deze pagina bevat de specificaties voor de cryptocurrencyindicator veld. Dit veld werkt als een vlag om te bepalen of een transactie al dan niet bedoeld is voor de aankoop van cryptocurrency.

Deze functionaliteit wordt ondersteund voor winkeliers met een Trust Payments acquiring account. Als u een andere acquiring bank gebruikt, moet u contact opnemen met ons Support Team om te controleren of deze functie wordt ondersteund voordat u verder gaat.

Vereiste: Uw Klant Categorie Code moet 6051 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.

Procesoverzicht

Er zijn twee methoden die kunnen worden gebruikt om de cryptocurrencyindicator veld in verzoeken die bij de overnemende bank worden ingediend:

Door het toewijzen van standaardwaarden op uw rekening
Met deze methode wordt de cryptocurrencyindicator veld wordt automatisch opgenomen in transacties die via uw rekening worden verwerkt, zonder dat er extra configuratie nodig is. U kunt uw account zo configureren dat deze methode wordt gebruikt, neem contact op met ons Support Team, en vraagt dat uw site wordt ingesteld met de standaardinstelling van uw voorkeur. cryptocurrencyindicator veldwaarde (dit wordt hieronder nader beschreven).
Met de hand met inbegrip van de cryptocurrencyindicator veld in uw verzoeken
Met deze methode kunt u per verzoek verschillende waarden opgeven. Om uw account te configureren om deze methode te gebruiken, werkt u uw verzoeken bij met behulp van de onderstaande specificatie.

Het indienen van cryptocurrencyindicator in een verzoek

Payment Pages

De cryptocurrency indicator velden kunnen worden opgenomen in de POST naar Payment Pages, zoals in het volgende voorbeeld:

<html>
  <body>
    <form method="POST" action="<DOMAIN>/process/payments/choice">
      <input type="hidden" name="sitereference" value="test_site12345">
      <input type="hidden" name="stprofile" value="default">
      <input type="hidden" name="currencyiso3a" value="USD">
      <input type="hidden" name="mainamount" value="100.00">
      <input type="hidden" name="version" value="2">
      <input type="hidden" name="cryptocurrencyindicator" value="1">
      <input type="submit" value="Pay">
    </form>
  </body>
</html>

Vervang <DOMAIN> met een ondersteund domein. Klik hier voor een volledige lijst.

JavaScript Library

U moet de payload ingediend binnen uw JWT om een extra veld op te nemen, zoals hieronder getoond. Het indienen van de cryptocurrencyindicator op deze manier zal altijd elke waarde overschrijven die is opgeslagen op uw account of geërfd van een bovengeschikte.

{
  "payload":{
    "accounttypedescription":"ECOM",
    "baseamount":"1050",
    "currencyiso3a":"GBP",
    "sitereference":"test_site12345",
    "requesttypedescriptions":["THREEDQUERY","AUTH"],
    "cryptocurrencyindicator":"1"
  },
  "iat":1559033849,
  "iss":"jwt.user"
}

Android SDK / iOS SDK

{
  "payload":{
    "accounttypedescription":"ECOM",
    "baseamount":"1050",
    "currencyiso3a":"GBP",
    "sitereference":"test_site12345",
    "termurl":"https:\/\/payments.securetrading.net\/process\/payments\/mobilesdklistener",
    "requesttypedescriptions":["THREEDQUERY","AUTH"],
    "cryptocurrencyindicator":"1"
  },
  "iat":1559033849,
  "iss":"jwt.user"
}

Webservices API

U moet het verzoek bijwerken zoals hieronder aangegeven. Het indienen van de cryptocurrencyindicator op deze manier zal altijd elke waarde overschrijven die is opgeslagen op uw account of geërfd van een bovengeschikte.

#!/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",
  "billingfirstname": "Joe",
  "billinglastname": "Bloggs",
  "cryptocurrencyindicator": "1",
  "pan": "4111111111111111",
  "expirydate": "12/2020",
  "securitycode": "123"
}

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',
  'billingfirstname' => 'Joe',
  'billinglastname' => 'Bloggs',
  'cryptocurrencyindicator' => '1',
  'pan' => '4111111111111111',
  'expirydate' => '12/2020',
  'securitycode' => '123'
);

$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",
    "billingfirstname": "Joe",
    "billinglastname": "Bloggs",
    "accounttypedescription": "ECOM",
    "cryptocurrencyindicator": "1",
    "pan": "4111111111111111",
    "expirydate": "12/2020",
    "securitycode": "123"
  }]
}'

{
  "alias":"webservices@example.com",
  "version":"1.00",
  "request":[{
    "currencyiso3a":"GBP",
    "requesttypedescriptions":["AUTH"],
    "sitereference":"test_site12345",
    "baseamount":"1050",
    "orderreference":"My_Order_123",
    "billingfirstname":"Joe",
    "billinglastname":"Bloggs",
    "accounttypedescription":"ECOM",
    "cryptocurrencyindicator":"1",
    "pan":"4111111111111111",
    "expirydate":"12/2020",
    "securitycode":"123"
  }]
}

<requestblock version="3.67">
  <alias>webservices@example.com</alias>
  <request type="AUTH">
    <merchant>
      <orderreference>My_Order_123</orderreference>
    </merchant>
    <billing>
      <payment>
        <expirydate>12/2020</expirydate>
        <pan>4111111111111111</pan>
        <securitycode>123</securitycode>
      </payment>
      <amount currencycode="GBP">1050</amount>
      <name>
        <first>Joe</first>
        <last>Bloggs</last>
      </name>
    </billing>
    <operation>
      <sitereference>test_site12345</sitereference>
      <accounttypedescription>ECOM</accounttypedescription>
      <cryptocurrencyindicator>1</cryptocurrencyindicator>
    </operation>
  </request>
</requestblock>

Specificatie veld

Veld

Formaat

Beschrijving

cryptocurrencyindicator
XPath: /operation/cryptocurrencyindicator

Numeriek (1)

Geeft aan of de transactie is gemarkeerd als een aankoop van cryptocurrency:

1 - Transactie is gemarkeerd als aankoop van cryptocurrency.
0 - Transactie is niet gemarkeerd als aankoop van cryptocurrency.

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).

Aanvullende opmerkingen

Ondersteunde verzoektypes

De cryptocurrencyindicator veld kan worden ingediend in de volgende verzoeken:

ACCOUNTCHECK
AUTH
THREEDQUERY

Klik hier voor een volledige lijst van soorten verzoeken.

Overerving van bovengeschikte verzoekt

Als u de cryptocurrencyindicator veld in een verzoek, en een bovengeschikte transactiereferentie is gespecificeerd, wordt het geërfd van die bovengeschikte.

Meer lezen over dit onderwerp