Skip to content

Return Parameters

Return Parameters for Non-3D Transactions (AutoComplete)

Section titled “Return Parameters for Non-3D Transactions (AutoComplete)”
  • You must check the Response Hash (hashDataV2) sent to you as a result of the transaction. If the hash you created is different from the hash sent to you, this transaction is not coming from paynkolay, you need to stop the transaction.
  • For payment received information, RESPONSE_CODE = 2 and AUTH_CODE must contain a valid value (not empty or not 0).
  • The fact that the transaction result returns to the successURL page does not mean that the transaction is successful. Therefore, you should always perform the above checks.
RESPONSE_CODE: 2
RESPONSE_DATA: Transaction Successful
USE_3D: false
RND: 1630051651137
MERCHANT_NO: 400000001
AUTH_CODE: S00586
REFERENCE_CODE: IKSIRPF102168
CLIENT_REFERENCE_CODE: 42794212
TIMESTAMP: 2021-08-27
TRANSACTION_AMOUNT: 1.00
AUTHORIZATION_AMOUNT: 1.00
COMMISION: 0.00000000
COMMISION_RATE: null
INSTALLMENT: 1
hashData: bjb49lGdnE2D/D5Jze2/sn7Xfk0=
hashDataV2 : lunnRyNfDu6pdpNjjlFrlATE4PjUluM89iqAobpWkxEmzlDe9lNkP76Ua19WvYeb++yKufjhUa6ZRorBNfEzHA==
  • Successful transaction is posted to the link you entered as successUrl. If the transaction fails, it will return to the link you entered as failUrl.
  • The fact that the transaction returns to the successUrl page does not mean that the transaction is successful.
  • AUTHORIZATION_AMOUNT shows the amount charged from the card. After the transaction, you need to compare the returned AUTHORIZATION_AMOUNT with the amount value you POSTed to the payment page. AUTHORIZATION_AMOUNT should be equal to or greater than the amount you sent.
  • You must check the Response Hash (hashData) sent to you at the end of the transaction. If the hash you created is different from the hash sent to you, this transaction is not coming from paynkolay.
  • As a transaction result, RESPONSE_CODE = 2 and AUTH_CODE must contain a valid value (not empty or not 0).

3D Transaction Approval (AutoComplete) Return Parameters

Section titled “3D Transaction Approval (AutoComplete) Return Parameters”
RESPONSE_CODE : 2
RESPONSE_DATA : Transaction Successful.
REFERENCE_CODE : IKSIRPF142277040
USE_3D : true
MERCHANT_NO : 400000002
AUTH_CODE : 345344
CLIENT_REFERENCE_CODE : 24809740|988922
TIMESTAMP : 2022-02-24 13:58:36.353
TRANSACTION_AMOUNT : 1.00
AUTHORIZATION_AMOUNT : 1.00
COMMISION : 0.00
COMMISION_RATE : 0.0000
INSTALLMENT : 1
RND : 1645700316156
hashData : +wDy2xeI1hOCnwaatSqylWhtj9E=
hashDataV2 : lunnRyNfDu6pdpNjjlFrlATE4PjUluM89iqAobpWkxEmzlDe9lNkP76Ua19WvYeb++yKufjhUa6ZRorBNfEzHA==
BANK_RESULT: Response : IKSIRPF142277040 ...
  • As a successful transaction result, RESPONSE_CODE = 2 and AUTH_CODE must contain a valid value (not empty or not 0).
  • If the transaction is not successful, i.e., erroneous, RESPONSE_CODE = 0 is returned, error message is transmitted in RESPONSE_DATA and AUTH_CODE is empty in erroneous transactions.