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 methods.
Handling Callbacks of Form Events
1.1. Build Forms based on payment methods.
Use the payment forms mentioned below according to the payment method
All these forms should have the same class name for common styling and different id's for identification.
You can add input type ‘offers’ if you are using Juspay’s offer Module. Click here 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.
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.
1.3 Card Form Validation
Juspay JS will validate the card elements. Merchants are only expected to handle the validation events.
|
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.
|
Country code (ISO 3166-2)
|
Country Name
|
|---|---|
AD
| Andorra
|
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
|

