JS SDK

JS SDK is a library that will help you integrate with the API SDK

All you have to do is create your own form and call the corresponding method in the JS SDK

In order to use this mechanics, the merchant must install the script on their site. The script will collect site data and securely encrypt it. Then this data will be sent to the API in the form of a token

To use the JS SDK, you need to contact your personal manager

Initialization

To initialize the SDK, you need to add the following code to the head:

Now you have the SDK object available, set your publickey and token:

publickey and token can be obtained from your manager

Description of SDK methods

Getting a token:

JSTokenizeOptionsBankCard:

Name	Type	Description
type	string	Type of encrypted data. `bank_card` - bank card
options.card_number	string	Card number. The card number input field must support input of 13 to 19 digits
options.card_holder_name	string	Cardholder name
options.card_exp_month	string	Card expiration month
options.card_exp_year	string	Card expiration year

Once you receive the token, you can use it to make a payment

One-step payment

JSPaymentOptions:

Name	Type	Description
order_id	string	Unique identifier in the store system
auto_clearing	integer	1 - if clearing is required automatically, 0 - if the merchant calls the clearing method himself
amount	float	Payment amount
currency	string	Payment currency
description	string	Payment description
test	integer	1 - if test payment mode, 0 - if combat
options.custom_params	object	Additional parameters. Will be sent back to the merchant at ResultURL after the payment is made
options.user.email	string	Client's email
options.user.phone	string	Client's phone number

JSTransactionOptionsBankCardToken:

Name	Type	Description
type	string	Type of data transferred. tokenized_card - transfer of card token
options.token	string	Previously received card token
options.card_cvv	integer	CVC/CVV of the card for which the token was made

JS3dsv1AcsOptions:

Name	Type	Description
pares	string	Parameter that comes to termUrl
md	string	Parameter that comes to termUrl

JSTransactionOptionsBankCard:

Name	Type	Description
type	string	Type of data transferred. bank_card - transfer of open card data
options.card_number	string	Card number. The card number input field must support input of 13 to 19 digits.
options.card_holder_name	string	Cardholder name
options.card_exp_month	string	Card expiration month
options.card_exp_year	string	Card expiration year
options.card_cvv	integer	CVC/CVV cards

Responses

JSPayResult:

Name	Type	Description
payment_id	integer	Type of data transferred. bank_card - transfer of open card data
order_id	string	Card number. The card number input field must support input of 13 to 19 digits
payment_status	string	Cardholder name
3ds	object	Card expiration month
3ds.version	string	Card expiration year
3ds.acsurl	string	CVC/CVV cards
3ds.md	string	Card expiration year
3ds.pareq	string	CVC/CVV cards
3ds.frame_url	string	CVC/CVV cards

JSTokenResponse:

Name	Type	Description
token	integer	Token for further payment

JSErrorObject:

Name	Type	Description
response.error_code	string	Error code
response.error_message	string	Error description

If JSPayResult.payment_status = need_confirm came there are several mechanics of passing 3DS:

On the SDK side

The entire 3DS process takes place on the js sdk side, the only thing the merchant needs to do is create a DOM element with id="3dsForm", in it the payer will enter 3DS data

The recommended size of the DOM element is 550px X 600px

The id property can be changed when calling the confirmInIframe(JSPayResult, "myCustom3dsElement") function

At this point, the merchant must prepare the container (3dsForm) for correct display to the client. For example, open a pop-up window, remove the form and show the container, etc

Request for confirmInIframe

Own implementation of 3ds shape processing

When requesting a charge, if 3ds is installed on the card, it is necessary to make a request to the ACS server of the card issuer bank

If it is necessary to pass 3ds, the response to the call to the charge method will be JSPayResult.payment_status = need_confirm and an additional 3ds object with JS3dsv1Object parameters

Name	Type	Description
PaReq	string	The pareq parameter from the response
MD	string	Parameter md from the response
TermUrl	string	Url to which the client will be transferred after completing 3DS

If successful, a POST request with the following parameters will be sent to TermUrl:

Name	Type	Description
PaRes	string	The parameter is required for the paymentAcs request
MD	string	The parameter is required for the paymentAcs request

После получения этих параметров, требуется сделать запрос на confirm3dsv1:

Initialization#

Description of SDK methods#

Getting a token:#

One-step payment#

Responses#

On the SDK side#

Own implementation of 3ds shape processing#

Example of full integration#

Initialization

Description of SDK methods

Getting a token:

One-step payment

Responses

On the SDK side

Own implementation of 3ds shape processing

Example of full integration