Create pin

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

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

Request

Parameter	Data Type	Description
custIdMerchant	String	User ID provided by netzme
partnerReferenceNo	String	API request identifier from the user's system, must be unique for each request
additionalInfo	Object
pin	String	User PIN
type	String	type of request, for created pin, the type is "created_pin"

{
    "custIdMerchant": "M_F5rX23Vw",
    "partnerReferenceNo": "testing20210420090452526",
    "additionalInfo": {
        "pin": "3db6b20266c102a909ce2adb404e5260c01928b87956f106f36bec745b8e1d2a",
        "type": "create_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
type	String	Type of request

Response Body

{
    "responseCode": "4040020",
    "responseMessage": "PIN already exist with different value",
    "partnerReferenceNo": "testing20210420090452526",
    "additionalInfo": {
        "type": "create_pin"
    }
}

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/create-pin' \
--header 'X-TIMESTAMP: 2022-08-10T00:00:00+07:00' \
--header 'X-SIGNATURE: e31fd35336dd3db025b5f78459661f7a00595a039237e611bca5f736b89dbab0e30140aa4ae29ea89a3f205be080b4a0a992743fb92646150bd642a1641e6adc' \
--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":"testing20210420090452526",
    "additionalInfo":{
        "pin":"3db6b20266c102a909ce2adb404e5260c01928b87956f106f36bec745b8e1d2a",
        "type":"create_pin"
    }   
}’