Tutorials / Payments

Merchant e-Solutions (MeS) Payments and Integration

Characteristics

Using Merchant e-Solutions you can pay both by credit card and ACH. 

While credit card payments via MeS are available in all currencies (USD and non-USD), ACH payments can be submitted only in USD.


How to Set up MeS

  1. Go to Settings > Payments/Credits > MeS section.
  2. Click SET UP.
  3. Populate the Gateway URL:
  4. Populate the rest of the mandatory fields obtained from the payment provider.
  5. Click SAVE.

How to Connect to MeS

Once you set up the MeS payment service provider, you can connect to it on the Integrations page: go to Settings > Payments/Credits and find MeS in the PSPs list.

Click "CONNECT".

After this, the "DISCONNECT" button appears, which can be used to disconnect MeS.

 


Inform Merchant e-Solutions Rep on the Subdomain(s) to Whitelist

After you have set up YayPay to connect to the MeS payment service provider, you also need to inform your MeS Representative to whitelist the appropriate subdomains. 

This Subdomain is configured on your Business Settings page. Each Subsidiary set up as its own YayPay instance can have its own Subdomain set. Refer to https://yaypay.helpjuice.com/en_US/payments/adding-a-subdomain for guidance on how to set up the Subdomain. You should notify your customers after adding this subdomain as their previous statement links will change.

Delete

Important

Make sure the subdomains you provide to Merchant e-Solutions do not contain the protocol scheme (https://). Otherwise, the platform will produce a transmission error.

For example, if a subdomain is configured to be https://spf.app.yaypay.com, provide only the following string: spf.app.yaypay.com.

Ability to Work along with Other PSPs

Being a primary payment service provider, MeS can be connected along with any of the secondary PSPs.

For detailed description of how MeS works when connected simultaneously with other PSP, see the links below:

1) MeS + NMI:https://yaypay.helpjuice.com/en_US/payments/955336-nmi-payments-and-integration

2) MeS + GoCardless: https://yaypay.helpjuice.com/en_US/payments/gocardless-integration

3) MeS + Flywire: https://yaypay.helpjuice.com/en_US/payments/951427-flywire-payments

Error Codes

MeS Transaction Error Codes

101        Invalid ID or Key             

102        Incomplete Request      

103        Invoice Number Length Error    

104        Reference Number Length Error

105        AVS Address Length Error           

106        AVS Zip Length Error     

107        Merchant Name Length Error    

108        Merchant City Length Error        

109        Merchant State Length Error     

110        Merchant Zip Length Error         

111        Merchant Category Code Length Error   

112        Merchant Phone Length Error   

113        Reference Number Must Be Numeric     

114        Missing Card Holder Account Data          

115        Invalid Card Number     

116        Credits Not Allowed      

117        Card Type Not Accepted             

118        Currency Type Not Accepted     

119        Retry ID length error Must be 16 characters or less         

120        An invoice number is required for a 3D enrollment check             

121        MOTO/e-Commerce indicator length error         

122        Non-USD offline transactions are not supported

123        Client Reference Number length error   

127        Invalid Level III Line Item Detail 

128        Invalid Level III Merchant T ax ID             

129        Invalid Level III Customer Tax ID

130        Invalid Level III Summary Commodity Code         

131        Invalid Level III Ship to Zip          

132        Invalid Level III Ship from Zip     

133        Invalid Level III Destination Country Code            

134        Invalid Level III VAT Invoice Number       

135        Invalid Level III Alternate Tax Indicator  

136        Transaction type does not support Level III data

137        Invalid Level III Discount Amount            

138        Invalid Level III Duty Amount     

139        Invalid Level III Order Date         

140        Invalid Level III VAT Amount      

141        Invalid Level III VAT Rate             

142        Invalid Level III Alternate Tax Amount    

143        Invalid Level III Line Item Count

144        Invalid Level III Card Type           

168        Invalid Industry Code    

201        Invalid Transaction ID   

202        Invalid Transaction Amount       

203        Void Failed        

204        Transaction Already Settled       

205        Transaction Already Voided       

206        Transaction Already refunded   

207        Refund failed    

208        Failed to receive a response from auth host        

209        Invalid tax amount        

210        AVS result is declined by user    

211        CVV2 result is declined by user 

