On This Page

{#jumplink-list}  
[Markdown](/docs/cybs/en-us/payments/developer/ctv/so/payments/payments-processing-basic-intro/payments-processing-foreign-auth-intro.md)  
Filter  
FILTER BY TAG

Marketplace Authorization with Foreign Retailers {#payments-processing-foreign-auth-intro}
==========================================================================================

`Visa Platform Connect` requires marketplaces to identify foreign retail transactions when the marketplace and issuer are in the European Economic Area (EEA), the U.K., and Gibraltar and the retailer is in a different country. For marketplace transactions, the marketplace is the merchant and the retailer is the sub-merchant. Marketplace foreign retail transactions are identified in the `Business Center` on the transactions details page.

> This feature is intended for captures. You can include this information in an authorization, but this is not the preferred method. The capture request data overrides the authorization request data.

Fields Specific to this Use Case
--------------------------------

These fields are required for this use case:

invoiceHeader_merchantDescriptorCountry
:
Set this value to the marketplace country.

invoiceHeader_submerchantCountry
:
Set this value to the retailer country.

Endpoint {#payments-processing-foreign-auth-intro_d7e16}
--------------------------------------------------------

Set the ccAuthService_run field to `true`.  
Send the request to `https://ics2ws.ic3.com/commerce/1.x/transactionProcessor`.

Required Fields for Processing a Marketplace Authorization with a Foreign Retailer {#payments-processing-foreign-auth-required}
===============================================================================================================================

> When relaxed requirements for address data and the expiration date are being used, not all fields in this list are required. It is your responsibility to determine whether your account is enabled to use this feature and which fields are required. For details about relaxed requirements, see [Relaxed Requirements for Address Data and Expiration Date in Payment Transactions](/docs/cybs/en-us/payments/developer/ctv/so/payments/payments-relax-reqs.md "").

billTo_city
:

billTo_country
:

billTo_email
:

billTo_firstName
:

billTo_lastName
:

billTo_postalCode
:

billTo_state
:

billTo_street1
:

card_accountNumber
:

card_expirationMonth
:

card_expirationYear
:

ccAuthService_run
:
Set the value to `true`.

invoiceHeader_merchantDescriptorCountry
:
Set this value to the marketplace country.

invoiceHeader_submerchantCountry
:
Set this value to the retailer country.

merchantID
:

merchantReferenceCode
:

purchaseTotals_currency
:

purchaseTotals_grandTotalAmount
:

Related Information
-------------------

* [API field reference guide for the Simple Order API](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/api-fields-so-intro.md "")

Simple Order Example: Processing a Authorization with a Foreign Retailer {#payments-processing-foreign-auth-ex-so}
==================================================================================================================

Request

```keyword
billTo_city=Ann Arbor
billTo_country=US
billTo_email=null@cybersource.com
billTo_firstname=John
billTo_lastname=Smith
billTo_postalCode=48104-2201
billTo_state=MI
billTo_street1=201 S. Division St.
card_accountNumber=41111111XXXXXXXX
card_expirationMonth=12
card_expirationYear=2023
ccAuthService_run=true
invoiceHeader_merchantDescriptorCountry=GB
invoiceHeader_submerchantCountry=AU
merchant_id=abc123
merchant_referenceCode=TC42703-1
purchaseTotals_currency=GBP
purchaseTotals_grandTotalAmount=100
```

Response to a Successful Request

```
requestID=6629977932421985593067
decision=ACCEPT
reasonCode=100
merchantReferenceCode=TC42703-1
purchaseTotals_currency=GBP
ccAuthService_reconciliationID=57953165A7YFPS77
ccAuthReply_amount=100.00
ccAuthReply_avsCode=5
ccAuthReply_authorizationCode=570110
ccAuthReply_processorResponse=1
ccAuthReply_authorizedDateTime=2024-09-12T154953Z
```

Response to a Declined Request

```
requestID=6629977932421985593067
merchantReferenceCode=Merchant_REF
decision=REJECT
ccAuthReply_avsCode=Y
ccAuthReply_avsCodeRaw=Y
ccAuthReply_paymentNetworkTransactionID=111222
ccAuthReply_transactionID=111222
ccAuthReply_paymentInsightsInformation_responseInsightsCategory=
    ISSUER_CANNOT_APPROVE_WITH_THESE_DETAILS
ccAuthReply_paymentInsightsInformation_responseInsightsCategoryCode=03
ccAuthReply_processorResponse=183  
ccAuthReply_reasonCode=233
```

RELATED TO THIS PAGE