NAV

Introduction

Welcome to the OnPay integration documentation, this documentation is directed at anyone wanting to integrate OnPay in their ecommerce solution.

If you have any questions regarding the documentation, please contact the support where you have your OnPay solution.

Receiving payments

To receive payments you will need to integrate the orderflow with OnPay.

Payment window v3

The current recommended way to receive new payments and subscriptions is through the Payment window.

Read the documentation here

API (processing payments)

It is possible to automate most of the tasks achieved through the management panel, through the API.

v1 API specification

Read the documentation here

JavaScript SDK

SDK providing tools for implementing interactivity on webpages.

Read the documentation here

Accepted currencies

OnPay accepts the following currencies. The list is based on the ISO4217 standard.

If you have any questions regarding the accepted currencies or proposals for other currencies, please contact the support where you have your OnPay solution.

Number Code Name Exponent
36 AUD Australian dollar 2
124 CAD Canadian dollar 2
156 CNY Chinese yuan 2
203 CZK Czech koruna 2
208 DKK Danish krone 2
352 ISK Icelandic króna 0
356 INR Indian rupee 2
392 JPY Japanese yen 0
554 NZD New Zealand dollar 2
578 NOK Norwegian krone 2
643 RUB Russian ruble 2
702 SGD Singapore dollar 2
710 ZAR South African rand 2
748 SZL Swazi lilangeni 2
752 SEK Swedish krona 2
756 CHF Swiss franc 2
818 EGP Egyptian pound 2
826 GBP Pound sterling 2
840 USD United States dollar 2
978 EUR Euro 2
980 UAH Ukrainian hryvnia 2
985 PLN Polish złoty 2
986 BRL Brazilian real 2

Test data

If test mode is activated on the merchant, it is possible to use the following test cards.

Any expiration date in the future will work, as well as any CVC.

Visa/Dankort

PAN Status
4571 9900 2080 0010 Accepted
4571 9900 2080 0028 Denied
4571 9900 2080 0036 Capture fails
4571 9900 2080 0044 Recurring fails

Dankort

PAN Status
5019 9900 2080 0017 Accepted
5019 9900 2080 0025 Denied
5019 9900 2080 0033 Capture fails
5019 9900 2080 0041 Recurring fails

Visa

PAN Status
4687 3800 2080 0015 Accepted
4687 3800 2080 0023 Denied
4687 3800 2080 0031 Capture fails
4687 3800 2080 0049 Recurring fails

MasterCard

PAN Status
5204 7400 2080 0011 Accepted
5204 7400 2080 0029 Denied
5204 7400 2080 0037 Capture fails
5204 7400 2080 0045 Recurring fails

Action/acquirer codes

Some codes returned are general, while others are acquirer specific.

General

Non acquirer specific errors are negative

Action code Description
-1 Communication error, acquirer may not be available
-2 Unknown error
-5 ACS denied, 3DSecure verification failed

Nets / Teller

The most common action codes are highlighted here

Action Code Description Transaction status Recommended action
001 Requires ID Decline  Do not try again. Contact card issuer or try with a different card.
100 Declined Decline  Try again once a day. If no success after 4 days contact card issuer
101 Expired card Decline/Expired card  Do not try again. Contact card issuer or try with a different card.
102 Suspected fraud Decline  Do not try again. Contact card issuer or try with a different card.
103 Contact acquirer Decline  Do not try again. Contact card issuer or try with a different card.
106 Blocked due to excess PIN tries Decline  Do not try again. Contact card issuer or try with a different card.
107 Contact issuer Decline Do not try again. Contact card issuer or try with a different card.
108 Contact issuer Decline  Do not try again. Contact card issuer or try with a different card.
109 Invalid merchant Decline  Contact Nets to verify acquirer data in OnPay
110 Invalid amount Decline/Amount error  Data error in payment window request. Correct data before trying again. Contact support for help.
116 Not sufficient funds on card Decline  Try again once a day. If no success after 4 days contact card issuer
118 Unknown card Decline  Do not try again. Contact card issuer or try with a different card.
119 Payment method not allowed for card Decline/Invalid transaction  Do not try again. Contact card issuer or try with a different card.
120 Transaction not permitted for merchant Declined/Invalid transaction  Contact Nets to verify acquirer data in OnPay
121 Exceeds withdrawal limit Decline  Data error in payment window request. Correct data before trying again. Contact support for help.
200 Declined Decline  Do not try again. Contact card issuer or try with a different card.
202 Suspected fraud Decline  Do not try again. Contact card issuer or try with a different card.
208 Lost card Decline  Do not try again. Contact card issuer or try with a different card.
209 Stolen card Decline  Do not try again. Contact card issuer or try with a different card.
210 Suspected counterfeit Decline  Do not try again. Contact card issuer or try with a different card.
900 Approved Approved  Transaction approved. No action required
902 Invalid transaction Declined  Data error in payment window request. Correct data before trying again. Contact support for help.
904 Format error contact Nets  Data error in payment window request. Correct data before trying again. Contact support for help.
909 System malfunction contact Nets  Try again once a day. If no success after 4 days contact card issuer
913 Duplicate transmission contact Nets  Try again once a day. If no success after 4 days contact card issuer
922 Out of sequence, contact support Contact Nets  Data error in payment window request. Correct data before trying again. Contact support for help.
945 Timeout Retransmit  Try again once a day. If no success after 4 days contact card issuer
946 Communication error, contact support Contact Nets Due to communication error, the connection to the transaction has been lost. Contact Nets support for the correct status.
984 No valid conversion for a field Declined  Data error in payment window request. Correct data before trying again. Contact support for help.

Further explanation

We have tried to add explanations for the error codes, based upon previous encounters of the error. Be aware that an error code can mean multiple things, so the explanation may not be correct for the specific case.

001

This transaction requires further identification of the cardholder, but since it is a e-commerce transaction this is not possible.

119

Typically seen when a card is not allowed to be used for e-commerce, in some circumstances the cardholder need to enable e-commerce shopping in their bank. Alternatively the transaction may succeed if done with 3D-Secure

120

This error is seen when attempting to do recurring transactions, but where the merchant agreement with the issuer is not enabled for recurring transactions. Contact Nets to get it corrected

984

Has been seen where a issuer has subscribed for Visa Payment Stop Service, and exhibits that it is impossible to withdraw money on a recurring transaction.

Clearhaus

The most common action codes are highlighted here

Action code Description Approved
20000 Approved Yes
40000 General input error No
40110 Invalid card number No
40111 Unsupported card scheme No
40120 Invalid CSC No
40130 Invalid expire date No
40135 Card expired No
40140 Invalid currency No
40150 Invalid text on statement No
40190 Invalid transaction No
40200 Clearhaus rule violation No
40300 3-D Secure problem No
40310 3-D Secure authentication failure No
40400 Backend problem No
40410 Declined by issuer or card scheme No
40411 Card restricted No
40412 Card lost or stolen No
40413 Insufficient funds No
40414 Suspected fraud No
40415 Amount limit exceeded No
50000 Clearhaus error No

Error codes

Error codes are always returned on callbacks in the onpay_errorcode parameter.

Error Code Description
0 Transaction approved without issue
1 Reference supplied is already used
2 Wallet Service communication error
3 Transaction cancelled or rejected
1000 Unknown error