NAV
docs

Server APIs

Frontend SDK Error Code

Web SDK Error Code

status msg
-8 [LINE Pay] failed to get prime
-7 [Google Pay] failed to get prime
-6 [Apple Pay] failed to get prime
-5 Unknown Error
-3 failed to get prime
-1 SDK Loading Error
- -
0 Success
5 Wrong JSON format
- -
11 App ID not found
12 App name mismatch
13 Unknown app error
16 App key mismatch
- -
41 Wrong Card Format
- -
80 Invaild x-api-key or app key
81 Partner not found
84 Partner unauthorized
- -
122 Card encrypt error
- -
401 Request Cancel, please see the defail of msg
402 Can not obtain payment data, please see the defail of msg
403 [Apple Pay] Get Session error: {Message from apple}
404 [Payment Request API] Unexcept Error, for detail please see originalError
421 Gateway Timeout
422 Authorization Timeout
- -
530 Invalid arguments : app_id
531 Missing arguments : app_key
532 Missing arguments : app_name
533 Missing arguments : card_number
534 Missing arguments : card_expiry_date
570 Out of range : app_key
571 Out of range : app_name
572 Out of range : card_number
573 Out of range : card_expiry_date
574 Out of range : card_ccv
589 Invalid arguments : platform_type
590 Missing arguments : android_merchant_id
591 Missing arguments : pay_token_data
592 Missing arguments : apple_merchant_id
594 Out of range : apple_merchant_id
598 Out of range : android_merchant_id
599 Missing arguments : pay_token_data > ephemeralPublicKey
- -
600 Missing arguments : pay_token_data > encryptedMessage
601 Missing arguments : pay_token_data > tag
602 Out of range : pay_token_data > ephemeralPublicKey
603 Out of range : pay_token_data > encryptedMessage
604 Out of range : pay_token_data > tag
605 Missing arguments : pay_token_data > data
606 Missing arguments : pay_token_data > version
607 Missing arguments : pay_token_data > signature
608 Missing arguments : pay_token_data > header > ephemeralPublicKey
609 Missing arguments : pay_token_data > header > publicKeyHash
610 Missing arguments : pay_token_data > header > transactionId
611 Out of range : pay_token_data > data
612 Out of range : pay_token_data > version
613 Out of range : pay_token_data > header > ephemeralPublicKey
614 Out of range : pay_token_data > header > publicKeyHash
615 Out of range : pay_token_data > header > transactionId
616 Missing arguments : pay_token_data > header
617 Out of range : fraud_id
618 Out of range : pay_token_data > protocolVersion
619 Out of range : pay_token_data > signature
626 Invalid arguments : platform_type
634 Missing arguments : pay_token_data > protocolVersion
638 Missing arguments : merchant_app_launch_uri
639 Out of range : merchant_app_launch_uri
655 Missing arguments : reference_id
660 Out of range : reference_id
- -
915 System error, please contact TapPay customer service
916 Signature verification is not proceed
917 Signature verification error
930 Samsung Pay merchant not found
- -
2000 [Direct Pay] Card number is empty
2001 [Direct Pay] Card month/year is empty
2012 [Direct Pay] CCV is wrong format
2013 Expired Card
2200 [Google Pay] Unexcept Error, for detail please see originalError
- -
10028 Samsung Pay error
- -
13002 This apple pay merchant identifier is disabled
- -
21001 Samsung Pay Error (Original Message from Samsung Pay)
21002 Samsung Pay Error (The Internet is unavailable)

Android SDK Error Code

