Auth Capture performs two actions via a single request:
- authorize: checks whether a credit card is valid and has the funds to complete a specific transaction (a purchase)
- capture: submits the authorized transaction for settlement (a payment by the shopper)
Request Content
card-transaction
container required, contains the following properties (refer to card-transaction):
card-transaction-type
string required, value must be AUTH_CAPTURE
merchant-transaction-id
string optional
soft-descriptor
string optional
descriptor-phone-number
string optional
tax-reference
string optional
vendors-info
container required if using marketplace vendor(s) (refer to vendors-info)
amount
decimal required
currency
string required
vaulted-shopper-id
integer required if using a vaulted shopper
card-holder-info
container required for LatAm local processing (refer to card-holder-info)
wallet-id
long required if using Masterpass or Visa Checkout
wallet
container required if using Apple Pay or Google Pay™ (refer to wallet)
transaction-fraud-info
container optional (refer to transaction-fraud-info)
credit-card
container required if sending card or if vaulted shopper has multiple cards.
Do not include if using Hosted Payment Fields or wallet
(refer to credit-card).
pf-token
string required if using Hosted Payment Fields, Embedded Checkout, or Secured Payment Collector
three-d-secure
container optional (refer to three-d-secure)
transaction-meta-data
container optional (refer to transaction-meta-data)
level-3-data
container optional (refer to level-3-data)
store-card
boolean optional (refer to card-transaction)
network-transaction-info
container optional (refer to network-transaction-info)
transaction-order-source
string optional
transaction-initiator
string optional
Response Details
If successful, the response HTTP status code is 200 OK.
The response contains a card-transaction
resource (refer to card-transaction) with the request properties plus these additions:
transaction-id
vaulted-shopper-id
processing-info
fraud-result-info
if fraud prevention is enabled
three-d-secure
if sending 3D Secure authentication data
vendors-info
if using marketplace vendor(s)
level-3-data
if sending Level 2/3 data
network-transaction-info
container optional
tax-reference
if including tax quote
Examples
Basic request and response examples
Request
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<soft-descriptor>DescTest</soft-descriptor>
<amount>11.00</amount>
<currency>USD</currency>
<card-holder-info>
<first-name>test first name</first-name>
<last-name>test last name</last-name>
<zip>02453</zip>
</card-holder-info>
<credit-card>
<card-number>4263982640269299</card-number>
<security-code>837</security-code>
<expiration-month>02</expiration-month>
<expiration-year>2023</expiration-year>
</credit-card>
</card-transaction>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<?xml version="1.0" encoding="UTF-8"?>
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<soft-descriptor>DescTest</soft-descriptor>
<amount>11.00</amount>
<currency>USD</currency>
<card-holder-info>
<first-name>test first name</first-name>
<last-name>test last name</last-name>
<zip>02453</zip>
</card-holder-info>
<credit-card>
<card-number>4263982640269299</card-number>
<security-code>837</security-code>
<expiration-month>02</expiration-month>
<expiration-year>2023</expiration-year>
</credit-card>
<transaction-meta-data>
<meta-data>
<meta-key>stateTaxAmount</meta-key>
<meta-value>20.00</meta-value>
<meta-description>State Tax Amount</meta-description>
</meta-data>
<meta-data>
<meta-key>cityTaxAmount</meta-key>
<meta-value>20.00</meta-value>
<meta-description>City Tax Amount</meta-description>
</meta-data>
<meta-data>
<meta-key>shippingAmount</meta-key>
<meta-value>10.00</meta-value>
<meta-description>Shipping Amount</meta-description>
</meta-data>
</transaction-meta-data>
</card-transaction>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<merchant-transaction-id>3</merchant-transaction-id>
<soft-descriptor>DescTest</soft-descriptor>
<amount>11.00</amount>
<currency>USD</currency>
<card-holder-info>
<first-name>test first name</first-name>
<last-name>test last name</last-name>
<zip>02453</zip>
</card-holder-info>
<credit-card>
<card-number>4263982640269299</card-number>
<security-code>837</security-code>
<expiration-month>02</expiration-month>
<expiration-year>2023</expiration-year>
</credit-card>
</card-transaction>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<?xml version="1.0" encoding="UTF-8"?>
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<soft-descriptor>DescTest</soft-descriptor>
<amount>11.00</amount>
<currency>USD</currency>
<card-holder-info>
<first-name>test first name</first-name>
<last-name>test last name</last-name>
<zip>123456</zip>
</card-holder-info>
<credit-card>
<encrypted-card-number>$bsjs_1_0_3$B23uuxq8drUwOYZm3wZi+Qm69V5GPEt8PEio+Edwcm8akczQSK7odgLQH/Au+VqOCsGspW1Q9mPyQIzGLSZLVToAQVfq5C1ld+2ogIIsDL32Hd6IojboLyVlYT1FvPQoDyz19K6N0CUHh5uk0kCLuHSUyjvoJH38ojHZifbJSm/7S5vAtiuC3BJt2z8k9nauQaAXkbyoAYwrS1yDpqOt2k2lGhKcmdQ4ImDR0RL8m8xig6sFrki9oqo3Mju/M5r7wXXVTf7TMtWiQbzdfREOxKUnviXJZpncdHqVjj5GvPYun2qgopKVKr8F5+yd19TVW2gvA1kXBkXonFL9159Gxg==$zckJgo2i8jXDiAHwVVHBKypXFnWqF2e+6luBkmtQQRKniDXyXaalRVKLtYscBaGd$W7Ojqk1Q2iOJVeGL39RAsZTtfup3f1deSzvxrvC9rXA=</encrypted-card-number>
<encrypted-security-code>$bsjs_1_0_3$MB1nBpok/YkuWPG1/7e6dyFFhDPHB8p8E9Yo+0YHHV+xkHuzFKr02wAnE8PJ8QCzWH+2ctXy5FN6wLKjwFrfTOgy0BJ9k9+NDEe8mhsu66wMlyc3lnwrbvMRCWN1O+5gUNCFExj7B0mDtf4gtxecXs74KZ5l5dbpGWdKUk5i7OewWyTqsONbn9taLfVBOwuIOy2Jgi4fx+yB8Q05KdZeHSNSBJh8H/47AUNAn5dM+d9iO6yGQB3obzEzzR3UtHlkGR52ZsgbbFh0JMm9lBM2ClgYM8jvmQjS9HX2ojt1fkbhuPEb1IY/M498a+1wDPpI4aMfDxO1lSpJneRSpY5k4g==$XaKq1NbPcS0iHy9N9jHekEIByHYS4G3wJXlC9EQjAGM=$BJn6X6mBYGUo8Eoq4RQz69gsi4Azl8jT973mNpG9Yuo=</encrypted-security-code>
<expiration-month>07</expiration-month>
<expiration-year>2023</expiration-year>
</credit-card>
</card-transaction>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<?xml version="1.0" encoding="UTF-8"?>
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<soft-descriptor>DescTest</soft-descriptor>
<amount>11.00</amount>
<currency>USD</currency>
<card-holder-info>
<first-name>test first name</first-name>
<last-name>test last name</last-name>
<zip>02453</zip>
</card-holder-info>
<pf-token>a670c0380d99052abd1d7c182381dc787d8f8b99b9929b18632ceb21b269d250_</pf-token>
</card-transaction>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<merchant-transaction-id>3</merchant-transaction-id>
<soft-descriptor>DescTest</soft-descriptor>
<amount>11.00</amount>
<currency>USD</currency>
<card-holder-info>
<first-name>test first name</first-name>
<last-name>test last name</last-name>
<zip>02453</zip>
<merchant-shopper-id>a432567</merchant-shopper-id>
</card-holder-info>
<credit-card>
<card-number>4263982640269299</card-number>
<security-code>837</security-code>
<expiration-month>02</expiration-month>
<expiration-year>2023</expiration-year>
</credit-card>
</card-transaction>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<soft-descriptor>DescTest</soft-descriptor>
<vendors-info>
<vendor-info>
<vendor-id>10398032</vendor-id>
</vendor-info>
</vendors-info>
<amount>11.00</amount>
<currency>USD</currency>
<card-holder-info>
<first-name>test first name</first-name>
<last-name>test last name</last-name>
<zip>02453</zip>
</card-holder-info>
<credit-card>
<card-number>4263982640269299</card-number>
<security-code>837</security-code>
<expiration-month>02</expiration-month>
<expiration-year>2023</expiration-year>
</credit-card>
</card-transaction>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<soft-descriptor>DescTest</soft-descriptor>
<amount>11.00</amount>
<currency>USD</currency>
<card-holder-info>
<first-name>test first name</first-name>
<last-name>test last name</last-name>
</card-holder-info>
<credit-card>
<card-number>6011 0009 9013 9424</card-number>
<security-code>887</security-code>
<expiration-month>02</expiration-month>
<expiration-year>2023</expiration-year>
</credit-card>
<store-card>true</store-card>
</card-transaction>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<?xml version="1.0" encoding="UTF-8"?>
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<soft-descriptor>DescTest</soft-descriptor>
<amount>11.00</amount>
<currency>USD</currency>
<pf-token>abcde12345**********</pf-token>
</card-transaction>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<soft-descriptor>DescTest</soft-descriptor>
<transaction-order-source>MOTO</transaction-order-source>
<amount>22.50</amount>
<currency>USD</currency>
<card-holder-info>
<first-name>John</first-name>
<last-name>Blue</last-name>
</card-holder-info>
<credit-card>
<card-number>4111 1111 1111 1111</card-number>
<security-code>111</security-code>
<expiration-month>07</expiration-month>
<expiration-year>2023</expiration-year>
</credit-card>
</card-transaction>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<soft-descriptor>Test transaction</soft-descriptor>
<amount>174.8</amount>
<currency>USD</currency>
<tax-reference>048deff0-a285-47e1-bc39-42f79bf0095b</tax-reference>
<card-holder-info>
<first-name>Jane</first-name>
<last-name>Smith</last-name>
<zip>02453</zip>
<country>us</country>
</card-holder-info>
<credit-card>
<card-number>4263982640269299</card-number>
<security-code>837</security-code>
<expiration-month>02</expiration-month>
<expiration-year>2023</expiration-year>
</credit-card>
</card-transaction>'
Response
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<transaction-id>1035592987</transaction-id>
<soft-descriptor>BLS*DescTest</soft-descriptor>
<amount>11.00</amount>
<usd-amount>11.00</usd-amount>
<currency>USD</currency>
<transaction-approval-date>10/01/2020</transaction-approval-date>
<transaction-approval-time>10:19:21</transaction-approval-time>
<card-holder-info>
<first-name>test first name</first-name>
<last-name>test last name</last-name>
<zip>02453</zip>
</card-holder-info>
<vaulted-shopper-id>28878003</vaulted-shopper-id>
<credit-card>
<card-last-four-digits>9299</card-last-four-digits>
<card-type>VISA</card-type>
<card-sub-type>CREDIT</card-sub-type>
<card-category>PLATINUM</card-category>
<bin-category>CONSUMER</bin-category>
<card-regulated>N</card-regulated>
<issuing-bank>ALLIED IRISH BANKS PLC</issuing-bank>
<issuing-country-code>ie</issuing-country-code>
</credit-card>
<processing-info>
<processing-status>success</processing-status>
<cvv-response-code>MA</cvv-response-code>
<authorization-code>123456</authorization-code>
<avs-response-code-zip>U</avs-response-code-zip>
<avs-response-code-address>U</avs-response-code-address>
<avs-response-code-name>U</avs-response-code-name>
</processing-info>
<fraud-result-info />
</card-transaction>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<transaction-id>1035597505</transaction-id>
<soft-descriptor>BLS*DescTest</soft-descriptor>
<amount>11.00</amount>
<usd-amount>11.00</usd-amount>
<currency>USD</currency>
<transaction-approval-date>10/01/2020</transaction-approval-date>
<transaction-approval-time>13:29:06</transaction-approval-time>
<card-holder-info>
<first-name>test first name</first-name>
<last-name>test last name</last-name>
<zip>02453</zip>
</card-holder-info>
<vaulted-shopper-id>28879627</vaulted-shopper-id>
<credit-card>
<card-last-four-digits>9299</card-last-four-digits>
<card-type>VISA</card-type>
<card-sub-type>CREDIT</card-sub-type>
<card-category>PLATINUM</card-category>
<bin-category>CONSUMER</bin-category>
<card-regulated>N</card-regulated>
<issuing-bank>ALLIED IRISH BANKS PLC</issuing-bank>
<issuing-country-code>ie</issuing-country-code>
</credit-card>
<transaction-meta-data>
<meta-data>
<meta-key>stateTaxAmount</meta-key>
<meta-value>20.00</meta-value>
<meta-description>State Tax Amount</meta-description>
</meta-data>
<meta-data>
<meta-key>cityTaxAmount</meta-key>
<meta-value>20.00</meta-value>
<meta-description>City Tax Amount</meta-description>
</meta-data>
<meta-data>
<meta-key>shippingAmount</meta-key>
<meta-value>10.00</meta-value>
<meta-description>Shipping Amount</meta-description>
</meta-data>
</transaction-meta-data>
<processing-info>
<processing-status>success</processing-status>
<cvv-response-code>MA</cvv-response-code>
<authorization-code>123456</authorization-code>
<avs-response-code-zip>U</avs-response-code-zip>
<avs-response-code-address>U</avs-response-code-address>
<avs-response-code-name>U</avs-response-code-name>
</processing-info>
<fraud-result-info />
</card-transaction>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<merchant-transaction-id>3</merchant-transaction-id>
<transaction-id>1035597617</transaction-id>
<soft-descriptor>BLS*DescTest</soft-descriptor>
<amount>11.00</amount>
<usd-amount>11.00</usd-amount>
<currency>USD</currency>
<transaction-approval-date>10/01/2020</transaction-approval-date>
<transaction-approval-time>13:31:15</transaction-approval-time>
<card-holder-info>
<first-name>test first name</first-name>
<last-name>test last name</last-name>
<zip>02453</zip>
</card-holder-info>
<vaulted-shopper-id>28879643</vaulted-shopper-id>
<credit-card>
<card-last-four-digits>9299</card-last-four-digits>
<card-type>VISA</card-type>
<card-sub-type>CREDIT</card-sub-type>
<card-category>PLATINUM</card-category>
<bin-category>CONSUMER</bin-category>
<card-regulated>N</card-regulated>
<issuing-bank>ALLIED IRISH BANKS PLC</issuing-bank>
<issuing-country-code>ie</issuing-country-code>
</credit-card>
<processing-info>
<processing-status>success</processing-status>
<cvv-response-code>MA</cvv-response-code>
<authorization-code>123456</authorization-code>
<avs-response-code-zip>U</avs-response-code-zip>
<avs-response-code-address>U</avs-response-code-address>
<avs-response-code-name>U</avs-response-code-name>
</processing-info>
<fraud-result-info />
</card-transaction>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<transaction-id>1035598119</transaction-id>
<soft-descriptor>BLS*DescTest</soft-descriptor>
<amount>11.00</amount>
<usd-amount>11.00</usd-amount>
<currency>USD</currency>
<transaction-approval-date>10/01/2020</transaction-approval-date>
<transaction-approval-time>13:36:07</transaction-approval-time>
<card-holder-info>
<first-name>test first name</first-name>
<last-name>test last name</last-name>
<zip>02453</zip>
</card-holder-info>
<vaulted-shopper-id>28879661</vaulted-shopper-id>
<credit-card>
<card-last-four-digits>1111</card-last-four-digits>
<card-type>VISA</card-type>
<card-sub-type>CREDIT</card-sub-type>
<bin-category>CONSUMER</bin-category>
<card-regulated>Y</card-regulated>
<issuing-bank>JPMORGAN CHASE BANK, N.A.</issuing-bank>
<issuing-country-code>us</issuing-country-code>
</credit-card>
<processing-info>
<processing-status>success</processing-status>
<cvv-response-code>ND</cvv-response-code>
<authorization-code>654321</authorization-code>
<avs-response-code-zip>U</avs-response-code-zip>
<avs-response-code-address>U</avs-response-code-address>
<avs-response-code-name>U</avs-response-code-name>
</processing-info>
<fraud-result-info />
</card-transaction>
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<transaction-id>38486450</transaction-id>
<soft-descriptor>BLS*DescTest</soft-descriptor>
<amount>11.00</amount>
<usd-amount>11.00</usd-amount>
<currency>USD</currency>
<transaction-approval-date>10/01/2020</transaction-approval-date>
<transaction-approval-time>10:19:21</transaction-approval-time>
<vaulted-shopper-id>1234</vaulted-shopper-id>
<card-holder-info>
<first-name>test first name</first-name>
<last-name>test last name</last-name>
<zip>02453</zip>
</card-holder-info>
<credit-card>
<card-last-four-digits>9299</card-last-four-digits>
<card-type>VISA</card-type>
<card-sub-type>CREDIT</card-sub-type>
<card-category>CLASSIC</card-category>
</credit-card>
<processing-info>
<processing-status>success</processing-status>
<cvv-response-code>MA</cvv-response-code>
<avs-response-code-zip>M</avs-response-code-zip>
<avs-response-code-address>M</avs-response-code-address>
<avs-response-code-name>U</avs-response-code-name>
</processing-info>
</card-transaction>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<merchant-transaction-id>3</merchant-transaction-id>
<transaction-id>1035598409</transaction-id>
<soft-descriptor>BLS*DescTest</soft-descriptor>
<amount>11.00</amount>
<usd-amount>11.00</usd-amount>
<currency>USD</currency>
<transaction-approval-date>10/01/2020</transaction-approval-date>
<transaction-approval-time>13:45:44</transaction-approval-time>
<card-holder-info>
<merchant-shopper-id>a432567</merchant-shopper-id>
<first-name>test first name</first-name>
<last-name>test last name</last-name>
<zip>02453</zip>
</card-holder-info>
<vaulted-shopper-id>28879781</vaulted-shopper-id>
<credit-card>
<card-last-four-digits>9299</card-last-four-digits>
<card-type>VISA</card-type>
<card-sub-type>CREDIT</card-sub-type>
<card-category>PLATINUM</card-category>
<bin-category>CONSUMER</bin-category>
<card-regulated>N</card-regulated>
<issuing-bank>ALLIED IRISH BANKS PLC</issuing-bank>
<issuing-country-code>ie</issuing-country-code>
</credit-card>
<processing-info>
<processing-status>success</processing-status>
<cvv-response-code>MA</cvv-response-code>
<authorization-code>123456</authorization-code>
<avs-response-code-zip>U</avs-response-code-zip>
<avs-response-code-address>U</avs-response-code-address>
<avs-response-code-name>U</avs-response-code-name>
</processing-info>
<fraud-result-info />
</card-transaction>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<vendor-info>
<vendor-id>10398032</vendor-id>
<commission-percent>90.2</commission-percent>
</vendor-info>
<vendors-info>
<vendor-info>
<vendor-id>10398032</vendor-id>
<commission-percent>90.2</commission-percent>
</vendor-info>
</vendors-info>
<transaction-id>1035598265</transaction-id>
<soft-descriptor>BLS*DescTest</soft-descriptor>
<amount>11.00</amount>
<usd-amount>11.00</usd-amount>
<currency>USD</currency>
<transaction-approval-date>10/01/2020</transaction-approval-date>
<transaction-approval-time>13:47:33</transaction-approval-time>
<card-holder-info>
<first-name>test first name</first-name>
<last-name>test last name</last-name>
<zip>02453</zip>
</card-holder-info>
<vaulted-shopper-id>28879791</vaulted-shopper-id>
<credit-card>
<card-last-four-digits>9299</card-last-four-digits>
<card-type>VISA</card-type>
<card-sub-type>CREDIT</card-sub-type>
<card-category>PLATINUM</card-category>
<bin-category>CONSUMER</bin-category>
<card-regulated>N</card-regulated>
<issuing-bank>ALLIED IRISH BANKS PLC</issuing-bank>
<issuing-country-code>ie</issuing-country-code>
</credit-card>
<processing-info>
<processing-status>success</processing-status>
<cvv-response-code>MA</cvv-response-code>
<authorization-code>123456</authorization-code>
<avs-response-code-zip>U</avs-response-code-zip>
<avs-response-code-address>U</avs-response-code-address>
<avs-response-code-name>U</avs-response-code-name>
</processing-info>
<fraud-result-info />
</card-transaction>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<transaction-id>1035598185</transaction-id>
<soft-descriptor>BLS*DescTest</soft-descriptor>
<amount>11.00</amount>
<usd-amount>11.00</usd-amount>
<currency>USD</currency>
<transaction-approval-date>10/01/2020</transaction-approval-date>
<transaction-approval-time>13:49:24</transaction-approval-time>
<card-holder-info>
<first-name>test first name</first-name>
<last-name>test last name</last-name>
</card-holder-info>
<vaulted-shopper-id>28879799</vaulted-shopper-id>
<credit-card>
<card-last-four-digits>9424</card-last-four-digits>
<card-type>DISCOVER</card-type>
<card-sub-type>CREDIT</card-sub-type>
<card-category>PERSONAL</card-category>
<bin-category>CONSUMER</bin-category>
<card-regulated>Y</card-regulated>
<issuing-bank>DISCOVER BANK</issuing-bank>
<issuing-country-code>us</issuing-country-code>
</credit-card>
<processing-info>
<processing-status>success</processing-status>
<cvv-response-code>ND</cvv-response-code>
<authorization-code>654321</authorization-code>
<avs-response-code-zip>U</avs-response-code-zip>
<avs-response-code-address>U</avs-response-code-address>
<avs-response-code-name>U</avs-response-code-name>
</processing-info>
<fraud-result-info />
</card-transaction>
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<transaction-id>38486450</transaction-id>
<soft-descriptor>BLS*DescTest</soft-descriptor>
<amount>11.00</amount>
<usd-amount>11.00</usd-amount>
<currency>USD</currency>
<transaction-approval-date>10/01/2020</transaction-approval-date>
<transaction-approval-time>10:19:21</transaction-approval-time>
<vaulted-shopper-id>1234</vaulted-shopper-id>
<card-holder-info>
<first-name>test first name</first-name>
<last-name>test last name</last-name>
<zip>02453</zip>
</card-holder-info>
<credit-card>
<card-last-four-digits>9299</card-last-four-digits>
<card-type>VISA</card-type>
<card-sub-type>CREDIT</card-sub-type>
<card-category>CLASSIC</card-category>
</credit-card>
<processing-info>
<processing-status>success</processing-status>
<cvv-response-code>MA</cvv-response-code>
<avs-response-code-zip>M</avs-response-code-zip>
<avs-response-code-address>M</avs-response-code-address>
<avs-response-code-name>U</avs-response-code-name>
</processing-info>
</card-transaction>
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<transaction-id>38486450</transaction-id>
<soft-descriptor>BLS*DescTest</soft-descriptor>
<amount>11.00</amount>
<usd-amount>11.00</usd-amount>
<currency>USD</currency>
<transaction-approval-date>10/01/2020</transaction-approval-date>
<transaction-approval-time>10:19:21</transaction-approval-time>
<vaulted-shopper-id>1234</vaulted-shopper-id>
<card-holder-info>
<first-name>test first name</first-name>
<last-name>test last name</last-name>
<zip>02453</zip>
</card-holder-info>
<credit-card>
<card-last-four-digits>9299</card-last-four-digits>
<card-type>VISA</card-type>
<card-sub-type>CREDIT</card-sub-type>
<card-category>CLASSIC</card-category>
</credit-card>
<processing-info>
<processing-status>success</processing-status>
<cvv-response-code>MA</cvv-response-code>
<authorization-code>654321</authorization-code>
<avs-response-code-zip>M</avs-response-code-zip>
<avs-response-code-address>M</avs-response-code-address>
<avs-response-code-name>U</avs-response-code-name>
</processing-info>
</card-transaction>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<transaction-id>38646818</transaction-id>
<soft-descriptor>Test transaction</soft-descriptor>
<amount>174.8</amount>
<usd-amount>174.8</usd-amount>
<currency>USD</currency>
<avs-response-code>N</avs-response-code>
<transaction-approval-date>08/26/2020</transaction-approval-date>
<transaction-approval-time>01:17:01</transaction-approval-time>
<card-holder-info>
<first-name>test first name</first-name>
<last-name>test last name</last-name>
<zip>02453</zip>
<country>us</country>
</card-holder-info>
<vaulted-shopper-id>19671044</vaulted-shopper-id>
<credit-card>
<card-last-four-digits>9299</card-last-four-digits>
<card-type>VISA</card-type>
<card-sub-type>CREDIT</card-sub-type>
<card-category>PLATINUM</card-category>
<bin-category>CONSUMER</bin-category>
<card-regulated>N</card-regulated>
<issuing-bank>ALLIED IRISH BANKS PLC</issuing-bank>
<issuing-country-code>ie</issuing-country-code>
</credit-card>
<processing-info>
<processing-status>success</processing-status>
<cvv-response-code>NR</cvv-response-code>
<authorization-code>587327</authorization-code>
<avs-response-code-zip>N</avs-response-code-zip>
<avs-response-code-address>N</avs-response-code-address>
<avs-response-code-name>U</avs-response-code-name>
</processing-info>
<fraud-result-info>
<device-data-collector>N</device-data-collector>
</fraud-result-info>
<tax-reference>048deff0-a285-47e1-bc39-42f79bf0095b</tax-reference>
</card-transaction>
Fraud request and response examples
Request
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<soft-descriptor>DescTest</soft-descriptor>
<amount>11.00</amount>
<currency>USD</currency>
<card-holder-info>
<first-name>test first name</first-name>
<last-name>test last name</last-name>
<zip>02453</zip>
</card-holder-info>
<credit-card>
<card-number>4263982640269299</card-number>
<security-code>837</security-code>
<expiration-month>02</expiration-month>
<expiration-year>2023</expiration-year>
</credit-card>
<transaction-fraud-info>
<fraud-session-id>1234</fraud-session-id>
<shopper-ip-address>123.12.134.1</shopper-ip-address>
<customer-id>121341</customer-id>
<customer-creation-date>2021-08-05</customer-creation-date>
<company>BBBBB</company>
<fraud-products>
<fraud-product-desc>my product</fraud-product-desc>
<fraud-product-name>123RRC</fraud-product-name>
<fraud-product-price>14.5</fraud-product-price>
<fraud-product-quantity>1</fraud-product-quantity>
<fraud-product-type>Online game</fraud-product-type>
</fraud-products>
<fraud-products>
<fraud-product-desc>my product2</fraud-product-desc>
<fraud-product-name>345RRC</fraud-product-name>
<fraud-product-price>18</fraud-product-price>
<fraud-product-quantity>2</fraud-product-quantity>
<fraud-product-type>Video game</fraud-product-type>
</fraud-products>
<shipping-contact-info>
<last-name>LL</last-name>
<first-name>YY</first-name>
<country>US</country>
<state>AL</state>
<city>Juneau</city>
<address1>Address1</address1>
<address2>Address2</address2>
<zip>02453</zip>
</shipping-contact-info>
</transaction-fraud-info>
</card-transaction>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<?xml version="1.0" encoding="UTF-8"?>
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<soft-descriptor>DescTest</soft-descriptor>
<amount>11.00</amount>
<currency>USD</currency>
<card-holder-info>
<first-name>test first name</first-name>
<last-name>test last name</last-name>
<zip>02453</zip>
</card-holder-info>
<credit-card>
<card-number>4263982640269299</card-number>
<security-code>837</security-code>
<expiration-month>02</expiration-month>
<expiration-year>2023</expiration-year>
</credit-card>
<transaction-fraud-info>
<fraud-session-id>1234</fraud-session-id>
<shopper-ip-address>123.12.134.1</shopper-ip-address>
<customer-id>121341</customer-id>
<customer-creation-date>2021-08-05</customer-creation-date>
<company>BBBBB</company>
<shipping-contact-info>
<last-name>LL</last-name>
<first-name>YY</first-name>
<country>US</country>
<state>AL</state>
<city>Juneau</city>
<address1>Address1</address1>
<address2>Address2</address2>
<zip>02453</zip>
</shipping-contact-info>
<enterprise-site-id>DEFAULT</enterprise-site-id>
<enterprise-udfs>
<udf>
<udf-name>ENT_UDF1</udf-name>
<udf-value>aaa</udf-value>
</udf>
<udf>
<udf-name>ENT_UDF2</udf-name>
<udf-value>bbb</udf-value>
</udf>
</enterprise-udfs>
</transaction-fraud-info>
</card-transaction>'
Response
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<transaction-id>1035598741</transaction-id>
<soft-descriptor>BLS*DescTest</soft-descriptor>
<amount>11.00</amount>
<usd-amount>11.00</usd-amount>
<currency>USD</currency>
<transaction-approval-date>10/01/2020</transaction-approval-date>
<transaction-approval-time>13:55:58</transaction-approval-time>
<card-holder-info>
<first-name>test first name</first-name>
<last-name>test last name</last-name>
<zip>02453</zip>
</card-holder-info>
<vaulted-shopper-id>28880001</vaulted-shopper-id>
<credit-card>
<card-last-four-digits>9299</card-last-four-digits>
<card-type>VISA</card-type>
<card-sub-type>CREDIT</card-sub-type>
<card-category>PLATINUM</card-category>
<bin-category>CONSUMER</bin-category>
<card-regulated>N</card-regulated>
<issuing-bank>ALLIED IRISH BANKS PLC</issuing-bank>
<issuing-country-code>ie</issuing-country-code>
</credit-card>
<processing-info>
<processing-status>success</processing-status>
<cvv-response-code>MA</cvv-response-code>
<authorization-code>123456</authorization-code>
<avs-response-code-zip>U</avs-response-code-zip>
<avs-response-code-address>U</avs-response-code-address>
<avs-response-code-name>U</avs-response-code-name>
</processing-info>
<fraud-result-info />
</card-transaction>
Vaulted Shopper and response examples
Request
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<soft-descriptor>DescTest</soft-descriptor>
<amount>11.00</amount>
<currency>USD</currency>
<vaulted-shopper-id>20781033</vaulted-shopper-id>
</card-transaction>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<soft-descriptor>DescTest</soft-descriptor>
<amount>11.00</amount>
<currency>USD</currency>
<vaulted-shopper-id>20769005</vaulted-shopper-id>
<credit-card>
<card-last-four-digits>1111</card-last-four-digits>
<card-type>VISA</card-type>
</credit-card>
</card-transaction>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<soft-descriptor>DescTest</soft-descriptor>
<amount>11.00</amount>
<currency>USD</currency>
<vaulted-shopper-id>20769005</vaulted-shopper-id>
<credit-card>
<card-number>4012000033330026</card-number>
<security-code>111</security-code>
<expiration-month>07</expiration-month>
<expiration-year>2023</expiration-year>
</credit-card>
</card-transaction>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/xml' \
-H 'Accept: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<soft-descriptor>DescTest</soft-descriptor>
<amount>11.00</amount>
<currency>USD</currency>
<vaulted-shopper-id>20769005</vaulted-shopper-id>
<credit-card>
<card-last-four-digits>1111</card-last-four-digits>
<security-code>837</security-code>
<card-type>VISA</card-type>
</credit-card>
</card-transaction>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/xml' \
-H 'Accept: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<soft-descriptor>DescTest</soft-descriptor>
<amount>10.00</amount>
<currency>USD</currency>
<vaulted-shopper-id>29034019</vaulted-shopper-id>
<credit-card>
<card-last-four-digits>1000</card-last-four-digits>
<card-type>VISA</card-type>
<security-code-pf-token>0183117d722d8cc9921b4d5710d3394162c6d54d2b2cc1ed1f682e6c0618b7c5</security-code-pf-token>
</credit-card>
</card-transaction>'
Response
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<transaction-id>1035598587</transaction-id>
<soft-descriptor>BLS*DescTest</soft-descriptor>
<amount>11.00</amount>
<usd-amount>11.00</usd-amount>
<currency>USD</currency>
<transaction-approval-date>10/01/2020</transaction-approval-date>
<transaction-approval-time>14:00:13</transaction-approval-time>
<vaulted-shopper-id>20781033</vaulted-shopper-id>
<credit-card>
<card-last-four-digits>0026</card-last-four-digits>
<card-type>VISA</card-type>
<card-sub-type>CREDIT</card-sub-type>
<card-category>CLASSIC</card-category>
<bin-category>CONSUMER</bin-category>
<card-regulated>N</card-regulated>
<issuing-country-code>ru</issuing-country-code>
</credit-card>
<processing-info>
<processing-status>success</processing-status>
<authorization-code>654321</authorization-code>
<avs-response-code-zip>U</avs-response-code-zip>
<avs-response-code-address>U</avs-response-code-address>
<avs-response-code-name>U</avs-response-code-name>
</processing-info>
<fraud-result-info />
</card-transaction>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<transaction-id>1035598853</transaction-id>
<soft-descriptor>BLS*DescTest</soft-descriptor>
<amount>11.00</amount>
<usd-amount>11.00</usd-amount>
<currency>USD</currency>
<transaction-approval-date>10/01/2020</transaction-approval-date>
<transaction-approval-time>14:06:01</transaction-approval-time>
<vaulted-shopper-id>20769005</vaulted-shopper-id>
<credit-card>
<card-last-four-digits>1111</card-last-four-digits>
<card-type>VISA</card-type>
<card-sub-type>CREDIT</card-sub-type>
<bin-category>CONSUMER</bin-category>
<card-regulated>Y</card-regulated>
<issuing-bank>JPMORGAN CHASE BANK, N.A.</issuing-bank>
<issuing-country-code>us</issuing-country-code>
</credit-card>
<processing-info>
<processing-status>success</processing-status>
<cvv-response-code>ND</cvv-response-code>
<authorization-code>654321</authorization-code>
<avs-response-code-zip>U</avs-response-code-zip>
<avs-response-code-address>U</avs-response-code-address>
<avs-response-code-name>U</avs-response-code-name>
</processing-info>
<fraud-result-info />
</card-transaction>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<transaction-id>1035598685</transaction-id>
<soft-descriptor>BLS*DescTest</soft-descriptor>
<amount>11.00</amount>
<usd-amount>11.00</usd-amount>
<currency>USD</currency>
<transaction-approval-date>10/01/2020</transaction-approval-date>
<transaction-approval-time>14:03:27</transaction-approval-time>
<vaulted-shopper-id>20769005</vaulted-shopper-id>
<credit-card>
<card-last-four-digits>0026</card-last-four-digits>
<card-type>VISA</card-type>
<card-sub-type>CREDIT</card-sub-type>
<card-category>CLASSIC</card-category>
<bin-category>CONSUMER</bin-category>
<card-regulated>N</card-regulated>
<issuing-country-code>ru</issuing-country-code>
</credit-card>
<processing-info>
<processing-status>success</processing-status>
<cvv-response-code>ND</cvv-response-code>
<authorization-code>654321</authorization-code>
<avs-response-code-zip>U</avs-response-code-zip>
<avs-response-code-address>U</avs-response-code-address>
<avs-response-code-name>U</avs-response-code-name>
</processing-info>
<fraud-result-info />
</card-transaction>
Wallet request and response examples
Request
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<?xml version="1.0" encoding="UTF-8"?>
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<amount>11.00</amount>
<currency>USD</currency>
<wallet-id>21</wallet-id>
</card-transaction>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/xml' \
-H 'Accept: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<soft-descriptor>DescTest</soft-descriptor>
<amount>11.00</amount>
<currency>USD</currency>
<wallet>
<wallet-type>APPLE_PAY</wallet-type>
<encoded-payment-token>ImRhdGEiOiJuY1AvRitIUy8zeG5bXhCMFd</encoded-payment-token>
</wallet>
</card-transaction>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/xml' \
-H 'Accept: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<soft-descriptor>DescTest</soft-descriptor>
<amount>11.00</amount>
<currency>USD</currency>
<wallet>
<wallet-type>GOOGLE_PAY</wallet-type>
<encoded-payment-token>eyJwYXltZW50TWV0aG9kVG9rZW4iOnsidG99</encoded-payment-token>
</wallet>
</card-transaction>'
Response
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<transaction-id>1011702615</transaction-id>
<amount>11.00</amount>
<usd-amount>11.00</usd-amount>
<currency>USD</currency>
<transaction-approval-date>10/01/2020</transaction-approval-date>
<transaction-approval-time>10:19:21</transaction-approval-time>
<vaulted-shopper-id>123</vaulted-shopper-id>
<card-holder-info>
<first-name>test first name</first-name>
<last-name>test last name</last-name>
</card-holder-info>
<credit-card>
<card-last-four-digits>9299</card-last-four-digits>
<card-type>VISA</card-type>
<card-sub-type>CREDIT</card-sub-type>
<card-category>CLASSIC</card-category>
</credit-card>
<processing-info>
<processing-status>success</processing-status>
<cvv-response-code>NC</cvv-response-code>
</processing-info>
</card-transaction>
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<transaction-id>38486450</transaction-id>
<soft-descriptor>BLS*DescTest</soft-descriptor>
<amount>11.00</amount>
<usd-amount>11.00</usd-amount>
<currency>USD</currency>
<transaction-approval-date>10/01/2020</transaction-approval-date>
<transaction-approval-time>10:19:21</transaction-approval-time>
<vaulted-shopper-id>1234</vaulted-shopper-id>
<wallet>
<billing-contact-info>
<first-name>John</first-name>
<last-name>Doe</last-name>
<address1>South St</address1>
<city>Waltham</city>
<state>MA</state>
<zip>02453</zip>
</billing-contact-info>
<tokenized-card>
<dpan-expiration-month>7</dpan-expiration-month>
<dpan-expiration-year>2019</dpan-expiration-year>
<dpan-last-four-digits>0010</dpan-last-four-digits>
<card-last-four-digits>1471</card-last-four-digits>
<card-type>MASTERCARD</card-type>
<card-sub-type>DEBIT</card-sub-type>
<bin-category>CONSUMER</bin-category>
<card-regulated>N</card-regulated>
<issuing-country-code>us</issuing-country-code>
</tokenized-card>
</wallet>
<processing-info>
<processing-status>success</processing-status>
<cvv-response-code>MA</cvv-response-code>
<avs-response-code-zip>M</avs-response-code-zip>
<avs-response-code-address>M</avs-response-code-address>
<avs-response-code-name>U</avs-response-code-name>
</processing-info>
</card-transaction>
<card-transaction>
<amount>11.00</amount>
<usd-amount>11.00</usd-amount>
<currency>USD</currency>
<transaction-approval-date>10/01/2020</transaction-approval-date>
<transaction-approval-time>10:19:21</transaction-approval-time>
<cardHolderInfo>
<firstName>test first name</firstName>
<lastName>test last name</lastName>
<zip>02453</zip>
</cardHolderInfo>
<cardTransactionType>AUTH_CAPTURE</cardTransactionType>
<creditCard>
<cardCategory>CLASSIC</cardCategory>
<cardLastFourDigits>9299</cardLastFourDigits>
<cardSubType>CREDIT</cardSubType>
<cardType>VISA</cardType>
</creditCard>
<processingInfo>
<processingStatus>success</processingStatus>
</processingInfo>
<softDescriptor>BLS&#x2a;DescTest</softDescriptor>
<transactionId>1012751937</transactionId>
<vaultedShopperId>21289371</vaultedShopperId>
</card-transaction>
<card-transaction>
<amount>11.00</amount>
<usd-amount>11.00</usd-amount>
<currency>USD</currency>
<transaction-approval-date>10/01/2020</transaction-approval-date>
<transaction-approval-time>10:19:21</transaction-approval-time>
<cardHolderInfo>
<country>us</country>
<firstName>test first name</firstName>
<lastName>test last name</lastName>
<zip>02453</zip>
</cardHolderInfo>
<cardTransactionType>AUTH_CAPTURE</cardTransactionType>
<processingInfo>
<processingStatus>success</processingStatus>
</processingInfo>
<softDescriptor>BLS&#x2a;DescTest</softDescriptor>
<transactionId>1012751937</transactionId>
<vaultedShopperId>21289371</vaultedShopperId>
<wallet>
<billingContactInfo>
<country>us</country>
<firstName>test first name</firstName>
<lastName>test last name</lastName>
<zip>02453</zip>
</billingContactInfo>
<tokenizedCard>
<cardLastFourDigits>1111</cardLastFourDigits>
<cardSubType>CREDIT</cardSubType>
<cardType>VISA</cardType>
<dpanExpirationMonth>9</dpanExpirationMonth>
<dpanExpirationYear>2025</dpanExpirationYear>
<dpanLastFourDigits>2222</dpanLastFourDigits>
</tokenizedCard>
<walletType>GOOGLE_PAY</walletType>
</wallet>
</card-transaction>
3-D Secure and response examples
Request
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/xml' \
-H 'Accept: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<soft-descriptor>DescTest</soft-descriptor>
<amount>11.00</amount>
<currency>USD</currency>
<transaction-initiator>SHOPPER</transaction-initiator>
<card-holder-info>
<first-name>John</first-name>
<last-name>Blue</last-name>
</card-holder-info>
<pf-token>543dfc6143d0fdaf7a2c9ddb8f2e8bb13902e1aad6fe36f7fd2ea9654655ca09_</pf-token>
</card-transaction>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/xml' \
-H 'Accept: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<soft-descriptor>DescTest</soft-descriptor>
<amount>11.00</amount>
<currency>USD</currency>
<transaction-initiator>MERCHANT</transaction-initiator>
<vaulted-shopper-id>19574642</vaulted-shopper-id>
<network-transaction-info>
<original-network-transaction-id>019072416233566</original-network-transaction-id>
</network-transaction-info>
</card-transaction>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/xml' \
-H 'Accept: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<soft-descriptor>DescTest</soft-descriptor>
<amount>11.00</amount>
<currency>USD</currency>
<transaction-initiator>MERCHANT</transaction-initiator>
<card-holder-info>
<first-name>John</first-name>
<last-name>Blue</last-name>
</card-holder-info>
<credit-card>
<card-number>4111 1111 1111 1111</card-number>
<security-code>111</security-code>
<expiration-month>07</expiration-month>
<expiration-year>2023</expiration-year>
</credit-card>
<network-transaction-info>
<original-network-transaction-id>019072416233566</original-network-transaction-id>
</network-transaction-info>
</card-transaction>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/xml' \
-H 'Accept: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<soft-descriptor>DescTest</soft-descriptor>
<amount>11.00</amount>
<currency>USD</currency>
<vaulted-shopper-id>19574268</vaulted-shopper-id>
<credit-card>
<card-last-four-digits>1111</card-last-four-digits>
<card-type>VISA</card-type>
</credit-card>
<three-d-secure>
<three-d-secure-reference-id>5303</three-d-secure-reference-id>
</three-d-secure>
</card-transaction>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/xml' \
-H 'Accept: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<soft-descriptor>DescTest</soft-descriptor>
<amount>11.00</amount>
<currency>USD</currency>
<card-holder-info>
<first-name>John</first-name>
<last-name>Blue</last-name>
</card-holder-info>
<credit-card>
<card-number>4111 1111 1111 1111</card-number>
<security-code>111</security-code>
<expiration-month>07</expiration-month>
<expiration-year>2022</expiration-year>
</credit-card>
<three-d-secure>
<three-d-secure-reference-id>4813</three-d-secure-reference-id>
</three-d-secure>
</card-transaction>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/transactions \
-H 'Content-Type: application/xml' \
-H 'Accept: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<soft-descriptor>DescTest</soft-descriptor>
<amount>11.00</amount>
<currency>USD</currency>
<card-holder-info>
<first-name>test first name</first-name>
<last-name>test last name</last-name>
<zip>02453</zip>
</card-holder-info>
<credit-card>
<card-number>4111 1111 1111 1111</card-number>
<security-code>111</security-code>
<expiration-month>07</expiration-month>
<expiration-year>2022</expiration-year>
</credit-card>
<three-d-secure>
<eci>05</eci>
<cavv>AAABAWFlmQAAAABjRWWZEEFgFz+A</cavv>
<xid>MGpHWm5ZWVpKclo0aUk0VmltVDA=</xid>
<ds-transaction-id>e08da266-b58d-45c9-a1f8-570b7fb80e30</ds-transaction-id>
<three-d-secure-version>2.1.0</three-d-secure-version>
</three-d-secure>
</card-transaction>'
Response
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<transaction-id>38510986</transaction-id>
<soft-descriptor>BLS*DescTest</soft-descriptor>
<amount>11.00</amount>
<usd-amount>11.00</usd-amount>
<currency>USD</currency>
<transaction-approval-date>10/01/2020</transaction-approval-date>
<transaction-approval-time>10:19:21</transaction-approval-time>
<avs-response-code>G</avs-response-code>
<card-holder-info>
<first-name>John</first-name>
<last-name>Blue</last-name>
</card-holder-info>
<vaulted-shopper-id>19574642</vaulted-shopper-id>
<credit-card>
<card-last-four-digits>1000</card-last-four-digits>
<card-type>VISA</card-type>
<card-sub-type>CREDIT</card-sub-type>
<bin-category>CONSUMER</bin-category>
<issuing-country-code>us</issuing-country-code>
</credit-card>
<three-d-secure>
<authentication-result>AUTHENTICATION_SUCCEEDED</authentication-result>
</three-d-secure>
<network-transaction-info>
<original-network-transaction-id>019072416233566</original-network-transaction-id>
<network-transaction-id>019072416255266</network-transaction-id>
</network-transaction-info>
<processing-info>
<processing-status>success</processing-status>
<cvv-response-code>NR</cvv-response-code>
<avs-response-code-zip>U</avs-response-code-zip>
<avs-response-code-address>U</avs-response-code-address>
<avs-response-code-name>U</avs-response-code-name>
<network-transaction-id>019072416233566</network-transaction-id>
</processing-info>
</card-transaction>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<transaction-id>38510988</transaction-id>
<soft-descriptor>BLS*DescTest</soft-descriptor>
<amount>11.00</amount>
<usd-amount>11.00</usd-amount>
<currency>USD</currency>
<transaction-approval-date>10/01/2020</transaction-approval-date>
<transaction-approval-time>10:19:21</transaction-approval-time>
<avs-response-code>G</avs-response-code>
<vaulted-shopper-id>19574642</vaulted-shopper-id>
<credit-card>
<card-last-four-digits>1000</card-last-four-digits>
<card-type>VISA</card-type>
<card-sub-type>CREDIT</card-sub-type>
<bin-category>CONSUMER</bin-category>
<issuing-country-code>us</issuing-country-code>
</credit-card>
<network-transaction-info>
<original-network-transaction-id>019072416233566</original-network-transaction-id>
<network-transaction-id>019072416255266</network-transaction-id>
</network-transaction-info>
<processing-info>
<processing-status>success</processing-status>
<cvv-response-code>ND</cvv-response-code>
<avs-response-code-zip>U</avs-response-code-zip>
<avs-response-code-address>U</avs-response-code-address>
<avs-response-code-name>U</avs-response-code-name>
<network-transaction-id>019072416255266</network-transaction-id>
</processing-info>
<fraud-result-info>
<device-data-collector>N</device-data-collector>
</fraud-result-info>
</card-transaction>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<transaction-id>38511272</transaction-id>
<soft-descriptor>BLS*DescTest</soft-descriptor>
<amount>11.00</amount>
<usd-amount>11.00</usd-amount>
<currency>USD</currency>
<transaction-approval-date>10/01/2020</transaction-approval-date>
<transaction-approval-time>10:19:21</transaction-approval-time>
<avs-response-code>G</avs-response-code>
<card-holder-info>
<first-name>John</first-name>
<last-name>Blue</last-name>
</card-holder-info>
<vaulted-shopper-id>19574798</vaulted-shopper-id>
<credit-card>
<card-last-four-digits>1111</card-last-four-digits>
<card-type>VISA</card-type>
<card-sub-type>CREDIT</card-sub-type>
<bin-category>CONSUMER</bin-category>
<issuing-bank>JPMORGAN CHASE BANK, N.A.</issuing-bank>
<issuing-country-code>us</issuing-country-code>
</credit-card>
<network-transaction-info>
<original-network-transaction-id>019072416233566</original-network-transaction-id>
<network-transaction-id>019072416255266</network-transaction-id>
</network-transaction-info>
<transaction-order-source>MOTO</transaction-order-source>
<processing-info>
<processing-status>success</processing-status>
<cvv-response-code>MA</cvv-response-code>
<avs-response-code-zip>U</avs-response-code-zip>
<avs-response-code-address>U</avs-response-code-address>
<avs-response-code-name>U</avs-response-code-name>
<network-transaction-id>759211611101833</network-transaction-id>
</processing-info>
<fraud-result-info>
<device-data-collector>N</device-data-collector>
</fraud-result-info>
</card-transaction>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<transaction-id>38510952</transaction-id>
<soft-descriptor>BLS*DescTest</soft-descriptor>
<amount>11.00</amount>
<usd-amount>11.00</usd-amount>
<currency>USD</currency>
<transaction-approval-date>10/01/2020</transaction-approval-date>
<transaction-approval-time>10:19:21</transaction-approval-time>
<avs-response-code>G</avs-response-code>
<card-holder-info>
<first-name>John</first-name>
<last-name>Blue</last-name>
</card-holder-info>
<vaulted-shopper-id>19574618</vaulted-shopper-id>
<credit-card>
<card-last-four-digits>1111</card-last-four-digits>
<card-type>VISA</card-type>
<card-sub-type>CREDIT</card-sub-type>
<bin-category>CONSUMER</bin-category>
<issuing-bank>JPMORGAN CHASE BANK, N.A.</issuing-bank>
<issuing-country-code>us</issuing-country-code>
</credit-card>
<three-d-secure>
<authentication-result>AUTHENTICATION_SUCCEEDED</authentication-result>
</three-d-secure>
<network-transaction-info>
<original-network-transaction-id>019072416233566</original-network-transaction-id>
<network-transaction-id>019072416255266</network-transaction-id>
</network-transaction-info>
<processing-info>
<processing-status>success</processing-status>
<cvv-response-code>MA</cvv-response-code>
<avs-response-code-zip>U</avs-response-code-zip>
<avs-response-code-address>U</avs-response-code-address>
<avs-response-code-name>U</avs-response-code-name>
<network-transaction-id>759205706264329</network-transaction-id>
</processing-info>
<fraud-result-info>
<device-data-collector>N</device-data-collector>
</fraud-result-info>
</card-transaction>
Example Descriptions
Basic
Auth Capture with metadata
To send metadata for the transaction, you'll need to include the transaction-meta-data
property within the card-transaction resource in your request. You can include up to 20 metadata key-value pairs in each transaction-meta-data property.
Above is an example of a request with metadata, including state tax, city tax, and the shipping amount.
Auth Capture with Merchant Transaction ID
You may wish to assign your own ID to each transaction, for example in order to track the transactions in your own internal systems. To do this, you'll need to include the merchant-transaction-id
property within the card-transaction resource in your request.
Above is an example of a request that includes a Merchant Transaction ID (MTI), along with the minimum required fields for a one-time payment using a credit card.
Auth Capture with encrypted credit card
Your PCI compliance requirements and API permission level may require that you send credit card data in encrypted format only. To do this, you'll need to include theencrypted-card-number
and encrypted-security-code
properties within the card-transaction resource in your request.
Above is an example of a request with an encrypted credit card number.
Auth Capture with Hosted Payment Fields token
If you are using BlueSnap's Hosted Payment Fields, you can process the shopper's payment using the information from the Hosted Payment Fields by including the token within the pf-token
property in your request.
Above is an example of a request with the Hosted Payment Fields token.
Note that the response will look like a regular response for a credit card, with the card's last four digits and card type.
Auth Capture with Merchant Shopper ID
You may wish to assign your own Shopper ID to each transaction, for example in order to track the transactions in your own internal systems. To do this, you'll need to include the merchant-shopper-id
property within the cardTransaction resource.
Above is an example of a request that includes a Merchant Shopper ID, along with the minimum required fields for a one-time payment using a credit card.
Auth Capture with Vendors Info
This example shows an Auth Capture request within a marketplace. If you are a Marketplace Merchant, you will include vendors-info
in the request to process a transaction involving one or more vendors. For more details, refer to the Marketplace Guide.
Auth Capture with store card approval
This example shows an Auth Capture request with the store-card
value set. You will want to use this value to define if the shopper has approved storing their credit card information for future use. The default value is set to true. If set to false, the credit card data will not be stored.
Auth Capture with Embedded Checkout token
If you are using BlueSnap's Embedded Checkout, you can process the shopper's payment using the information from the Embedded Payment Form by including the token within the pf-token
property in your request.
Above is an example of a request with the Embedded Checkout token.
Note that the response will look like a regular response for a credit card, with the card's last four digits and card type.
Auth Capture with tax quote
This example shows an Auth Capture request with the tax-reference
property set. You will use this property if you have implemented BlueSnap's tax feature and want to process transactions including tax. First, you will need to map your products to tax codes. Then as part of the checkout process, you will create a tax quote for a transaction, which will return total tax and the tax quote reference number. As part of Auth Capture, you will send the tax quote reference number in tax-reference
and total transaction amount, including tax, in amount
.
Fraud Examples
Auth Capture with fraud info
This example shows a basic Auth Capture request, containing the minimum required fields for a one-time payment using a credit card. It includes the required fraud info in the transaction-fraud-info
property within the card-transaction resource in your request. Refer to transaction-fraud-info.
An additional example with the Complete-level fraud info (formerly Enterprise-level) is included above. Complete fraud info is supported only for merchants who have signed up for the Complete-level fraud service from BlueSnap. Refer to Fraud prevention.
Vaulted Shopper Examples
Auth Capture with vaulted shopper
To perform an Auth Capture request with an existing vaulted shopper, you'll need to include the vaulted-shopper-id
property within the card-transaction resource in your request. When specifying a credit card for a vaulted shopper, you must include the card-last-four-digits
and card-type
properties within the credit-card resource.
Above are two vaulted shopper examples. The first is with a vaulted shopper who only has one credit card, so there is no need to specify which credit card to charge. The second is with a vaulted shopper who has multiple cards, so the request must indicate which card to charge.
Auth Capture with vaulted shopper & CVV
You may wish to collect CVV on your checkout form from all your shoppers – even from returning shoppers. One reason you might choose to do this is that transactions with CVV generally result in higher success rates.
Above is an example of sending CVV in a transaction request involving a returning shopper.
Include vaulted-shopper-id
and CVV in the request as in the example.
Auth Capture with vaulted shopper & new card
This example shows an Auth Only request with a vaulted shopper and a new card. If you include vaulted-shopper-id
and a new card in the request, the shopper's card will be charged and the card details will be added to the shopper.
Auth Capture with vaulted shopper & tokenized CVV
This example shows an Auth Capture request with a vaulted shopper and a tokenized CVV. You may wish to collect CVV on your checkout form for returning shoppers since transactions with CVV generally result in higher success rates. See the Hosted Payment Fields guide for details on how to tokenize card data.
Wallet Examples
Auth Capture with wallet ID
If the shopper is paying via Masterpass or Visa Checkout, you can include the wallet-id
in the request. For details, refer to:
Above is an example of a request with a Masterpass wallet.
Note
When you include the wallet ID in the request, a vaulted shopper will be automatically created and the vaulted shopper ID will be returned to you in the response.
If you prefer to save the wallet information in an existing shopper, it is recommended to instead send a Create Vaulted Shopper request with the wallet ID and then use that vaulted shopper in your Auth Capture request.
Auth Capture with Apple Pay
This example shows an Auth Capture request with Apple Pay. In the request, include wallet-type
= APPLE_PAY and encoded-payment-token
inside wallet
. Instructions on how to extract the encoded-payment-token
can be found in the Apple Pay Guide.
Note: To test Apple Pay, follow the steps in the Apple Pay Guide. The API Explorer does not support Apple Pay testing.
Auth Capture with Google Pay
This example shows an Auth Capture request with Google Pay. In the request, include wallet-type
= GOOGLE_PAY and encoded-payment-token
inside wallet
. Instructions on how to extract the encoded-payment-token
can be found in the Google Pay Guide.
3-D Secure Examples
3DS with shopper-initiated transaction
The request includes "transaction-initiator":"SHOPPER"
to indicate that this is a Customer-Initiated Transaction. The response includes the same network-transaction-id
in both the network-transaction-info
and the processing-info
sections. The merchant keeps this network-transaction-id
for future transactions.
3DS with MIT
The request includes "transaction-initiator":"MERCHANT"
to indicate that this is a Merchant-Initiated Transaction. The merchant also includes the original-network-transaction-id
to link the transaction to an existing transaction on which SCA was performed so SCA does not need to be performed again. In the network-transaction-info
section, the response includes both the original-network-transaction-id
and the new network-transaction-id
. The merchant continues using the original-network-transaction-id
for future transactions.
Returning shopper with 3DS
This request specifies the vaulted-shopper-id
, the card details rather than the token, and includes the three-d-secure-reference-id
to link everything together. The three-d-secure-reference-id
comes from sdkResponse.threeDSecure.threeDSecureReferenceId
in the callback of bluesnap.threeDsPaymentsSetup
. For more information, refer to the 3-D Secure for API Guide.
With MOTO and NTI
This request specifies the "transaction-order-source":"MOTO"
indicating that this is a MOTO transaction. The response includes the same network-transaction-id
in both the network-transaction-info
and the processing-info
sections. The merchant keeps this network-transaction-id
for future transactions. For more information, refer to the 3-D Secure for API Guide.
Full card details with 3DS ID
This example is for merchants using our 3DS plain text solution.
3DS with External MPI
The request includes the threeDSecure
object to provide the necessary 3-D Secure data from the external Merchant Plug-In (MPI).
Back to Top
API Explorer
To test out a call, enter the XML portion of the request below and then click Try it!
Tip:
Copy the XML portion from one of the example requests above, or use the XML code below as a starting point. You can enter different parameters and test credit card numbers to see how your test scenario would work. The request headers, including authorization, are already built in for you in this test area, so you should not include them here.
<card-transaction xmlns="http://ws.plimus.com">
<card-transaction-type>AUTH_CAPTURE</card-transaction-type>
<soft-descriptor>DescTest</soft-descriptor>
<amount>11.00</amount>
<currency>USD</currency>
<card-holder-info>
<first-name>test first name</first-name>
<last-name>test last name</last-name>
<zip>02453</zip>
</card-holder-info>
<credit-card>
<card-number>4263982640269299</card-number>
<security-code>837</security-code>
<expiration-month>02</expiration-month>
<expiration-year>2023</expiration-year>
</credit-card>
</card-transaction>