Error codes

Complete list of Onerway error codes, descriptions, and suggested actions to help you troubleshoot payment issues.

When a payment fails or an API request encounters an issue, Onerway returns an error code to help you identify and resolve the problem.

System errors (11xxx)

CodeMessageSuggested action
11001System exceptionContact service provider

Configuration errors (12xxx)

CodeMessageSuggested action
12001System configuration declineContact service provider
12002Merchant ID is disabled or settlement currency is not configuredContact service provider
12003Card brand/3DS/Service is not supportedContact service provider
12004Merchant Account is disabled or non-existentContact service provider
12005Invalid transaction ID (Limited by SDK)1. Check if the transaction number used for initializing the SDK is from the server response;
2. Confirm the transaction number has not been tampered;
3. Confirm the ordering interface and SDK environments are consistent
12006Recurring information verification failedEnsure the repurchase deduction time meets the deduction frequency
12007Transaction ID is incorrectCheck merchantNo
12008Invalid transaction IPCheck transactionIp in the request
12009Request channels timed outRetry later
12010Request cannot be processed due to configuration errorContact service provider and ensure the transaction type is supported
120113DS/API request initiation failedContact service provider

Parameter errors (13xxx)

CodeMessageSuggested action
13001Appid is invalid!Contact service provider
13002Invalid card numberCheck card number and retry
13003Transaction url is invalid1. Check whether the requested domain matches the registered domain;
2. Contact service provider
13004Card expired card1. Check card information and retry;
2. Contact card issuer;
3. Use another card
13005Year must be 2 or 4 digits1. Check card information and retry;
2. Use another card
13006Invalid state, please fill in the correct state when the country is US, CA or CN.Check state in the request (required for US, CA, CN)
13007Incorrect card informationCheck card information and retry
13008Repeat transaction rejectedCheck if the transaction has already been successful
13009Card number cannot be empty！Check card number and retry
13010Unsupported card:MAESTROCheck card brand configuration
13011Decline - Invalid account number1. Refer to card issuer;
2. Use another card
13012BillingAddress.city: city size must be up to 30 characters long!Check city in the request (max 30 characters)
13013Risk3dsStrategy is EXTERNAL, mpiInfo not be nullCheck mpiInfo in the request
13014Invalid transaction typeCheck txnType in the request
13015Subscription failed! Merchant customer number cannot be empty！Check merchantCustId in the request
13016Subscription contract param can not be nullCheck subscription in the request
13017BillingInformation cannot be empty or email and country cannot be emptyCheck billingInformation (email, country)
13018Invalid productType!Check productType in the request
13019Invalid product formatCheck txnOrderMsg (product)
13020Subscription frequency is illegalCheck subscription (frequencyType, frequencyPoint)
13021The time range of transaction inquiry cannot exceed ninety days!Check startTime and endTime
13022Unsupported currencyCheck country and currency consistency
13023Subscription contract unavailableCheck subscription status
13024Repurchase failed! The contract number or token cannot be empty！Check contractId and tokenId
13025Card year/month is invalidCheck year and month
13026Invalid subProductType!Check subProductType
13027Repeated order transactions!Check if the request has already been successful
13028The query condition cannot be empty! (Order number or start and end time, both cannot be empty at the same time)Check merchantTxnIds, transactionIds, startTime, endTime
13029Subscription contract expiredCheck if subscription has expired
13030Invalid transaction amountCheck amount
13031Unsupported card:Pan_Only, please change to a card that supports 3ds and try again!Change to a card that supports 3DS
13032The order has been captured or canceled，it cannot be captured againCheck if order has been captured or canceled
13033Transaction failed，the parameters has be used in first purchaseCheck if same buyer already subscribed with same card
13034invalid CVV2 lengthCheck CVV2 length
13035The refund amount is too small.Refund amount must be greater than 0

Subscription errors (132xx)

