3. Implement Payv3 Forms

This is the part you can build with your web framework, or by hand in HTML - whatever way you're used to building forms on the web.Build Forms based on payment methodslink icon. link iconHandling Callbacks of Form Eventslink icon

1.1. Build Forms based on payment methods.

Use the payment forms mentioned below according to the payment method

Warning

All these forms should have the same class name for common styling and different id's for identification.

For Cards
For Saved Cards
For Netbanking
For UPI Collect
For Wallets
EMI
Note

You can add input type ‘offers’ if you are using Juspay’s offer Module. Click herelink icon to know more about Juspay’s offer Module.

1.2. Handling Callbacks of Form Events

Pay-v3.js listens to the form submit event and transports the card information safely to process it for payment. This is accomplished by the following snippet.

Warning

Before using the Juspay.Setup() function, ensure that the form or payment form has been rendered. The Juspay.Setup() function should be called only after the form has been fully rendered to ensure proper functionality.

Cards
Saved Cards
Netbanking, Wallets and UPI Collect

1.3 Card Form Validation

Note

Juspay JS will validate the card elements. Merchants are only expected to handle the validation events.

Scroll inside to view more
Events
Values
Description
event.target_element
card_number/ name_on_card/ card_exp_month/ card_exp_year/ security_code
Name of the field which generated this event
event.type
focus/ blur/ keyup/ change
This field explains the event type which triggered the event callback
event.valid
true/ false
This field explains whether the value inside the input field of target_element is valid or not
event.empty
true/ false
This field explains whether the input field of target_element is empty or not
event.card_brand
MASTERCARD/ VISA/ MAESTRO/ AMEX/ DINERS/ DISCOVER/ JCB/ RUPAY
Card brand value of the card number (Available only when target_element is card_number)
event.card_isin
Card bin value of the card number (Available only when target_element is card_number)
event.card_type
DEBIT/ CREDIT
Card type identifier of the card number (Available only when target_element is card_number)
event.card_sub_type
Only available for >= 9 digit card bin requests)
event.partially_valid
This field explains whether the user is typing the card number correctly (Available only when target_element is card_number)
event.expiry_valid
This field explains whether the combination of month or year is valid or not. There may be a case when the input year is the current year and the input month is any month before the current month, then you will get valid=true for both month and year separately, but together they are not valid. To keep such cases in mind, you need to validate whether expiry_valid is true or not. (Available only when target_element is either card_exp_month or card_exp_year)
event.mandate_support
true/ false
This field explains whether the card number entered is eligible for the mandate transaction
event.bank
(Only available for >= 9 digit card bin requests)
event.tokenize_support
This field provides tokenize support response for a particular card bin

Country Code ISO Mapping Table.

