Confirm Tokenizations

Use Case

This API will be used to confirm and get tokenization user after authentication success

Request

POST /v2/tokenizations/confirm

Parameter	Type	Required	Description
merchantId	String		Fundiin provides MID as a unique identifier to each merchant.
referenceId	String		Unique identifier generated by the merchant for this action REGEX: ^[0-9a-zA-Z_:-]60$
merchantUserId	String		MerchantUserId send in API Create tokenizations Request API
requestType	String		CONFIRM_TOKENIZATIONS
lang	String		Language of returned message (vi or en), If not included, the default is en.

Example Request

{
    "merchantId": "Your merchant code",
    "referenceId": "Your order number",
    "merchantUserId": "MerchantUserId_123",
    "requestType": "CONFIRM_TOKENIZATIONS",
    "lang": "vi"
}

Response

Parameter	Type	Required	Description
merchantId	String		Identification of the merchant that was issued when registering with Fundiin.
referenceId	String		Order number for the charge transaction.
responseTime	String		Date & Time of response: Format: YYYY-MM-DD hh:mm:ss
resultStatus	String		Result status
resultMsg	String		The result message which contains information about the result.
tokenization	String		The User tokenization after authenication success

By default expiry time for the order created is 30 minutes from order creation time stamp. If this needs to be extended for more than 30 minutes please contact Fundiin.

{
    "merchantId": "FundiinVN",
    "referenceId": "Your order number",
    "responseTime": "2023-07-24 09:33:55",
    "resultMsg": "Thành công",
    "resultStatus": "APPROVED",
    "tokenization": "IAoa3wmENyYEluGRvMC5yqxuhWiV8WU1"
}

Result Status & Messages

Status code	Description	Action to take
APPROVED	Request was successfully received.
ACCESS_DENIED	Access denied.	Please check your settings in merchant portal, or contact Fundiin for configurations.
USER_ALREADY_HAS_TOKEN	User already has token.
INVALID_MERCHANT_USER_ID	The merchantUserId is required.	Please send Fundiin merchantUserId because this is required.
INVALID_REQUEST	Invalid request. e.g. Invalid merchantUserId etc.
INVALID_REFERENCE_ID	The referenceId is invalid.	Please retry with a different
INVALID_CLIENT_ID	The cliendId is not registered.
INVALID_SIGNATURE	The signature is invalid.
INVALID_MERCHANT_ID	The merchant is not registered.
INVALID_HTTP_METHOD	The server does not implement the requested HTTPS method.
INVALID_API	API is not defined.	Check whether the request URL is correct. Ensure that the endpoint of the called API is correct.
REQUEST_PROCESSING	The request already processed or in progress.
DOWNSTREAM_ERROR	Partner downstream timeout. (Retriable)
ERROR_GENERAL	Declined due to general reasons other than the specific decline error codes provided.