These docs are for v1.0.1. Click to read the latest docs for v2.1.0.

Boncard

120

paymentmethod=BON

Payment ProcessIntegration
Authorization:heavy-check-mark:Payment Page:heavy-check-mark:
Deferred Settlement:heavy-check-mark:Split Mode:heavy-check-mark:
Refund:heavy-check-mark:
Cancel:heavy-check-mark:
Alias:heavy-check-mark:

Description

boncard payment & services ag is a provider of gift and payment cards as well as bonus and discount cards, which are equally aimed at individual detailists as well as chain stores or alliances.
Payment Method provider website :link:

Web payment flow

 1 
[Not supported by viewer]
Customer clicks Pay
Customer clicks Pay
Merchant Website
Merchant Website
Merchant Server
Merchant Server
Payment Page loaded from Datatrans
Payment Page loaded from Datatrans
Boncard
Boncard
 3 
[Not supported by viewer]
Customer selects Boncrad
[Not supported by viewer]
 2 
[Not supported by viewer]
 4 
[Not supported by viewer]
Validates and prepares forwarding to Acquirer
Validates and prepares forwarding to Acquirer
 5 
[Not supported by viewer]
Authorization / Forwarding
Authorization / Forwarding
 7 
[Not supported by viewer]
Receives Result 
Receives Result 
7.1
[Not supported by viewer]
 8 
[Not supported by viewer]
Invokes merchant's
POST URL (Webhook)
Invokes merchant's<br>POST URL (Webhook)
Receives Result 
Receives Result 
 9 
[Not supported by viewer]
Redirects customer back to merchant
Redirects customer back to merchant
Customer gets redirected to merchant page
Customer gets redirected to merchant page
Boncard Sub-Acquirer
Boncard Sub-Acquirer
Authorization
Authorization
 6 
[Not supported by viewer]

Server to Server API calls

After a transactionId or alias was received by completing the payment flow on the web, the following server to server API calls can be used to do other actions.

Authorization

Request

curl -v -X POST https://api.sandbox.datatrans.com/upp/jsp/XML_authorize.jsp \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d @- << EOF
<?xml version="1.0" encoding="UTF-8" ?>
<authorizationService version="6">
  <body merchantId="1000011011">
    <transaction refno="Boncard-001">
      <request>
        <pmethod>BON</pmethod>
        <amount>100</amount>
        <currency>CHF</currency>
        <aliasCC>637736IECZLT0018</aliasCC>
        <sign>30916165706580013</sign>
      </request>
    </transaction>
  </body>
</authorizationService>
EOF

Response

<?xml version='1.0' encoding='UTF-8'?>
<authorizationService version='6'>
  <body merchantId='1000011011' status='accepted'>
    <transaction refno='Boncard-001' trxStatus='response'>
      <request>
        <pmethod>BON</pmethod>
        <amount>100</amount>
        <currency>CHF</currency>
        <aliasCC>637736IECZLT0018</aliasCC>
        <sign>30916165706580013</sign>
        <reqtype>NOA</reqtype>
      </request>
      <response>
        <responseCode>01</responseCode>
        <responseMessage>Authorized</responseMessage>
        <uppTransactionId>200225094913726443</uppTransactionId>
        <authorizationCode>913776444</authorizationCode>
        <acqAuthorizationCode>094913</acqAuthorizationCode>
        <maskedCC>637736xxxxxx0018</maskedCC>
        <status>success</status>
        <testOnly>yes</testOnly>
        <sign2>N/A</sign2>
      </response>
    </transaction>
  </body>
</authorizationService>

Settlement

Request

curl -v -X POST https://api.sandbox.datatrans.com/upp/jsp/XML_processor.jsp \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d @- << EOF
<?xml version="1.0" encoding="UTF-8" ?>
<paymentService version="2">
  <body merchantId="1000011011">
    <transaction refno="Boncard-001-SETTLE">
      <request>
        <amount>100</amount>
        <currency>CHF</currency>
        <uppTransactionId>200225094913726443</uppTransactionId>
      </request>
    </transaction>
  </body>
</paymentService>
EOF

Response

<?xml version='1.0' encoding='UTF-8'?>
<paymentService version='2'>
  <body merchantId='1000011011' status='accepted'>
    <transaction refno='Boncard-001-SETTLE' trxStatus='response'>
      <request>
        <amount>100</amount>
        <currency>CHF</currency>
        <uppTransactionId>200225094913726443</uppTransactionId>
        <reqtype>COA</reqtype>
        <transtype>05</transtype>
      </request>
      <response>
        <responseCode>01</responseCode>
        <responseMessage>settlement succeeded</responseMessage>
      </response>
    </transaction>
  </body>