status msg
-4 Unknown Error
-3 Internet Unavailable
- -
0 Success
5 Wrong JSON format
- -
11 App ID not found
12 App name mismatch
13 Unknown app error
16 App key mismatch
- -
30 Device not support
31 iOS SDK version is too old
32 Android SDK version is too old
33 SDK version is not sent
- -
41 Wrong card format
- -
80 Invaild x-api-key or app key
81 Partner not found
84 Partner unauthorized
- -
122 Card encrypt error
- -
421 Gateway Timeout
422 Authorization Timeout
- -
530 Invalid arguments : app_id
531 Missing arguments : app_key
532 Missing arguments : app_name
533 Missing arguments : card_number
534 Missing arguments : card_expiry_date
570 Out of range : app_key
571 Out of range : app_name
572 Out of range : card_number
573 Out of range : card_expiry_date
574 Out of range : card_ccv
581 Invalid arguments : devicetype
582 Invalid arguments : sdkversion
583 Out of range : deviceInfo > deviceIdentifier
584 Out of range : deviceInfo > deviceModel
585 Out of range : deviceInfo > deviceOsVersion
586 Out of range : geoloc
589 Invalid arguments : platform_type
590 Missing arguments : android_merchant_id
591 Missing arguments : pay_token_data
598 Out of range : android_merchant_id
599 Missing arguments : pay_token_data > ephemeralPublicKey
- -
600 Missing arguments : pay_token_data > encryptedMessage
601 Missing arguments : pay_token_data > tag
602 Out of range : pay_token_data > ephemeralPublicKey
603 Out of range : pay_token_data > encryptedMessage
604 Out of range : pay_token_data > tag
605 Missing arguments : pay_token_data > data
606 Missing arguments : pay_token_data > version
607 Missing arguments : pay_token_data > signature
611 Out of range : pay_token_data > data
612 Out of range : pay_token_data > version
617 Out of range : fraud_id
618 Out of range : pay_token_data > protocolVersion
619 Out of range : pay_token_data > signature
626 Invalid arguments : platform_type
634 Missing arguments : pay_token_data > protocolVersion
638 Missing arguments : merchant_app_launch_uri
639 Out of range : merchant_app_launch_uri
656 Missing arguments : samsung_merchant_id
657 Out of range : samsung_merchant_id
658 Missing arguments : pay_token_data > type
659 Out of range : pay_token_data > type
801 Missing arguments : merchant_app_launch_uri or merchant_universal_link
802 Doesn’t support merchant_app_launch_uri or merchant_universal_links concurrently
803 Out of range : merchant_universal_links
- -
915 System error, please contact TapPay customer service
916 Signature verification is not proceed
917 Signature verification error
930 Samsung Pay merchant not found
- -
1001 Certificate server connection exception (http status code: {http status code})
1002 Certificate local connection exception (exception message: {exception message})
1003 Certificate data error
- -
10028 Samsung Pay error
- -
88004 Parameter Format Error
88007 Input Form Not Set
88008 LINE Pay is unavailable
88009 Can not obtain payment data
88010 Invalid data for parsing LINE Pay Result
88011 Samsung Pay Error
88012 Samsung Pay canceled by user

iOS SDK Error Code

status msg
0 Success
5 Wrong JSON format
- -
11 App ID not found
12 App name mismatch
13 Unknown app error
16 App key mismatch
- -
30 Device not support
31 iOS SDK version is too old
32 Android SDK version is too old
33 SDK version is not sent
- -
41 Wrong card format
- -
80 Invaild x-api-key or app key
81 Partner not found
84 Partner unauthorized
- -
122 Card encrypt error
- -
421 Gateway Timeout
422 Authorization Timeout
- -
530 Invalid arguments : app_id
531 Missing arguments : app_key
532 Missing arguments : app_name
533 Missing arguments : card_number
534 Missing arguments : card_expiry_date
570 Out of range : app_key
571 Out of range : app_name
572 Out of range : card_number
573 Out of range : card_expiry_date
574 Out of range : card_ccv
581 Invalid arguments : devicetype
582 Invalid arguments : sdkversion
583 Out of range : deviceInfo > deviceIdentifier
584 Out of range : deviceInfo > deviceModel
585 Out of range : deviceInfo > deviceOsVersion
586 Out of range : geoloc
589 Invalid arguments : platform_type
591 Missing arguments : pay_token_data
592 Missing arguments : apple_merchant_id
594 Out of range : apple_merchant_id
- -
600 Missing arguments : pay_token_data > encryptedMessage
605 Missing arguments : pay_token_data > data
606 Missing arguments : pay_token_data > version
607 Missing arguments : pay_token_data > signature
608 Missing arguments : pay_token_data > header > ephemeralPublicKey
609 Missing arguments : pay_token_data > header > publicKeyHash
610 Missing arguments : pay_token_data > header > transactionId
611 Out of range : pay_token_data > data
612 Out of range : pay_token_data > version
613 Out of range : pay_token_data > header > ephemeralPublicKey
614 Out of range : pay_token_data > header > publicKeyHash
615 Out of range : pay_token_data > header > transactionId
616 Missing arguments : pay_token_data > header
617 Out of range : fraud_id
626 Invalid arguments : platform_type
638 Missing arguments : merchant_app_launch_uri
639 Out of range : merchant_app_launch_uri
801 Missing arguments : merchant_app_launch_uri or merchant_universal_link
802 Doesn’t support merchant_app_launch_uri or merchant_universal_links concurrently
803 Out of range : merchant_universal_links
- -
915 System error, please contact TapPay customer service
- -
1001 Certificate server connection exception (http status code: {http status code})
1002 Certificate local connection exception (exception message: {exception message})
1003 Certificate data error
- -
88001 SDK Is Not Activate
88003 Lost Parameter
88009 Can not obtain Apple Pay payment data
88010 Please Running on the Device
88012 Invalid cart setting . While isAmountPending is false , it should not have pending item.
88013 isAmountPending and isShowTotalAmount couldn’t be false at the same time.
88014 Total amount couldn’t be displayed if there is only pending items.
88015 isAmountPending must be true if the amount of payment item is pending.
88016 paymentItem amount could’t not be 0.00

