PIN-Related

If you are not PCI-compliant, it is recommended to use the "EastPay® Payment Gateway mobile SDK" for PIN-related operations.

PIN format

PIN format data total 8 bytes, it hex data such as “1614725812345678”. the first digit is fixed 1 the 2rd digit is PIN length, such as 6 the next data is PIN, its length is the PIN length, such as 147258 the last data is padding data, such as 12345678, it should be a random number. encryption algorithm: RSA

GeneratePublicPinKey

This API is used to get the public key to protect cardholder’s PIN

Request：

No body of this request.

Response:

	Data Element	Field Name	Description	Format	Length	M/O	Remark
1	Pin Key Id	pinKeyId	Pin Key Id	String	Maximum 8 character	Required
2	Pin Key	pinKey	Pin Key	String	Maximum 4096 character	Required	RSA Public Key

PINReset

This API is used to reset the personal identification number (PIN) of a physical card.

Request：

	Data Element	Field Name	Description	Format	Length	M/O	Remark
1	Card Token Number	cardToken	Card Token Number	String	Maximum 19 characters	Conditional
2	Card Number	cardNumber	Card Number	String	Maximum 19 character	Conditional
3	Pin Key Id	pinKeyId	Pin Key Id	String	Maximum 8 character	Required
4	New PIN Encrypted by Key	newCardPin	New PIN Encrypted by Key	String	Maximum 4096 characters	Required

Response:

None.
Only response public header, please refer to the response code in header.

PINChange

This API is used to change the personal identification number (PIN) of a physical card.

Request:

	Data Element	Field Name	Description	Format	Length	M/O	Remark
1	Card Token Number	cardToken	Card Token Number	String	Maximum 19 characters	Conditional
2	Card Number	cardNumber	Card Number	String	Maximum 19 character	Conditional
3	Pin Key Id	pinKeyId	Pin Key Id	String	Maximum 8 character	Required
4	PIN Encrypted by Key	cardPin	PIN Encrypted by Key	String	Maximum 4096 characters	Required
5	New PIN Encrypted by Key	newCardPin	New PIN Encrypted by Key	String	Maximum 4096 characters	Required

Response:

None.
Only response public header, please refer to the response code in header.

PINVerify

This API is used to verify the personal identification number (PIN) of a physical card.

Request:

	Data Element	Field Name	Description	Format	Length	M/O	Remark
1	Card Token Number	cardToken	Card Token Number	String	Maximum 19 characters	Conditional
2	Card Number	cardNumber	Card Number	String	Maximum 19 character	Conditional
3	Pin Key Id	pinKeyId	Pin Key Id	String	Maximum 8 character	Required
4	PIN Encrypted by Key	cardPin	PIN Encrypted by Key	String	Maximum 4096 characters	Required

Response:

None.
Only response public header, please refer to the response code in header.