</paymentService>

Credit

Request

curl -v -X POST https://api.sandbox.datatrans.com/upp/jsp/XML_processor.jsp \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d @- << EOF
<?xml version="1.0" encoding="UTF-8" ?>
<paymentService version="2">
  <body merchantId="1000011011">
    <transaction refno="Boncard-001-REFUND">
      <request>
        <amount>100</amount>
        <currency>CHF</currency>
        <uppTransactionId>200225094913726443</uppTransactionId>
        <transtype>06</transtype>
      </request>
    </transaction>
  </body>
</paymentService>
EOF

Response

<?xml version='1.0' encoding='UTF-8'?>
<paymentService version='2'>
  <body merchantId='1000011011' status='accepted'>
    <transaction refno='Boncard-001-REFUND' trxStatus='response'>
      <request>
        <amount>100</amount>
        <currency>CHF</currency>
        <uppTransactionId>200225094913726443</uppTransactionId>
        <transtype>06</transtype>
        <reqtype>COA</reqtype>
      </request>
      <response>
        <responseCode>01</responseCode>
        <responseMessage>credit succeeded</responseMessage>
        <uppTransactionId>200225095432357124</uppTransactionId>
        <authorizationCode>432387125</authorizationCode>
        <acqAuthorizationCode>095432</acqAuthorizationCode>
      </response>
    </transaction>
  </body>
</paymentService>

Cancel

Request

curl -v -X POST https://api.sandbox.datatrans.com/upp/jsp/XML_processor.jsp \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d @- << EOF
<?xml version="1.0" encoding="UTF-8" ?>
<paymentService version="2">
  <body merchantId="1000011011">
    <transaction refno="Boncard-002-CANCEL">
      <request>
        <amount>100</amount>
        <currency>CHF</currency>
        <uppTransactionId>200225095537327231</uppTransactionId>
        <reqtype>DOA</reqtype>
      </request>
    </transaction>
  </body>
</paymentService>
EOF

Response

<?xml version='1.0' encoding='UTF-8'?>
<paymentService version='2'>
  <body merchantId='1000011011' status='accepted'>
    <transaction refno='Boncard-002-CANCEL' trxStatus='response'>
      <request>
        <amount>100</amount>
        <currency>CHF</currency>
        <uppTransactionId>200225095537327231</uppTransactionId>
        <reqtype>DOA</reqtype>
        <transtype>05</transtype>
      </request>
      <response>
        <responseCode>01</responseCode>
        <responseMessage>cancellation succeeded</responseMessage>
      </response>
    </transaction>
  </body>
</paymentService>

Status

Request

curl -v -X POST https://api.sandbox.datatrans.com/upp/jsp/XML_status.jsp \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d @- << EOF
<?xml version="1.0" encoding="UTF-8" ?>
<statusService version="5">
  <body merchantId="1000011011">
    <transaction>
      <request>
        <uppTransactionId>200225095722577425</uppTransactionId>
        <reqtype>STX</reqtype>
      </request>
    </transaction>
  </body>
</statusService>
EOF

Response

<?xml version='1.0' encoding='UTF-8'?>
<statusService version='5'>
  <body merchantId='1000011011' status='accepted'>
    <transaction trxStatus='response'>
      <request>
        <uppTransactionId>200225095722577425</uppTransactionId>
        <reqtype>STX</reqtype>
      </request>
      <response itemNr='1'>
        <responseCode>1</responseCode>
        <responseMessage>Trx ready for settlement (trx authorized)</responseMessage>
        <refno>Boncard-002</refno>
        <amount>100</amount>
        <currency>CHF</currency>
        <authorizationCode>722637426</authorizationCode>
        <pmethod>BON</pmethod>
        <uppTransactionId>200225095722577425</uppTransactionId>
        <maskedCC>637736xxxxxx0018</maskedCC>
        <aliasCC>637736IECZLT0018</aliasCC>
        <expm></expm>
        <expy></expy>
        <trxDate>20200225</trxDate>
        <trxTime>095722</trxTime>
        <trtype>05</trtype>
      </response>
    </transaction>
  </body>
</statusService>