212        Refund amount must be between zero and the original amount

213        Only sale transactions can be refunded 

214        Only one type of card data allowed per request 

215        Invalid Card ID  

216        Failed to load card data, retry request   

217        Failed to store card data, retry request  

218        Card ID parameter cannot be included in this type of transaction             

219        Offline transactions require an authorization code          

220        Failed to delete card data, retry request

221        Invalid Card ID  

222        Card ID required            

223        Retry Request ID

229        Failed to find currency code for the requested country code       

230        Failed to post transaction the FX service

231        FX amount in base currency is required

232        FX transactions not accepted for this account     

233        Request currency code must match FX rate currency code           

234        Pin debit transactions require track 2 swipe data             

235        Invalid pin debit transaction type            

236        Non-USD pin debit transactions are not supported          

237        Batch Close Failed          

238        Quit Duplicate Batch     

239        Invalid retry id  

240        Failed to load declined auth data            

999        Internal Error (review your Profile ID to make sure no characters are missing - it should be 20 characters long)

Delete

MeS Declined Payment Codes

001

Refer to card issuer

002

Refer to card issuer, special condition

003

Invalid merchant

004

Pick up card (no fraud)

Refer to card issuer

005

Do not honor

006

Error

--

007

Pick up card, special condition (fraud account)

Invalid merchant

008

--

Capture card

010

Partial approval

Do not honor

011

Approved (V.I.P.)

--

012

Invalid transaction

--

013

Invalid amount or currency conversion field overflow

Honor with ID

014

Invalid account number (no such number)

Partial approval

015

No such issuer

--

019

Re-enter transaction

Invalid transaction

021

No action taken

Invalid amount

025

Unable to locate record in file

Invalid card number

028

File temporarily not available for update or inquiry

Invalid issuer

030

--

--

039

No credit account

--

041

Lost card, pick up (fraud account)

--

043

Stolen card, pick up (fraud account)

--

051

Not sufficient funds

Format error (Verification only) Transaction type not supported by issuer

052

No checking account

--

053

No savings account

Lost card

054

Expired card of expiration date is missing

Stolen card

055

Incorrect PIN or PIN missing

Insufficient funds / over credit limit

057

Transaction not permitted to cardholder

--

058

--

--

059

Suspected fraud

Expired card

061

Exceeds approval amount limit

Invalid PIN

062

Restricted card (card invalid in this region or country)

Transaction not permitted to issuer / cardholder (Verification only) Transaction type not supported by issuer

063

Security violation (source is not correct issuer)

Transaction not permitted to acquirer / terminal

064

Transaction does not fulfill AML requirement

--

065

Exceeds withdrawal frequency limit

Exceeds withdrawal amount limit

068

--

Restricted card

070

--

Security violation

071

--

--

075

Allowable number of PIN tries exceeded

Exceeds withdrawal count limit

076

Unsolicited reversal

Response received late

077

--

Contact card issuer

078

--

PIN not changed

079

Already reversed (by Switch)

Allowable number of PIN tries exceeded

080

No financial impact

Invalid / nonexistent “To Account” specified

081

Cyptographic error found in PIN

Invalid / nonexistent “From Account” specified

082

Negative CAM, dCVV, iCVV, or CVV results

Invalid / nonexistent account specified (general)

084

--

--

085

No reason to decline a request for address verification, CVV2 verification, or a credit voucher or merchandise return

--

086

Cannot verify PIN; for example, no PVV

Domestic debit transaction not allowed (regional use only)

087

--

--

088

--

Invalid authorization life cycle

089

Ineligible to receive financial position information

Not declined Valid for all zero amount transactions

091

Issuer or switch inoperative and STIP not applicable or not available for this transaction; Time-out when no stand-in; POS Check Service: Destination unavailable; Credit Voucher and Merchandise Return Authorizations: V.I.P. sent the transaction to the issuer, but the issuer was unavailable.

PIN validation not possible

092

Financial institution or intermediate network facility cannot be found for routing (receiving institution ID is invalid)

Purchase amount only, no cashback allowed

093

Transaction cannot be completed – violation of law

Cryptographic failure

094

--

Unacceptable PIN – transaction declined – retry

096

--

Authorization system or issuer system inoperative

Delete


Can't find what you need?

Contact our support team support@yaypay.com for help.