On This Page
You can authorize a payment for Samsung Pay using two different types of decryption methods:
Cybersource
 or Merchant. Each decryption method requires a different set of required API fields. In addition, depending on which card type is used, different fields are required for requesting the authorization service.
The following table provides details about authorizations for specific processors:
Payment Processor
Authorization Information
American Express Direct
For USD,
American Express Direct
 limits authorization and capture amounts to 9,999,999.00. For other currencies, the maximum amount depends on the currency. Contact American Express for the maximum amounts for the currencies that you are using. Regardless of exponent or currency, the maximum number of digits for the amount value is 12 digits.
Asia, Middle East, and Africa Gateway
Asia, Middle East, and Africa Gateway
 limits authorization and capture amounts to four bytes; therefore, the maximum amount is 2147483647.
Certain acquirers that are connected to the
Asia, Middle East, and Africa Gateway
 require that an authorization be automatically captured.
Atos
Atos
 limits authorization, capture, and credit amounts to 12 digits; therefore, the maximum amount is 999999999999.
IMPORTANT
Authorizations time out after 5 days, 20 hours, and 30 minutes. For Maestro (UK Domestic), when you submit a capture request after 5 days, 20 hours, and 30 minutes, you must reauthorize first. For all other card types, when you submit a capture request after 5 days, 20 hours, and 30 minutes,
Cybersource
 tries to obtain a fresh authorization.
Barclays
The amount is rounded to the correct number of decimal places for the currency.
Barclays
 does not support amounts of 0.01.
Barclays
 supports zero amount authorizations and amounts greater than 0.01.
Barclays
 supports enhanced response codes in authorization reply messages. Enhanced response codes provide detailed information about declined transactions. Contact
Barclays
 customer support to have this capability enabled for your account.
Cielo
Automatic Capture and Standard Capture:
Cielo
 supports standard captures and automatic captures:
  • By default, your account is configured to support standard capture processing.
  • For an Aura Card transaction, you must set the authorization type to
    AUTOCAPTURE
    .
Combo Cards:
Some card types can be processed as credit cards and debit cards. On
Cielo
:
  • The default payment method is credit card.
  • To override the default payment method, include the
    override_payment_method
     field in the authorization request.
Debit Cards:
 For debit cards on
Cielo
:
  • You must request an automatic capture.
  • You must include payer authentication data in the request for cards that support it on the
    Cielo
     gateway.
  • Some card types must always be processed as debit cards and must be identified with the override payment method field. Visa Electron and Maestro (International) must always be processed as debit cards.
Comercio Latino
Regardless of exponent or currency, the maximum number of digits for the amount value is 19 digits. The acquirer can impost additional restrictions on the maximum amount.
Debit Cards:
 For debit cards on
Comercio Latino
:
  • You must request an automatic capture.
  • You must include payer authentication data in the request for cards that support it on the
    Comercio Latino
     gateway.
  • Some card types must always be processed as debit cards and must be identified with the
    override_payment_method
     field. Visa Electron and Maestro (International) must always be processed as debit cards.
Cybersource Latin American Processing
For some countries you must submit an automatic capture. For other countries, you can submit standard authorization and capture requests. Contact customer support for each country’s requirements.
For transactions in Brazil, you must request the follow-on capture within five days of the authorization request.
Cybersource Latin American Processing
 is the name of a specific processing connection.
Cybersource Latin American Processing
 does not refer to the general topic of processing in Latin America. The information in this field description, or in this section of the field description, is for the specific processing connection called
Cybersource Latin American Processing
. It is not for any other Latin American processors.
FDMS South
For the Indonesian rupiah (IDR) and Chilean peso (CLP) currencies only:
  • Rounding occurs, which can cause a minor discrepancy that consists of a maximum of one currency unit between the amount you requested and the amount that is authorized.
  • When a transaction is enabled for partial authorization, you must ensure that the requested amount does not include any digits to the right of the decimal separator.
GPN
GPN
 limits the authorization, capture, and credit amounts to 10 digits.
HSBC
The amount is rounded to the correct number of decimal places for the currency.
HSBC
 supports enhanced response codes in authorization reply messages. Enhanced response codes provide detailed information about declined transactions. Contact
HSBC
 customer support to have this capability enabled for your account.
Ingenico ePayments
For Cartes Bancaires, the authorization and capture amount must be 0.99 EUR or more.
Moneris
>
Moneris
 limits authorization and capture amounts to nine digits; therefore, the maximum amount is 9999999.99.
RBS WorldPay Atlanta
RBS WorldPay Atlanta
 limits the authorization, capture, and credit amounts to the equivalent of 999,999.99 USD.
Depending on the value you send, the decimal is either truncated or appended. For example, if you send 1.123 the decimal is truncated to 1.12. If you send 123 it is converted to 123.00.
RuPay
RuPay
 requires payer authentication for all authorization requests.
The reply message for the payer authentication check enrollment service indicates whether a card requires single-message processing or dual-message processing.
In the authorization request, the e-commerce indicator must be
rpy
.
When you do not receive an authorization reply message, request the check status service.
Streamline
Streamline
 limits authorization and capture amounts to 11 digits; therefore, the maximum amount is 999999999.99.
Streamline
 supports enhanced response codes in authorization reply messages. Enhanced response codes provide detailed information about declined transactions. Contact
Streamline
 customer support to have this capability enabled for your account.
TSYS Acquiring Solutions
TSYS Acquiring Solutions
 limits authorization and capture amounts to the equivalent of 99,999.99 USD. To process an amount greater than this, contact
TSYS Acquiring Solutions
.
Visa Platform Connect
Visa Platform Connect
 limits authorization and capture amounts to 999999999999 (twelve 9s).
Worldpay VAP
Worldpay VAP
 limits authorization and capture amounts to eight digits; therefore, the maximum amount is 99999999.

Example:
Cybersource
 Decryption with JCB Using the SCMP API

Authorization Request
bill_address1=123 Main Street
bill_address2=Suite 12345
bill_city=Small Town
bill_country=US
bill_state=CA
bill_zip=98765
card_type=007
currency=usd
customer_cc_expmo=12
customer_cc_expyr=2031
customer_cc_number=xxxx55555555xxxx
customer_email=js@example.com
customer_firstname=Jane
customer_lastname=Smith
customer_phone=999-999-9999
eci_raw=05
grand_total_amount=100.00
ics_applications=ics_auth
merchant_id=med123
cavv=EHuWW9PiBkWvqE5juRwDzAUFBAk=
payment_network_token_transaction_type=1
payment_solution=008
Authorization Response
auth_auth_amount=100.00
auth_auth_avs=X
auth_auth_code=888888
auth_auth_response=100
auth_avs_raw=I1
auth_rcode=1
auth_rflag=SOK
auth_rmsg=Request was processed successfully.
auth_trans_ref_no=15356268CR2XF23X
currency=USD
ics_rcode=1
ics_rflag=SOK
ics_rmsg=Request was processed successfully.
merchant_ref_number=ref123
request_id=4697369268106124601541