Scroll inside to view more
Country code (ISO 3166-2)
Country Name
AE
United Arab Emirates
AF
Afghanistan
AG
Antigua and Barbuda
AI
Anguilla
AL
Albania
AM
Armenia
AO
Angola
AQ
Antarctica
AR
Argentina
AS
American Samoa
AT
Austria
AU
Australia
AW
Aruba
AX
Åland Islands
AZ
Azerbaijan
BA
Bosnia and Herzegovina
BB
Barbados
BD
Bangladesh
BE
Belgium
BF
Burkina Faso
BG
Bulgaria
BH
Bahrain
BI
Burundi
BJ
Benin
BL
Saint Barthélemy
BM
Bermuda
BN
Brunei Darussalam
BO
Bolivia, Plurinational State of
BQ
Bonaire, Sint Eustatius and Saba
BR
Brazil
BS
Bahamas
BT
Bhutan
BV
Bouvet Island
BW
Botswana
BY
Belarus
BZ
Belize
CA
Canada
CC
Cocos (Keeling) Islands
CD
Congo, Democratic Republic of the
CF
Central African Republic
CG
Congo
CH
Switzerland
CI
Côte d'Ivoire
CK
Cook Islands
CL
Chile
CM
Cameroon
CN
China
CO
Colombia
CR
Costa Rica
CU
Cuba
CV
Cabo Verde
CW
Curaçao
CX
Christmas Island
CY
Cyprus
CZ
Czechia
DE
Germany
DJ
Djibouti
DK
Denmark
DM
Dominica
DO
Dominican Republic
DZ
Algeria
EC
Ecuador
EE
Estonia
EG
Egypt
EH
Western Sahara
ER
Eritrea
ES
Spain
ET
Ethiopia
FI
Finland
FJ
Fiji
FK
Falkland Islands (Malvinas)
FM
Micronesia, Federated States of
FO
Faroe Islands
FR
France
GA
Gabon
GB
United Kingdom of Great Britain and Northern Ireland
GD
Grenada
GE
Georgia
GF
French Guiana
GG
Guernsey
GH
Ghana
GI
Gibraltar
GL
Greenland
GM
Gambia
GN
Guinea
GP
Guadeloupe
GQ
Equatorial Guinea
GR
Greece
GS
South Georgia and the South Sandwich Islands
GT
Guatemala
GU
Guam
GW
Guinea-Bissau
GY
Guyana
HK
Hong Kong
HM
Heard Island and McDonald Islands
HN
Honduras
HR
Croatia
HT
Haiti
HU
Hungary
ID
Indonesia
IE
Ireland
IL
Israel
IM
Isle of Man
IN
India
IO
British Indian Ocean Territory
IQ
Iraq
IR
Iran, Islamic Republic of
IS
Iceland
IT
Italy
JE
Jersey
JM
Jamaica
JO
Jordan
JP
Japan
KE
Kenya
KG
Kyrgyzstan
KH
Cambodia
KI
Kiribati
KM
Comoros
KN
Saint Kitts and Nevis
KP
Korea, Democratic People's Republic of
KR
Korea, Republic of
KW
Kuwait
KY
Cayman Islands
KZ
Kazakhstan
LA
Lao People's Democratic Republic
LB
Lebanon
LC
Saint Lucia
LI
Liechtenstein
LK
Sri Lanka
LR
Liberia
LS
Lesotho
LT
Lithuania
LU
Luxembourg
LV
Latvia
LY
Libya
MA
Morocco
MC
Monaco
MD
Moldova, Republic of
ME
Montenegro
MF
Saint Martin (French part)
MG
Madagascar
MH
Marshall Islands
MK
North Macedonia
ML
Mali
MM
Myanmar
MN
Mongolia
MO
Macao
MP
Northern Mariana Islands
MQ
Martinique
MR
Mauritania
MS
Montserrat
MT
Malta
MU
Mauritius
MV
Maldives
MW
Malawi
MX
Mexico
MY
Malaysia
MZ
Mozambique
NA
Namibia
NC
New Caledonia
NE
Niger
NF
Norfolk Island
NG
Nigeria
NI
Nicaragua
NL
Netherlands, Kingdom of the
NO
Norway
NP
Nepal
NR
Nauru
NU
Niue
NZ
New Zealand
OM
Oman
PA
Panama
PE
Peru
PF
French Polynesia
PG
Papua New Guinea
PH
Philippines
PK
Pakistan
PL
Poland
PM
Saint Pierre and Miquelon
PN
Pitcairn
PR
Puerto Rico
PS
Palestine, State of
PT
Portugal
PW
Palau
PY
Paraguay
QA
Qatar
RE
Réunion
RO
Romania
RS
Serbia
RU
Russian Federation
RW
Rwanda
SA
Saudi Arabia
SB
Solomon Islands
SC
Seychelles
SD
Sudan
SE
Sweden
SG
Singapore
SH
Saint Helena, Ascension and Tristan da Cunha
SI
Slovenia
SJ
Svalbard and Jan Mayen
SK
Slovakia
SL
Sierra Leone
SM
San Marino
SN
Senegal
SO
Somalia
SR
Suriname
SS
South Sudan
ST
Sao Tome and Principe
SV
El Salvador
SX
Sint Maarten (Dutch part)
SY
Syrian Arab Republic
SZ
Eswatini
TC
Turks and Caicos Islands
TD
Chad
TF
French Southern Territories
TG
Togo
TH
Thailand
TJ
Tajikistan
TK
Tokelau
TL
Timor-Leste
TM
Turkmenistan
TN
Tunisia
TO
Tonga
TR
Türkiye
TT
Trinidad and Tobago
TV
Tuvalu
TW
Taiwan, Province of China[note 1]
TZ
Tanzania, United Republic of
UA
Ukraine
UG
Uganda
UM
United States Minor Outlying Islands
US
United States of America
UY
Uruguay
UZ
Uzbekistan
VA
Holy See
VC
Saint Vincent and the Grenadines
VE
Venezuela, Bolivarian Republic of
VG
Virgin Islands (British)
VI
Virgin Islands (U.S.)
VN
Viet Nam
VU
Vanuatu
WF
Wallis and Futuna
WS
Samoa
YE
Yemen
YT
Mayotte
ZA
South Africa
ZM
Zambia
ZW
Zimbabwe
Last updated 4 months ago