Merchant Manage Tokenizations API

Use Case

When the user manage the tokenizations from the Fundiin side, Fundiin will then call the API using the URL provided by the merchant to manage the tokenizations.

To ensure that a payment has been securely processed you will need to validate the signature on header using your secretKey and clientId in the same manner you compute the signature on header for a request. Request Header

Request

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 manage.
tokenizations	String		user tokenizations want to cancel
merchantUserId	String		merchantUserId want to cancel
requestType	String		CANCEL, DEACTIVE, ACTIVE
tokenizations	String		The tokenizations User

Example Request

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

Response

204 No Content

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.
TOKEN_USER_INVALID	The token is required	Please send Fundiin token user to purcharge order
MERCHANT_USER_ID_INVALID	The merchantUserId is required	Please send Fundiin merchantUserId because this is required.
INVALID_REQUEST	Invalid request. e.g. Invalid currency, invalid amout 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.