Backend API Error Code

status msg
0 Success
2 End of list
4 IP mismatch
5 Wrong JSON format
- -
41 Wrong card format
43 Card unauthorized access
- -
61 Merchant not found or removed
66 Not a line pay merchant
67 This merchant does not support this payment method
68 This merchant does not support refund cancel
70 TapPay doesn’t support cardholder verify function (KYC) of this bank
71 This merchant does not support instalment
72 This merchant only support instalment
74 This merchant does not support 3DS2.0
75 This merchant does not support non-3D secure
- -
80 Invaild x-api-key or app key
81 Partner not found
84 Partner unauthorized
89 This merchant does not support this currency
- -
91 Expired prime
92 The acquirer doesn’t support void auth date is different from the auth date. Error handling
- -
121 Invalid arguments : prime
122 Card encrypt error
- -
126 Barcode not found
127 Barcode is expired
128 Barcode has been use
129 Member not found
130 Merchant group not found
131 Merchant group setting error
132 On-us merchant not found
141 This partner does not support amount pending
- -
421 Gateway Timeout
422 Authorization Timeout
- -
501 Missing arguments : cardholder
502 Missing arguments : merchant_id
503 Missing arguments : prime
504 Missing arguments : currency
505 Missing arguments : details
506 Missing arguments : partner_key
507 Missing arguments : cardholder > phone_number
508 Missing arguments : cardholder > name
509 Missing arguments : cardholder > email
510 Invalid arguments : amount
511 Invalid arguments : instalment
512 Invalid arguments : delay_capture_in_days
513 Out of range : instalment
514 Out of range : delay_capture_in_days
515 Out of range : details
516 Out of range : currency
517 Out of range : order_number
518 Out of range : bank_transaction_id
519 Out of range : cardholder > phone_number
520 Out of range : cardholder > name
521 Out of range : cardholder > email
522 Out of range : cardholder > addr
523 Out of range : cardholder > zip
524 Out of range : cardholder > national_id
525 Out of range : cardholder > member_id
526 Missing arguments : card_key
527 Missing arguments : card_token
528 Out of range : card_key
529 Out of range : card_token
- -
535 Invalid arguments : records_per_page
536 Invalid arguments : page
537 Invalid arguments : filters > time > start_time
538 Invalid arguments : filters > time > end_time
539 Invalid arguments : filters > rec_trade_id
545 Invalid arguments : filters > amount > upper_limit
546 Invalid arguments : filters > amount > lower_limit
547 Invalid arguments : filters > app_id
548 Invalid arguments : filters > merchant_id
549 Invalid arguments : filters > record_status
550 Invalid arguments : order_by > attribute
551 Invalid arguments : order_by > is_descending
559 Out of range : records_per_page
560 Out of range : page
561 Out of range : filters > time > start_time
562 Out of range : filters > time > end_time
563 filters > time > start_time can’t be later than the end_time
564 Out of range : filters > amount > upper_limit
565 Out of range : filters > amount > lower_limit
566 filters > amount > lower_limit can’t be larger than the upper_limit
567 Out of range : filters > app_id
568 Out of range : order_number
569 Out of range : bank_transaction_id
574 Out of range : card_ccv
578 Out of range : additional_data
587 Out of range : partner_key
588 Invalid arguments : delay_capture_in_days
589 Invalid arguments : platform_type
590 Missing arguments : android_merchant_id
591 Missing arguments : pay_token_data
592 Missing arguments : apple_merchant_id
593 Out of range : merchant_id
594 Out of range : apple_merchant_id
595 Out of range : delay_capture_in_days
596 Missing arguments : rec_trade_id
597 Out of range : rec_trade_id
617 Out of range : fraud_id
622 Missing arguments : member_id
627 Invalid arguments : result_url > backend_notify_url
628 Invalid arguments : result_url > frontend_redirect_url
629 Missing arguments : result_url > backend_notify_url
630 Missing arguments : result_url > frontend_redirect_url
631 Missing arguments : result_url
632 Acquirer doesn’t support 3D Secure.
633 3D Secure get redirect url error
635 Acquirer doesn’t support instalment
636 Acquirer doesn’t support redeem
637 Acquirer doesn’t support instalment and redeem concurrently
643 Invalid arguments : additional_data
644 Invalid arguments : line_pay_product_image_url
669 Out of range : request_id
670 Out of range : refund_id
691 Acquirer doesn’t Support Non-3D Secure.
- -
693 Missing Arguments : barcode
694 Out of range: barcode
695 Out of range: barcode_length
696 Out of range: barcode_update_secs
697 Invalid arguments : barcode_length
698 Invalid arguments : barcode_update_sec
699 Invalid argument : barcode
700 Invalid argument : retry_mode
701 Doesn’t support merchant_id and merchant_group_id concurrently
706 Out of range : bank_refund_id
708 Invalid arguments : bank_refund_id
713 Partner doesn’t support sub_merchant
804 Invalid arguments : no_rebate_amount
- -
810 Invalid arguments : payment_method
811 Out of range : branch_code
812 Out of range : branch_name
813 Out of range : pos_id
- -
814 Missing arguments : easy_wallet_secure_code
815 Invalid arguments : easy_wallet_secure_code
816 Missing arguments : easy_wallet_contract_no
817 Invalid arguments : easy_wallet_contract_no
822 Search time period can not be more than 90 days
823 Missing arguments : easy_wallet_ftps_account
824 Invalid arguments : easy_wallet_ftps_account
825 Missing arguments : easy_wallet_ftps_password
826 Invalid arguments : easy_wallet_ftps_password
827 Ftps connection failed due to wrong easy_wallet_ftps_account or easy_wallet_ftps_password
828 Easy Wallet upload path not found
829 Easy Wallet download path not found
835 easy_wallet_ftps_account mismatch with existed merchant
836 easy_wallet_ftps_password mismatch with existed merchant
837 fubon_sftp_account mismatch with existed merchant
838 fubon_sftp_password mismatch with existed merchant
839 fubon_sftp_upload_path mismatch with existed merchant
840 fubon_sftp_download_path mismatch with existed merchant
843 Invalid arguments > product_image_url
844 Out of range : product_image_url
845 Out of range : event_code
846 Invalid arguments : merchant_unversal_links
856 Does not support merchant_ids and acquirers concurrently
857 Missing arguments : transaction_actions
858 Invalid arguments : transaction_actions
860 Missing arguments : emails
861 Invalid arguments : merchant_ids
862 Out of range : kyc_verification_merchant_id
863 national_id must be verified in identity verification (KYC)
864 kyc_verification_merchant_id is only allowed for identity verification (KYC)
865 Missing arguments : nccc_terminal_id
866 Bank not support identity verification (KYC)
867 Out of range : description
868 You have to update at least one cardholder information
889 Out of range : payment_number
890 Out of range : nccc_terminal_id
891 Cardholder not found
892 Out of range : phone_number
893 Out or range : name
894 Out of range : email
895 Out of range : address
896 Out of range : zip
897 Out of range : national_id
898 Out of range : member_id
899 Invalid arguments : acquirers
947 EasyWallet transaction not found
950 EasyWallet get redirect url error
- -
900 Service suspension due to system upgrade
901 Decrypt payment data error
904 Merchant’s acquirer not found
905 Apple Pay transaction not found
906 Apple Pay order id already exist
907 Android Pay transaction not found
908 Android Pay order id already exist
909 Inconsistent amount
910 Inconsistent currency
911 Apple merchant not found
912 Android merchant not found
915 System error, please contact TapPay customer service
916 Signature verification is not proceed
917 Signature verification error
919 PaymentMethodToken expired
920 Message decryption is not proceed
- -
922 LINE Pay get redirect url error
923 LINE Pay transaction not found
924 LINE Pay order is canceled
- -
925 Three Domain Secure’s order is canceled
- -
926 Acquirer doesn’t support this currency
- -
930 Samsung Pay merchant not found
931 Samsung Pay order id already exist
932 Samsung Pay transaction not found
- -
934 Incorrect status [Transaction has been Captured, it could not be canceled]
935 Incorrect status [Transaction does not arrange capture, it could not be canceled]
936 Incorrect status [Transaction is capturing, it could not be canceled]
- -
937 This card does not support this function
939 Request processing
940 Invalid transaction status
941 Transaction arguments mismatch
942 Invalid environment
943 JKOPAY get redirect url error
944 JKOPAY transaction not found
946 Do not support refund during bank capturing
- -
948 Previous process is still accessing, please try again later
949 Previous request is still accessing, please try again later
- -
1001 Direct Pay transaction not found
- -
2011 Card not found, Invalid token
2012 Card key error
2013 Card expired
4002 Invalid arguments : rec_trade_id
4014 Repeated refund
- -
5001 Kyc verification merchant not found
5002 Identity verification (KYC) failed
5003 Identity verification (KYC) exception happened
5004 national_id can’t be empty in identity verification (KYC)
5005 phone_number can’t be empty if it is in need of identity verification (KYC)
5006 This acquirer not support identity verification (KYC)
5007 Can not recognize card issuer if this acquirer not support off-us card in identity verification (KYC)
5008 This acquirer not support off-us card in identity verification (KYC)
5009 This acquirer not support verify phone number in identity verification (KYC)
- -
6001 Duplicate bank_transaction_id
6002 Duplicate bank_refund_id
- -
8001 Partner doesn’t support TSP
8002 Missing arguments : tsp_enable
8003 Invalid arguments : tsp_enable
8004 Missing arguments : tsp_token
8005 Missing arguments : token_status
8006 Missing arguments : card_expiry_date
8007 Missing arguments : token_card_expiry_date
8008 Invalid arguments : token_status
8009 Invalid arguments : tsp_token
8010 Invalid arguments : width
8011 Invalid arguments : height
8012 Invalid arguments : tsp_notify_url
8013 Missing arguments : start_millis
8014 Missing arguments : end_millis
8015 Invalid arguments : start_millis
8016 Invalid arguments : end_millis
8017 Invalid arguments : end_millis (end_millis is less than start_millis)
8019 Missing arguments : tsp_notify_url
- -
9003 Out of range : rba_merchant_key
9017 Invalid arguments : challenge_lowest_score
9018 Missing arguments : fpan_bincodes or token_bincodes
9019 Invalid arguments : fpan_bincodes
9020 Invalid arguments : token_bincodes
9021 Missing arguments : affiliate_code_names
9022 Invalid arguments : affiliate_code_names
9023 Missing arguments : affiliate_code_group_name
9024 Invalid arguments : affiliate_code_group_name
9025 Invalid arguments : order_number
9026 Out of range : fpan_bincodes
9027 Out of range : token_bincodes
9028 Missing arguments : affiliate_code_name
9029 Invalid arguments : affiliate_code_name
9030 Out of range : prime
9031 Missing arguments : card_token or prime
9032 Missing arguments : bank_member_id
9037 Doesn’t support card_token and prime concurrently
- -
9051 Missing arguments : jko_pay_insurance_policy
9052 Missing arguments : jko_pay_insurance_policy > proposer
9053 Missing arguments : jko_pay_insurance_policy > insured
9054 Missing arguments : jko_pay_insurance_policy > final_price
9055 Missing arguments : jko_pay_insurance_policy > insurance_type
9056 Missing arguments : jko_pay_insurance_policy > policy_id
9057 Missing arguments : jko_pay_insurance_policy > payment_deadline
9058 Missing arguments : jko_pay_insurance_policy > payment_frequency
9059 Out of range : jko_pay_insurance_policy > proposer
9060 Invalid arguments : jko_pay_insurance_policy > final_price
9061 Out of range : jko_pay_insurance_policy > policy_id
9062 Invalid arguments : jko_pay_insurance_policy > payment_frequency
9063 Invalid arguments : jko_pay_insurance_policy > payment_deadline
- -
9118 Missing arguments : tsp_push_token
9119 Out of range : tsp_push_token
- -
10001 Transaction pending
10002 IP mismatch
10003 Wrong card, please ask for issuer
10004 Bank timeout
10005 Bank system error
10006 Duplicate transaction
10007 3D validate error
10008 Bank merchant account data error
10009 Amount error
10010 Transaction pending capture, can not refund
10011 Refund error. Please try again.
10012 Data format error
10013 Bank transaction id duplicate
10014 Invalid bank transaction id
10015 Redeem failed
10023 Bank error or TSP error
10024 Authorized transaction cannot be partially refunded
10025 Auth code mismatch error
10026 Bank transaction id mismatch error
10028 Samsung Pay error
10029 CTBC decrypt data error
10030 CTBC decrypt data invalid eci
10031 CTBC decrypt data missing errorCode
10032 Card CTBC decrypt data missing xid
10033 CTBC decrypt data missing cardNumber
10034 CTBC decrypt data missing expiry
10035 CTBC decrypt data missing eci
10036 Card number mismatch error
10037 Card expiry date mismatch error
10038 Redeem transaction cannot be partially refunded
10039 This merchant does not support this card type
- -
10042 Doesn’t support this card’s country code
10043 This card can’t find issuer’s country code
- -
10048 The transaction amount is 0, cannot be refunded
10049 The transaction amount is 0, cannot be captured
- -
10050 Out of range : amount
10051 Out of range : amount (refund amount must be less than or equal to remained amount)
10052 Confirm order timeout
- -
10055 Missing arguments : filters > time
10056 Missing arguments : filters
10057 Capture charge authorization expired
- -
11000 Invalid arguments : rec_trade_id
- -
12001 Rba doesn’t support transaction with merchant_id
12007 Merchant Group Setting not match rba recommendation
12008 Payment request not match rba recommendation
- -
13002 This apple pay merchant identifier is disabled
- -
14001 Affiliate code group not found
14002 Affiliate code not found
14003 Duplicate affiliate code
14004 Duplicate fpan bincode
14005 Duplicate token bincode
14006 Create affiliate code failed
14007 Delete affiliate code failed
14008 Update affiliate code failed
14009 Create bincode failed
14010 Delete bincode failed
14011 Fpan bincode exceeding single affiliate code limit
14012 Token bincode exceeding single affiliate code limit
- -
15001 Easy Wallet not support duplicate bank_member_id binding
15002 Easy Wallet token already canceled binding
- -
19004 Push-tokenize failed: REQUIRE_ADDITIONAL_AUTHENTICATION
- -
21001 Terminal Pay transaction not found
21002 Terminal Pay transaction cannot be partially refunded
- -
9999 System is under maintenance, please contact TapPay customer service

Portal API Error Code

status message
0 success
4 IP mismatch
- -
80 x-api-key is invalid.
82 Partner key mismatch
- -
209 Missing argument : request_type.
211 Invalid argument : request_type.
- -
450 Create affiliate code failed {detail error message}
451 fpan_bincodes length should be less than or equal to 50.
452 token_bincodes length should be less than or equal to 50.
453 Delete affiliate code failed {detail error message}
454 Create affiliate code group failed {detail error message}
455 affiliate_code_names length should be less than 50.
456 Delte affiliate code group failed {detail error message}
- -
9999 System is under maintenance, please contact TapPay customer service