Manage Tokenizations API

Use Case

This API is used to manage a tokenizations.
CANCEL: The tokenizations cannot be restored after it has been cancelled.
DEACTIVE: The tokenizations can be restored after it has been cancelled.
ACTIVE: used to active token after Deactive.

Request

POST/v2/tokenizations/manage

Parameter	Type	Required	Description
merchantId	String		Fundiin provides MID as a unique identifier to each merchant.
referenceId	String		The reference id of the transaction you want to cancel.
tokenizations	String		user tokenizations want to cancel
merchantUserId	String		merchantUserId want to cancel
requestType	String		CANCEL, DEACTIVE, ACTIVE
tokenizations	String		The tokenizations User
lang	String		Language of returned message (vi or en)

Example Request

{
    "merchantId": "Your merchant code",
    "referenceId": "Your order number",
    "tokenizations": "Your token",
    "requestType": "CANCEL",
    "merchantUserId": "merchantUserId",
    "tokenizations": "IAoa3wmENyYEluGRvMC5yqxuhWiV8WU1",
    "lang": "vi",
}

Response

Parameter	Type	Required	Description
merchantId	String		Fundiin provides MID as a unique identifier to each merchant.
referenceId	String		Merchant's Reference Id unique for every refund 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.

{
    "merchantId": "FundiinVN",
    "referenceId": "Your order number",
    "responseTime": 1689315609,
    "resultMsg": "Thành công",
    "resultStatus": "APPROVED"
}

Result Status & Messages

Status code	Description	Action to take
APPROVED	Cancel transaction was approved
ACCESS_DENIED	Access denied.	Please check your settings in merchant portal, or contact Fundiin for configurations.
MERCHANT_USER_ID_INVALID	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.