User Registration

| View as Markdown

This API is for user registration with prepaid card portal. This way a user will be allowed to add card and do transaction from it. Customer must provide the otp that he has received. We must pass mobile no, kit no, card type, card no, card expiry, first name, last name, title, gender, dob, email , address, city, state, pincode, doc type, doc no, doc expiry, doc country issue, otp and password in request. If the request has valid details, we will get entity id, kyc status, kyc expiry date.

POST

https://kraken.airpay.co.in/airpay/ms/cards/api/register-user

Field	Type	Description
affiliate	text	Will be provided by Airpay (length 10, required)
checksum	text	$string = $param.self::$secret_key;sha256(<concate all values+SECRET KEY>);(dynamic, required)
processor-key	text	Will be provided by airpay(constant, required)

Parameter

Field	Type	Description
mobile_no	numeric	Mobile number of customer(length 10, required)
kit_no	text	Proxy for Card Number, used for both physical and virtual card that is to be allocated to the customer . (length 16, required)
card_type	text	Card type to be mentioned. ( P – Physical , V- virtual)(length 1, required)
card_no	text	Customer need to enter the card no.16 digit card no.(length 16, required)
card_expiry	date	Expiry Date of Card- 1 month to 25 years(length 10, required)
first_name	text	Customer First Name (Only a-z A-Z and no spaces) (length 30, required)
last_name	text	Customer Last Name (Only a-z A-Z and no spaces) (length 30, required)
title	text	Mr,Mrs,Ms(length 4, required)
gender	text	Mobile M or F or T(length 1, required)
dob	date	DOB format YYYY-MM-DD(length 10, required)
email	text	Valid Email address with valid email format .Must be unique.(length 50, required)
address	text	Alpha numeric only with space allowed(length 100, required)
city	text	(Only a-z A-Z and no spaces)(length 20, required)
state	text	(Only a-z A-Z and with spaces)(length 20, required)
pincode	numeric	Customer pincode (only 6 digits for India) (length 15, required)
doc_type	text	AADHAAR/ PAN/ VOTERID / DL/ PASSPORT(length 10, required)
doc_number	text	Document number(length 20, required)
doc_expiry	date	Document Expiry(length 10, required)
doc_country_issue	text	Valid country name (Only a-z A-Z and with spaces) (length 20, required)
otp	numeric	One Time Password,We have to pass this values after initiating “Generate OTP” API (length 4, required)
password	text	At least 7 characters Maximum 20 characters A mixture of both uppercase and lowercase letters. A mixture of letters and numbers. Inclusion of at least one special character(length 20, required)

Request-Example:

 curl --location --request POST 'https://kraken.airpay.co.in/airpay/ms/cards/api/register-user' \
--header 'processor-key: 91f5evhk72f56432ec678sdfes685h42sd2t21k430912508233b7r37562g2hps' \
--header 'affiliate: 91f5evhk72f56432ec678sdfes685h42sd2t21k430912508233b7r37562g2hps' \
--header 'checksum: 91f5evhk72f56432ec678sdfes685h42sd2t21k430912508233b7r37562g2hps' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'mobile_no=9XXXXXX513' \
--data-urlencode 'kit_no=100000001200' \
--data-urlencode 'card_type=V' \
--data-urlencode 'card_no=462294XXXXXX3713' \
--data-urlencode 'card_expiry=01/25' \
--data-urlencode 'title=Mr' \
--data-urlencode 'first_name=Prasanth' \
--data-urlencode 'last_name=Kumar' \
--data-urlencode 'gender=M' \
--data-urlencode 'dob=1989-11-09' \
--data-urlencode 'email=xyz@airpay.co.in' \
--data-urlencode 'address=Kochi' \
--data-urlencode 'state=Kerala' \
--data-urlencode 'city=Ernakulam' \
--data-urlencode 'pincode=689673' \
--data-urlencode 'doc_type=AADHAAR' \
--data-urlencode 'doc_number=59048961234' \
--data-urlencode 'doc_expiry=' \
--data-urlencode 'doc_country_issue=India' \
--data-urlencode 'otp=' \
--data-urlencode 'password=PaSwd@1234'

Success 200

Field	Type	Description
status	numeric	400- fail,200-success(length 3, required)
message	text	Success, Fail(required)
data	json	{ “entity_id”: “12345678”, “kyc_status”: “MIN_KYC”, “kyc_expiry_date”: “2021-06-18”, “kycRefNo”: null }

Success-Response:

{
    "status": 200,
    "message": "success",
    "data": {
        "entity_id": "91f5evhk72f56432ec678sdfes685h42sd2t21k430912508233b7r37562g2hps",
        "kyc_status": "MIN_KYC",
        "kyc_expiry_date": "2021-06-18",
        "kycRefNo": null
    }
}

Fail-Response:

{
    "status": 400,
    "message": "fail"
}