{"_id":"59bc55d82b480b0010010cc3","category":{"_id":"59bc55d72b480b0010010c99","version":"59bc55d72b480b0010010c92","project":"57336fd5a6a9c40e00e13a0b","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-11-03T20:45:01.593Z","from_sync":false,"order":7,"slug":"topics","title":"Guides"},"parentDoc":null,"project":"57336fd5a6a9c40e00e13a0b","user":"560d5913af97231900938124","version":{"_id":"59bc55d72b480b0010010c92","project":"57336fd5a6a9c40e00e13a0b","__v":2,"createdAt":"2017-09-15T22:36:07.078Z","releaseDate":"2017-09-15T22:36:07.078Z","categories":["59bc55d72b480b0010010c93","59bc55d72b480b0010010c94","59bc55d72b480b0010010c95","59bc55d72b480b0010010c96","59bc55d72b480b0010010c97","59bc55d72b480b0010010c98","59bc55d72b480b0010010c99","59cd3e7c210d1900326834b1"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"3.22.2 Release","version_clean":"8976.0.0-Basics","version":"8976-Basics"},"__v":0,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-10-07T16:15:37.922Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":8,"body":"BlueSnap supports a variety of international and local credit cards in Latin America (LatAm), so you can increase conversions in these markets. This section will outline which international and local credit cards are supported, and the specific requirements for your BlueSnap integration. \n\n##Supported Countries and Cards\n###International credit cards \nThe following international credit cards are supported:\n\n* American Express (Amex) \n* Diners \n* Discover \n* JCB in select countries (consult with implementation for details)\n* MasterCard \n* Visa\n\n###Local credit cards \nLocal credit card processing is available for transactions in Argentina, Brazil, Chile, Colombia, and Mexico. The following list outlines the supported local cards per country. \n\n* **Argentina** –  Amex, Argencard, Cabal, Cencosud, Diners, MasterCard, Nativa, Tarjeta Naranja, Tarjeta Shopping, Visa\n* **Brazil** – Amex, Cartão MercadoLivr, Diners, Discover, ELO, Hipercard, JCB, MasterCard, Visa\n* **Chile** – Amex, Diners, MasterCard, Visa\n* **Colombia** – Amex, Diners, MasterCard, Visa \n* **Mexico** – Amex, MasterCard, Visa\n\n##Benefits\n\nBenefits of local processing include the ability to lower costs by eliminating pass through tax charges, processing in local currency, reducing checkout friction, and increasing payment conversion rates.\n\nLocal processing in these countries is available with any BlueSnap integration, and your business does not have to be located in LatAm. Simply contact [merchants:::at:::bluesnap.com](mailto:merchants@bluesnap.com) to have it enabled.\n\n##Required Information for API Integrations\nIn order for transactions to be processed locally, you must collect the following information from your shopper and send it to BlueSnap with each transaction:\n\n  * Shopper email address\n  * Local personal identification number\n  * CVV (Argentina and Chile only)\n\nIf you do not provide these fields, then the transaction may be processed internationally at a higher cost.\n###Local personal identification number\nLocal LatAm processing requires that the shopper provide their local personal identification number. These are the required ID types per country:\n\n  * Argentina - DNI\n  * Brazil - CPF/CNPJ\n  * Chile - RUN\n  * Colombia - CC\n  * Mexico - CURP/RFC\n\n###CVV Requirements & Recurring Payments\nRecurring payments are automatically processed without the CVV, since the shopper only enters this information during the first transaction. In certain LatAm countries, the local acquirers require the CVV for every transaction, meaning that recurring payments in these countries will need to be processed through our international acquirers. \n\n:fa-arrow-circle-right: Recurring payments in Brazil, Mexico, and Colombia will be processed locally, since the acquirers in these countries do support recurring payments without the CVV. \n\n:fa-arrow-circle-right: Recurring payments in Argentina and Chile will be processed internationally, since the acquirers in these countries do not support payments without the CVV. \n\n###Expired Cards \nIf you’re using BlueSnap’s subscription engine, a [Subscription Charge Failure IPN](https://support.bluesnap.com/docs/on-demand-ipns#section-subscription_charge_failure) will be sent when a charge fails due to an expired card. We recommend taking the following steps to ensure the next charge is successful. Note that [Account Updater](https://support.bluesnap.com/docs/account-updater) is not supported for LatAm countries at this time.\n\n1. Reach out to the shopper requesting updated card information. \n2. Update the shopper's payment information via relevant API calls: \n  * **Payment API**:  [Update vaulted shopper](https://developers.bluesnap.com/v2.1/docs/update-vaulted-shopper) and [subscription](https://developers.bluesnap.com/v2.1/docs/update-subscription)\n  * **Extended Payment API**: [Update shopper](https://developers.bluesnap.com/v3.0/docs/update-shopper) and [subscription](https://developers.bluesnap.com/v3.0/docs/update-subscription) \n\n##Returning shoppers\nVaulted shoppers are fully supported for Brazil, Colombia, and Mexico, so you can use the same returning shopper flow that you do normally.\n\nFor Argentina and Chile, the CVV is required to process each purchase. Since BlueSnap does not store the CVV, you must collect the CVV on your checkout form and send it in with each transaction. If you do not send in the CVV, then the transaction may be processed internationally at a higher cost. \n<span></span>\n[block:callout]\n{\n  \"type\": \"success\",\n  \"title\": \"Capturing CVV during checkout\",\n  \"body\": \"We recommend capturing the returning shopper’s CVV during checkout and including this value within the transaction request to BlueSnap. \\n\\nFor examples, see:\\n\\n**Payment API** → [Auth Capture](/v2.1/docs/auth-capture#section-request-examples) or [Auth Only](/v2.1/docs/auth-only#section-examples)\\n\\n**Extended Payment API** → [Create Order](/v3.0/docs/create-order#section-examples) or [Create Shopping Context](/v3.0/docs/create-shopping-context#section-examples)\"\n}\n[/block]\n##Separate Auth and Capture\nThe separation of Auth and Capture is supported for Brazil and Mexico.\n\nFor Argentina, Chile and Colombia, you are required to perform the Auth and Capture at once to use local processing. If you use separate Auth and Capture requests in these countries, then the transaction may be processed internationally at a higher cost.\n\n##Example requests\n<br />\n[block:html]\n{\n  \"html\": \"<ul class=\\\"nav nav-tabs\\\">\\n  <li class=\\\"active\\\"><a data-toggle=\\\"tab\\\" href=\\\"#papiMenu\\\">Payment API</a></li>\\n  <li><a data-toggle=\\\"tab\\\" href=\\\"#extended\\\">Extended Payment API</a></li>\\n</ul>\\n\\n<div class=\\\"tab-content\\\">\\n  <div id=\\\"papiMenu\\\" class=\\\"tab-pane fade in active\\\">\"\n}\n[/block]\n<br />\nHere are examples of the [Create Card Transaction](/v2.1/docs/auth-capture) and [Create Vaulted Shopper](/v2.1/docs/create-vaulted-shopper) requests with these required fields in the Payment API:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n    \\\"amount\\\": 11,\\n    \\\"recurringTransaction\\\": \\\"ECOMMERCE\\\",\\n    \\\"softDescriptor\\\": \\\"MyDescriptor\\\",\\n    \\\"cardHolderInfo\\\": {\\n        \\\"country\\\": \\\"BR\\\",\\n        \\\"firstName\\\": \\\"test first name\\\",\\n        \\\"lastName\\\": \\\"test last name\\\",\\n        \\\"personalIdentificationNumber\\\": \\\"11.111.111/0001-10\\\",\\n        \\\"email\\\": \\\"test@email.com\\\"\\n    },\\n    \\\"currency\\\": \\\"BRL\\\",\\n    \\\"creditCard\\\": {\\n        \\\"expirationYear\\\": 2019,\\n        \\\"securityCode\\\": 111,\\n        \\\"expirationMonth\\\": \\\"07\\\",\\n        \\\"cardNumber\\\": 4111111111111111\\n    },\\n    \\\"cardTransactionType\\\": \\\"AUTH_CAPTURE\\\"\\n}\",\n      \"language\": \"json\",\n      \"name\": \"Create Card Transaction with LatAm required fields - Payment API\"\n    },\n    {\n      \"code\": \"{\\n    \\\"zip\\\": 12345,\\n    \\\"country\\\": \\\"mx\\\",\\n    \\\"paymentSources\\\": {\\\"creditCardInfo\\\": [{\\\"creditCard\\\": {\\n        \\\"expirationYear\\\": 2019,\\n        \\\"securityCode\\\": 111,\\n        \\\"expirationMonth\\\": \\\"07\\\",\\n        \\\"cardNumber\\\": 4111111111111111\\n    }}]},\\n    \\\"firstName\\\": \\\"FirstName\\\",\\n    \\\"lastName\\\": \\\"LastName\\\",\\n    \\\"phone\\\": 1234567890,\\n    \\\"personalIdentificationNumber\\\": \\\"11.111.111/0001-10\\\",\\n    \\\"email\\\": \\\"test@email.com\\\"\\n}\",\n      \"language\": \"json\",\n      \"name\": \"Create Vaulted Shopper with LatAm required fields - Payment API\"\n    }\n  ]\n}\n[/block]\n\n[block:html]\n{\n  \"html\": \" </div>\\n <div id=\\\"extended\\\" class=\\\"tab-pane fade\\\">\"\n}\n[/block]\n<br />\nHere are examples of [Create Shopper](/v3.0/docs/create-shopper) and [Create Order and Shopper](/v3.0/docs/create-shopper-and-order) requests with the required fields in the Extended Payment API\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<shopper xmlns=\\\"http://ws.plimus.com\\\">\\n  <web-info>\\n    <ip>62.219.121.253</ip>\\n    <remote-host>www.merchant.com</remote-host>\\n    <user-agent>Mozilla/5.0 (Linux; X11)</user-agent>\\n  </web-info>\\n  <shopper-info>\\n    <shopper-currency>BRL</shopper-currency>\\n    <store-id>4677</store-id>\\n    <locale>en</locale>\\n    <shopper-contact-info>\\n      <title>Mr</title>\\n      <first-name>John</first-name>\\n      <last-name>Doe</last-name>\\n      <email>jdoe@johndoeandsons.com</email>\\n      <company-name>JohnDoeAndSons</company-name>\\n      <address1>138 Market St</address1>\\n      <city>Rio de Janeiro</city>\\n      <zip>01000-000</zip>\\n      <country>BR</country>\\n      <phone>14135556789</phone>\\n      <personal-identification-number>11.111.111/0001-10</personal-identification-number>\\n    </shopper-contact-info>\\n\\t<payment-info>\\n      <credit-cards-info>\\n        <credit-card-info>\\n          <billing-contact-info>\\n            <first-name>John</first-name>\\n            <last-name>Doe</last-name>\\n            <address1>138 Market St</address1>\\n            <city>Rio de Janeiro</city>\\n            <zip>01000-000</zip>\\n            <country>BR</country>\\n          </billing-contact-info>\\n          <credit-card>\\n            <card-number>4111 1111 1111 1111</card-number>\\n            <security-code>123</security-code>\\n            <card-type>VISA</card-type>\\n            <expiration-month>09</expiration-month>\\n            <expiration-year>2019</expiration-year>\\n          </credit-card>\\n        </credit-card-info>\\n      </credit-cards-info>\\n    </payment-info>\\n  </shopper-info>\\n</shopper>\",\n      \"language\": \"xml\",\n      \"name\": \"Create Shopper with LatAm required fields\"\n    },\n    {\n      \"code\": \"<batch-order xmlns=\\\"http://ws.plimus.com\\\">\\n  <shopper>\\n    <web-info>\\n      <ip>62.219.121.253</ip>\\n      <remote-host>www.merchant.com</remote-host>\\n      <user-agent>Mozilla/5.0 (Linux; X11)</user-agent>\\n    </web-info>\\n    <shopper-info>\\n      <store-id>10540</store-id>\\n      <locale>en</locale>\\n      <shopper-contact-info>\\n        <title>Mr</title>\\n        <first-name>John</first-name>\\n        <last-name>Doe</last-name>\\n        <email>jdoe@johndoeandsons.com</email>\\n        <company-name>JohnDoeAndSons</company-name>\\n        <address1>138 Market St</address1>\\n        <city>Rio de Janeiro</city>\\n        <zip>01000-000/zip>\\n        <country>BR</country>\\n        <phone>14135556789</phone>\\n        <personal-identification-number>11.111.111/0001-10</personal-identification-number>\\n      </shopper-contact-info>\\n      <payment-info>\\n        <credit-cards-info>\\n          <credit-card-info>\\n            <billing-contact-info>\\n              <first-name>John</first-name>\\n              <last-name>Doe</last-name>\\n              <address1>138 Market St</address1>\\n              <city>Rio de Janeiro</city>\\n              <zip>01000-000</zip>\\n              <country>BR</country>\\n            </billing-contact-info>\\n            <credit-card>\\n              <card-number>4111 1111 1111 1111</card-number>\\n              <security-code>123</security-code>\\n              <card-type>VISA</card-type>\\n              <expiration-month>09</expiration-month>\\n              <expiration-year>2019</expiration-year>\\n            </credit-card>\\n          </credit-card-info>\\n        </credit-cards-info>\\n      </payment-info>\\n    </shopper-info>\\n  </shopper>\\n  <order>\\n    <ordering-shopper>\\n      <web-info>\\n        <ip>62.219.121.253</ip>\\n        <remote-host>www.merchant.com</remote-host>\\n        <user-agent>Mozilla/5.0 (Linux; X11)</user-agent>\\n      </web-info>\\n      <fraud-info>\\n        <fraud-session-id>1234567890</fraud-session-id>\\n      </fraud-info>\\n    </ordering-shopper>\\n    <cart>\\n      <cart-item>\\n        <sku>\\n          <sku-id>2183634</sku-id>\\n        </sku>\\n        <quantity>1</quantity>\\n      </cart-item>\\n    </cart>\\n    <expected-total-price>\\n      <amount>11</amount>\\n      <currency>BRL</currency>\\n    </expected-total-price>\\n  </order>\\n</batch-order>\",\n      \"language\": \"xml\",\n      \"name\": \"Create Order and Shopper with LatAm required fields\"\n    }\n  ]\n}\n[/block]\n\n[block:html]\n{\n  \"html\": \"</div>\\n</div>\"\n}\n[/block]","excerpt":"","slug":"latam-local-processing","type":"basic","title":"LatAm Local Processing"}

LatAm Local Processing


BlueSnap supports a variety of international and local credit cards in Latin America (LatAm), so you can increase conversions in these markets. This section will outline which international and local credit cards are supported, and the specific requirements for your BlueSnap integration.

Supported Countries and Cards

International credit cards

The following international credit cards are supported:

  • American Express (Amex)
  • Diners
  • Discover
  • JCB in select countries (consult with implementation for details)
  • MasterCard
  • Visa

Local credit cards

Local credit card processing is available for transactions in Argentina, Brazil, Chile, Colombia, and Mexico. The following list outlines the supported local cards per country.

  • Argentina – Amex, Argencard, Cabal, Cencosud, Diners, MasterCard, Nativa, Tarjeta Naranja, Tarjeta Shopping, Visa
  • Brazil – Amex, Cartão MercadoLivr, Diners, Discover, ELO, Hipercard, JCB, MasterCard, Visa
  • Chile – Amex, Diners, MasterCard, Visa
  • Colombia – Amex, Diners, MasterCard, Visa
  • Mexico – Amex, MasterCard, Visa

Benefits

Benefits of local processing include the ability to lower costs by eliminating pass through tax charges, processing in local currency, reducing checkout friction, and increasing payment conversion rates.

Local processing in these countries is available with any BlueSnap integration, and your business does not have to be located in LatAm. Simply contact merchants@bluesnap.com to have it enabled.

Required Information for API Integrations

In order for transactions to be processed locally, you must collect the following information from your shopper and send it to BlueSnap with each transaction:

  • Shopper email address
  • Local personal identification number
  • CVV (Argentina and Chile only)

If you do not provide these fields, then the transaction may be processed internationally at a higher cost.

Local personal identification number

Local LatAm processing requires that the shopper provide their local personal identification number. These are the required ID types per country:

  • Argentina - DNI
  • Brazil - CPF/CNPJ
  • Chile - RUN
  • Colombia - CC
  • Mexico - CURP/RFC

CVV Requirements & Recurring Payments

Recurring payments are automatically processed without the CVV, since the shopper only enters this information during the first transaction. In certain LatAm countries, the local acquirers require the CVV for every transaction, meaning that recurring payments in these countries will need to be processed through our international acquirers.

Recurring payments in Brazil, Mexico, and Colombia will be processed locally, since the acquirers in these countries do support recurring payments without the CVV.

Recurring payments in Argentina and Chile will be processed internationally, since the acquirers in these countries do not support payments without the CVV.

Expired Cards

If you’re using BlueSnap’s subscription engine, a Subscription Charge Failure IPN will be sent when a charge fails due to an expired card. We recommend taking the following steps to ensure the next charge is successful. Note that Account Updater is not supported for LatAm countries at this time.

  1. Reach out to the shopper requesting updated card information.
  2. Update the shopper's payment information via relevant API calls:

Returning shoppers

Vaulted shoppers are fully supported for Brazil, Colombia, and Mexico, so you can use the same returning shopper flow that you do normally.

For Argentina and Chile, the CVV is required to process each purchase. Since BlueSnap does not store the CVV, you must collect the CVV on your checkout form and send it in with each transaction. If you do not send in the CVV, then the transaction may be processed internationally at a higher cost.

Capturing CVV during checkout

We recommend capturing the returning shopper’s CVV during checkout and including this value within the transaction request to BlueSnap.

For examples, see:

Payment APIAuth Capture or Auth Only

Extended Payment APICreate Order or Create Shopping Context

Separate Auth and Capture

The separation of Auth and Capture is supported for Brazil and Mexico.

For Argentina, Chile and Colombia, you are required to perform the Auth and Capture at once to use local processing. If you use separate Auth and Capture requests in these countries, then the transaction may be processed internationally at a higher cost.

Example requests




Here are examples of the Create Card Transaction and Create Vaulted Shopper requests with these required fields in the Payment API:

{
    "amount": 11,
    "recurringTransaction": "ECOMMERCE",
    "softDescriptor": "MyDescriptor",
    "cardHolderInfo": {
        "country": "BR",
        "firstName": "test first name",
        "lastName": "test last name",
        "personalIdentificationNumber": "11.111.111/0001-10",
        "email": "test@email.com"
    },
    "currency": "BRL",
    "creditCard": {
        "expirationYear": 2019,
        "securityCode": 111,
        "expirationMonth": "07",
        "cardNumber": 4111111111111111
    },
    "cardTransactionType": "AUTH_CAPTURE"
}
{
    "zip": 12345,
    "country": "mx",
    "paymentSources": {"creditCardInfo": [{"creditCard": {
        "expirationYear": 2019,
        "securityCode": 111,
        "expirationMonth": "07",
        "cardNumber": 4111111111111111
    }}]},
    "firstName": "FirstName",
    "lastName": "LastName",
    "phone": 1234567890,
    "personalIdentificationNumber": "11.111.111/0001-10",
    "email": "test@email.com"
}



Here are examples of Create Shopper and Create Order and Shopper requests with the required fields in the Extended Payment API

<shopper xmlns="http://ws.plimus.com">
  <web-info>
    <ip>62.219.121.253</ip>
    <remote-host>www.merchant.com</remote-host>
    <user-agent>Mozilla/5.0 (Linux; X11)</user-agent>
  </web-info>
  <shopper-info>
    <shopper-currency>BRL</shopper-currency>
    <store-id>4677</store-id>
    <locale>en</locale>
    <shopper-contact-info>
      <title>Mr</title>
      <first-name>John</first-name>
      <last-name>Doe</last-name>
      <email>jdoe@johndoeandsons.com</email>
      <company-name>JohnDoeAndSons</company-name>
      <address1>138 Market St</address1>
      <city>Rio de Janeiro</city>
      <zip>01000-000</zip>
      <country>BR</country>
      <phone>14135556789</phone>
      <personal-identification-number>11.111.111/0001-10</personal-identification-number>
    </shopper-contact-info>
	<payment-info>
      <credit-cards-info>
        <credit-card-info>
          <billing-contact-info>
            <first-name>John</first-name>
            <last-name>Doe</last-name>
            <address1>138 Market St</address1>
            <city>Rio de Janeiro</city>
            <zip>01000-000</zip>
            <country>BR</country>
          </billing-contact-info>
          <credit-card>
            <card-number>4111 1111 1111 1111</card-number>
            <security-code>123</security-code>
            <card-type>VISA</card-type>
            <expiration-month>09</expiration-month>
            <expiration-year>2019</expiration-year>
          </credit-card>
        </credit-card-info>
      </credit-cards-info>
    </payment-info>
  </shopper-info>
</shopper>
<batch-order xmlns="http://ws.plimus.com">
  <shopper>
    <web-info>
      <ip>62.219.121.253</ip>
      <remote-host>www.merchant.com</remote-host>
      <user-agent>Mozilla/5.0 (Linux; X11)</user-agent>
    </web-info>
    <shopper-info>
      <store-id>10540</store-id>
      <locale>en</locale>
      <shopper-contact-info>
        <title>Mr</title>
        <first-name>John</first-name>
        <last-name>Doe</last-name>
        <email>jdoe@johndoeandsons.com</email>
        <company-name>JohnDoeAndSons</company-name>
        <address1>138 Market St</address1>
        <city>Rio de Janeiro</city>
        <zip>01000-000/zip>
        <country>BR</country>
        <phone>14135556789</phone>
        <personal-identification-number>11.111.111/0001-10</personal-identification-number>
      </shopper-contact-info>
      <payment-info>
        <credit-cards-info>
          <credit-card-info>
            <billing-contact-info>
              <first-name>John</first-name>
              <last-name>Doe</last-name>
              <address1>138 Market St</address1>
              <city>Rio de Janeiro</city>
              <zip>01000-000</zip>
              <country>BR</country>
            </billing-contact-info>
            <credit-card>
              <card-number>4111 1111 1111 1111</card-number>
              <security-code>123</security-code>
              <card-type>VISA</card-type>
              <expiration-month>09</expiration-month>
              <expiration-year>2019</expiration-year>
            </credit-card>
          </credit-card-info>
        </credit-cards-info>
      </payment-info>
    </shopper-info>
  </shopper>
  <order>
    <ordering-shopper>
      <web-info>
        <ip>62.219.121.253</ip>
        <remote-host>www.merchant.com</remote-host>
        <user-agent>Mozilla/5.0 (Linux; X11)</user-agent>
      </web-info>
      <fraud-info>
        <fraud-session-id>1234567890</fraud-session-id>
      </fraud-info>
    </ordering-shopper>
    <cart>
      <cart-item>
        <sku>
          <sku-id>2183634</sku-id>
        </sku>
        <quantity>1</quantity>
      </cart-item>
    </cart>
    <expected-total-price>
      <amount>11</amount>
      <currency>BRL</currency>
    </expected-total-price>
  </order>
</batch-order>