Forgot pin

The available versions for this api are v1.0 and v2.0.

POST https://tokoapisnap-stg.netzme.com/api/{version}/merchant/forgot-pin

Request

Parameter	Data Type	Description
custIdMerchant	String	User ID
partnerReferenceNo	String	API request identifier from the user's system, unique each request
additionalInfo	Object
type	String	type of request, for forgot pin is "forgot_pin"

{
    "custIdMerchant": "M_F5rX23Vw",
    "partnerReferenceNo": "testinga202203090000000001",
    "additionalInfo": {
        "type": "forgot_pin"
    }
}

Response

Parameter	Data Type	Description
responseCode	String	(HTTP status code + service code + case code)
responseMessage	String	Description of responseCode
partnerReferenceNo	String	API request identifier from the user's system
additionalInfo	Object
timeLeftInMillis	Integer	Minimum time period to be able to make this request again

Response Body

{
    "responseCode": "2000000",
    "responseMessage": "Successful",
    "partnerReferenceNo": "testinga202203090000000001",
    "additionalInfo": {
        "timeLeftInMillis": 300000
    }
}

Curl Example

Header	Value
Content-Type	application/json
CHANNEL-ID	e.g 95221
X-EXTERNAL-ID	e.g 41807553358950093184162180797837
X-PARTNER-ID	Client id e.g TokoNetmeClientId
X-SIGNATURE	Service’s signature (given at transactional signature)
X-TIMESTAMP	Client's current local time in yyyy-MM-ddTHH:mm:ssTZD
Authorization	Client`s access for protected resources (given at Authentication)

curl --location -g --request POST 'http://localhost:9090/api/v1.0/merchant/forgot-pin' \
--header 'X-TIMESTAMP: 2022-08-10T00:00:00+07:00' \
--header 'X-SIGNATURE: 68fcb2378fcf8fed4212bb8b6eff766f8397b37da51271632fe63fd8783228f6ae9b818133986dbaa87bc9a8c9f69cbe580b793f699f7691599953347d87dee0' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2NjkzMTUwMTksImlhdCI6MTY2OTI2MTAxOSwiaXNzIjoiYmFua3N1bXBhaCJ9.eCt0QNx1J2CgK5T3SRNkCgGqxRfexVw_MGntV1UiO8KI2qAiIpL3jgB31HfzNuUeqYu9lXNi27RIbGoxrxVE-Q' \
--header 'X-PARTNER-ID: TokoNetmeClientId' \
--header 'X-EXTERNAL-ID: 41807553358950093184162180797837' \
--header 'CHANNEL-ID: 95221' \
--data-raw '{
    "custIdMerchant": "M_TB1NMLig",
    "partnerReferenceNo":"testinga2022030900000000016",
    "additionalInfo":{
        "type":"forgot_pin"
    }   
}'