CodeMessageSuggested action
13200Invalid Self executeCheck "Self execute" setting
13201Invalid emailCheck email
13202Invalid Cycle countCheck "Cycle count"
13203Invalid Trial from planCheck "Trial from plan"
13204Invalid Trial days or trial endCheck "Trial days" or "trial end"
13205Invalid Products informationCheck "Products information"
13206Invalid ProrationCheck "Proration"
13207Invalid Billing cycle anchorCheck "Billing cycle anchor"
13208Invalid frequency typeCheck "frequency type"
13209Invalid subscription request typeCheck "subscription request type"
13210Invalid subscription periodCheck "subscription period"
13211Invalid subscription frequencyCheck "subscription frequency"
13212Invalid Merchant customer numberCheck "Merchant customer number"
13213Invalid contract number or tokenCheck "contract number" or "token"
13214Subscription validity is less than currentCheck "Subscription validity"
13215Invalid contract informationCheck "contract information"

Refund errors (14xxx)

CodeMessageSuggested action
14001Refund failedCheck transaction status
14002It cannot support real-time refund.Try again later
14003The cumulative refund amount cannot be greater than the transaction amount！Check current and cumulative refund amounts
14004Refund has already been processed and cannot be canceledCheck refund status before cancellation
14005Online refunds not supportedProcess refund manually through offline ways
14006Real-time refund not supportedSchedule delayed refund processing
14007Refund not supported for this payment methodProcess refund manually through other ways
14008System automatic refund in progressWait for automatic refund to complete
14009Only full refund allowed for chargeback transactionsProcess full refund instead of partial
14010Refund must use designated interfaceRedirect refund request to correct interface
14011Online refund failed due to pending/rejected ordersResolve pending order approvals first
14012Insufficient settlement account balanceEnsure adequate funds in settlement account
14013Transaction does not support refund initiationContact service provider
14014Chargeback already exists, refund not supportedAmount already returned through bank/card issuer
14015Source transaction was unsuccessfulVerify original transaction status before refund

Risk control (20xxx)

CodeMessageSuggested action
20001High riskConfirm customer identity. Retry in 24 hours or contact service provider

Validation errors (30xxx)

CodeMessageSuggested action
30001Invalid ipCheck ip in the request
30002Invalid birthDateCheck birthDate
30003Invalid productCheck product
30004Invalid merchantCustIdCheck merchantCustId
30005Invalid productTypeCheck productType
30006Invalid appIdCheck appId
30007Invalid numberCheck card number and retry
30008Invalid CVV2(Visa only) / CVC2(Mastercard only)Check CVV2/CVC2 and retry
30009Invalid pin1. Refer to card issuer;
2. Use another card
30010Invalid expiry month/year1. Check expiry date and retry;
2. Use another card
30011Invalid cardholder nameCheck cardholder name and retry
30012Invalid countryCheck country
30013Invalid stateCheck state
30014Invalid cityCheck city
30015Invalid addressCheck address
30016Invalid emailCheck email
30017Invalid postalCodeCheck postalCode
30018Invalid phoneCheck phone
30019Invalid account1. Refer to card issuer;
2. Use another card
30020Invalid parametersRefer to API documentation and check request parameters
30021Invalid transaction urlContact service provider to review and approve the website

Acquirer errors (40xxx)

CodeMessageSuggested action
40001Acquirer suspected fraudConfirm customer identity and retry with another card
40002Acquirer system failure1. Retry later;
2. Use another card;
3. Contact service provider
40003Acquirer decline1. Retry later;
2. Use another card
40004Acquirer time outRetry later
40005Acquirer parameters missing / errorContact service provider

3DS errors (50xxx)

CodeMessageSuggested action
500013DS authentication required1. Retry and complete 3DS authentication;
2. Use another card
500023DS parameters error1. Retry and complete 3DS authentication;
2. Use another card
500033DS authentication failure1. Retry and complete 3DS authentication;
2. Use another card
500043DS system error1. Retry and complete 3DS authentication;
2. Use another card
50030Order cancelledOrder cancelled

Issuer errors (60xxx)

