Collecting Cardholder Data Details

Request Parameters

Two parameters are required for a request to the URL https://secure(-test).8b.world/pay/direct (HTTP POST):

data: Base64 encoded JSON document string.
sign: Signature formed on the data string.

JSON Document Parameters

Parameter Name	Type	Max Length	Description	Example
card_data.pan	String	16	Card number	4111111111111111
card_data.cvv*	Integer	3	CVV-code	333
card_data.exp_month	Integer	3	Expiration date (Month)	12
card_data.exp_year	Integer	4	Expiration date (Year)	2024
card_data.cardholder	String	255	Cardholder’s name (Latin characters only)	Joseph Smith

* - cvv parameter is not required for UZCARD and HUMO National Payments Systems

Additional parameters

It can also be required to pass additional user data parameters when collecting card data on Partner's side. Please consult technical and integration support team regarding these parameters during onboarding.

Parameter Name	Type	Description	Example
params.browser	Object	User's browser data
params.browser.language	String	Browser language code	en-GB
params.browser.timezone	String	User's timezone	Europe/London
params.browser.window_width	String	User's browser window width in pixels	1536
params.browser.window_height	String	User's browser window height in pixels	799
params.browser.screen_width	String	User's screen width in pixels	1536
params.browser.screen_height	String	User's screen height in pixels	960
params.browser.java_enabled	Boolean	Flag whether Javascript is enabled and can be executed in User's browser	true
params.browser.screen_color_depth	String	User's screen color depth in bytes per pixel	24
params.browser.user_agent	String	User's browser user-agent header value	Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36

API Reference

You can view a Reference API implementation for this method at this link