CodeMessageSuggested action
60001Refer to card issuer1. Check card information and retry;
2. Contact card issuer;
3. Use another card
60002Refer to card issuer, special condition1. Check card information and retry;
2. Contact card issuer;
3. Use another card
60003Invalid merchantContact service provider
60004Pick up card (no fraud)/Capture cardRefer to card issuer or use another card
60005Do not honor1. Check card information and retry;
2. Contact card issuer;
3. Use another card
60006ErrorRetry later or use another card
60007Pick up card, special condition (fraud account)Refer to card issuer or use another card
60012Invalid transaction1. Check card information and retry;
2. Contact card issuer;
3. Use another card
60013Invalid amount or Currency conversion field overflow1. Check transaction amount or currency;
2. Contact service provider
60014Invalid account number (no such number) or No Mod 10 check or Not a valid length for issuer or Not in positive PIN Verification file or Separator in wrong position1. Check card information and retry;
2. Contact card issuer;
3. Use another card
60015No such issuer (first 8 digits of account number do not relate to an issuing identifier) /Invalid issuer1. Check card information and retry;
2. Contact card issuer;
3. Use another card
60019Re-enter transaction1. Check for format errors;
2. Check address information
60021No action taken1. Contact card issuer;
2. Use another card
60025Unable to locate record in file1. Check card information and retry;
2. Contact card issuer;
3. Use another card
60028File temporarily not available for update or inquiryRetry transaction
60030Format error1. Check card information and retry;
2. Contact card issuer;
3. Use another card
60039No credit account1. Check card information and retry;
2. Contact card issuer;
3. Use another card
60041Lost card, pick up card (fraud account)Refer to card issuer or use another card
60043Stolen card, pick up (fraud account)Refer to card issuer or use another card
60046Closed account1. Check card information and retry;
2. Contact card issuer;
3. Use another card
60051Insufficient funds/over credit limit1. Refer to card issuer to confirm credit limit;
2. Use another card
60052No checking account1. Check card information and retry;
2. Contact card issuer;
3. Use another card
60053No savings account1. Check card information and retry;
2. Contact card issuer;
3. Use another card
60054Expired card or expiration date missing1. Check card information and retry;
2. Contact card issuer;
3. Use another card
60055PIN incorrect or missing/Invalid PINRefer to card issuer or use another card
60057Transaction not permitted to issuer/cardholderRefer to card issuer or use another card
60058Transaction not permitted to acquirer/terminalRefer to card issuer or use another card
60059Suspected fraud1. Check card information and retry;
2. Contact card issuer;
3. Use another card
60061Exceeds approval amount limitRefer to card issuer or use another card
60062Restricted card (card invalid in region or country)/Restricted cardRefer to card issuer or use another card
60063Security violation (source is not correct issuer)/Security violation1. Check card information and retry;
2. Contact card issuer;
3. Use another card
60064Transaction does not fulfill AML requirementRisky transaction. Do not retry
60065Exceeds withdrawal frequency limit1. Contact card issuer;
2. Use another card;
3. Contact service provider
60070PIN data required (Visa use only) or Contact Card Issuer(Mastercard use only)Refer to card issuer or use another card
60071PIN Not ChangedRefer to card issuer or use another card
60074Different value than that used for PIN encryption errorsRefer to card issuer or use another card
60075Allowable number of PIN entry tries exceededRefer to card issuer or use another card
60076Unsolicited reversal(Visa use only) or Invalid/nonexistent "To Account" specified(Mastercard use only)Refer to card issuer or use another card
60077Invalid/nonexistent "From Account" specifiedRefer to card issuer or use another card
60078Blocked, first used or special condition—new cardholder not activated, or card is temporarily blocked(Visa use only) or Invalid/nonexistent account specified (general)(Mastercard use only)1. Contact card issuer to confirm activation;
2. Use another card
60079Reversed (by switch)(Visa use only) or Life cycle (Mastercard use only)1. Check card information and retry;
2. Contact card issuer;
3. Use another card
60080No financial impact (used in reversal responses to declined originals)(Visa use only) or System not available(Mastercard use only)1. Check card information and retry;
2. Contact card issuer;
3. Use another card
60081Cryptographic error found in PIN (used for cryptographic error condition found by security module during PIN decryption)(Visa use only) or Domestic Debit Transaction Not Allowed (Regional use only)(Mastercard use only)1. Check card information and retry;
2. Contact card issuer;
3. Use another card
60082Negative online CAM, dCVV, iCVV, CVV, CAVV, dCVV2, TAVV, or DTVV results(Visa use only) or Policy (Mastercard use only)1. Check card information and retry;
2. Contact card issuer;
3. Use another card
60083Fraud/Security (Mastercard use only)1. Check card information and retry;
2. Contact card issuer;
3. Use another card
60084Invalid Authorization Life Cycle1. Check card information and retry;
2. Contact card issuer;
3. Use another card
60086Cannot verify PIN; for instance, no PVV(Visa use only) or PIN Validation not possible(Mastercard use only)1. Retry same day;
2. Try non-PIN transaction if applicable
60087Purchase Amount Only, No Cash Back Allowed1. Check card information and retry;
2. Contact card issuer;
3. Use another card
60088Cryptographic failure1. Check card information and retry;
2. Contact card issuer;
3. Use another card
60089Ineligible to receive financial position information (GIV)(Visa use only) or Unacceptable PIN—Transaction Declined—Retry(Mastercard use only)1. Check card information and retry;
2. Contact card issuer;
3. Use another card
60090Cutoff is in progressRefer to card issuer or use another card
60091Issuer unavailable or switch inoperative (STIP not applicable or available for this transaction) or Time out when no STIP or Causes decline at POS.(Visa use only) or Authorization System or issuer system inoperative(Mastercard use only)1. Retry in 24 hours;
2. Contact card issuer;
3. Use another card
60092Financial institution or intermediate network facility cannot be found for routing (receiving institution ID is invalid)/Unable to route transactionContact service provider
60093Transaction cannot be completed, violation of law.Refer to card issuer. Do not retry
60094Duplication transaction detectedCheck if transaction has already been successful
60096System malfunction1. Check card information and retry;
2. Contact card issuer;
3. Use another card
60100Exceeds authentication frequency limit1. Contact card issuer;
2. Use another card;
3. Contact service provider
60101Cancelled1. Contact card issuer;
2. Use another card;
3. Contact service provider
60102Duplicate transactionCheck if transaction has already been successful
60103Soft declineUse another card or enforce 3DS challenge
60104Hard declineDo not retry
60105Refund failedContact service provider
60106The user failled to pay within the specified time and the order is closed due to timeoutComplete payment within the specified time
60129Suspected Counterfeit Card1. Contact card issuer;
2. Use another card
6001AAdditional customer authentication requiredUse another card or enforce 3DS authentication
6001ZAuthorization system inoperativeRefer to card issuer or use another card
6006PVerification data failed1. Check card information and retry;
2. Complete 3DS authentication;
3. Use another card
600B1Surcharge amount not permitted on Visa cards or EBT food stamps (U.S. acquirers only)Use another card
600B2Surcharge amount not supported by debit network issuer.Use another card
600N0Force STIP. Issuers can respond with this, which routes transaction to STIP. Issuers use code when they cannot perform authorization but want STIP to perform it.1. Check card information and retry;
2. Complete 3DS authentication;
3. Use another card
600N3Cash service not available1. Contact card issuer;
2. Retry later;
3. Change amount;
4. Use another card
600N4Cash request exceeds issuer or approved limit1. Contact card issuer;
2. Change amount;
3. Use another card
600N5Ineligible for resubmission1. Contact card issuer;
2. Use another card
600N7Decline for CVV2 failure1. Check card information and retry;
2. Contact card issuer;
3. Use another card
600N8Transaction amount exceeds preauthorized approval amountCheck if capture amount is lower than authorized amount
600P5Denied PIN unblock—PIN change or unblock request declined by issuerRefer to card issuer or use another card
600P6Denied PIN change—requested PIN unsafeRefer to card issuer or use another card
600Q1Card Authentication failed1. Check card information and retry;
2. Contact card issuer;
3. Use another card
600R0Stop this payment Visa ReservedDo not retry. Contact service provider
600R1Stop all future payments Visa ReservedDo not retry. Contact service provider
600R2Transaction does not qualify for Visa PINRefer to card issuer or use another card
600R3Stop all merchants Visa ReservedDo not retry. Contact service provider
600Z3Unable to go online; offline declined1. Check card information and retry;
2. Contact card issuer;
3. Use another card

General errors (70xxx)

CodeMessageSuggested action
70001Common declineContact service provider
70002Unknown declineContact service provider

Test Cards

Use these test card numbers in sandbox environment to simulate different payment scenarios before going live.

Restricted Countries

List of countries and regions where Onerway payment services are not available due to regulatory or compliance requirements.