Next : Approval for launch

Payment Response is an encrypted string which contains the transaction response and it is sent to the merchant back from iPayy after payment has been done.

How to decrypt Payment Response?

 

Payment Response is a key-value parameter map which is constructed at the iPayy server.This paramaeter map is encrypted through encryption library to secure the response of the transaction  which was initiated by merchant.

 

response-crypto

 

Java




PHP

Python

With easy install

  1. Download the egg file
  2. Run the following command  easy_install CryptoClient-0.1-py2.7.egg

Installing from source

  1. Download this zip file and extract it
  2. Run the following command python setup.py install

 

.NET


Response Parameters:

RESPONSE SCENARIOPARAMETER NAMEPARAMETER VALUEDESCRIPTION
DEFAULTopOperator NameService provider of the end -user mobile.This is an optional response parameter
mnMsisdnEnd User Mobile number.This is an optional response parameter
ccCustomer CodeCustomer code is an unqiue identifier for each customer generated by iPayy


SUCCESS
txA numeric value generated by the iPayy systemTransaction ID generated by the iPayy system
ccHashed value of users msisdn known as customer –codeHashed value generated for respective msisdn
rValue passed to the iPayy system as a request parameterTransaction Request ID passed as a request parameter
ts STransaction Status
S – indicates successful transaction
User Action Failure


Scenario (due to Cancel / Session Timeout / PIN failure)
rValue passed to the iPayy system as a request parameterTransaction Request ID passed as a request parameter
tsFTransaction Status
F – indicates failure transaction
tfUC or ST or PFTransaction Failure Reason
UC – indicates user cancelled the transaction
ST – indicates session timed out
PF – indicates OTP retry due to failure max attempts exceeded

Billing Failure
rValue passed to the iPayy system as a request parameterTransaction Request ID passed as a request parameter
tsFTransaction Status
F – indicates failure transaction
tfLB or IS or OFTransaction Failure Reason
LB – Failure due to Low Balance
IS – User does not belong to the selected operator network
OF – Transaction failed due to some other failure

Error Scenario
ecError code as defined in the Error code section
emError message
A descriptive message for the error code

 

Error Codes

The error codes in case billing failed due to configuration, invalid request, unexpected service failures etc.

Error TypeError CodeError Description
Request Format / Value ErrorsIRQ0101A required resource could not be found with the specified parameters. (or)
No valid OTP payment requests could be found.
Request Format / Value ErrorsIRQ0102The request could not be read or understood.
Request Format / Value ErrorsIRQ0103The token is expired. Please provide a fresh token.
Request Format / Value ErrorsIRQ0104The request could not be read or understood as a required parameter is missing or the parameter values are not in the correct format. Please try again with the correct parameters.
Request Format / Value ErrorsIRQ0201The specified resource already exists. Duplication is not allowed.
Request Format / Value ErrorsIRQ0401You are using an incorrect gateway to access this service.
Request Format / Value ErrorsIRQ0601The service cannot support the content provided by the client.
Credential / Authorization ErrorsICR0201The iPayy PIN / OTP token did not match.
Credential / Authorization ErrorsICR0401The operation cannot be authorized with the specified credentials.
Subscriber / Discovery ErrorsISC0101The MSISDN specified / detected could not be normalized. Please contact the iPayy team if the issue persists.
Subscriber / Discovery ErrorsISC0201The Mobile Number is temporarily barred or has exceeded the operator billing threshold.
Subscriber / Discovery ErrorsISC0301This service is not available to regular customers.
Service ErrorsSER0101The SMS could not be sent. Please contact the iPayy team if the issue persists.
Service ErrorsSER0102The USSD session could not be established. Please contact the iPayy team if the issue persists.
Service ErrorsSER0201An error occurred due to which we were unable to process the transaction.
Service ErrorsSER0401An error occurred while processing the payment. Please try again with the correct parameters.
Service ErrorsSER0501An error occurred while obtaining consent or processing the payment. Please try again with the correct parameters.
Service ErrorsSER0701A Data Store error occurred. Please retry the request again. If the error persists, please contact the iPayy team.
Service ErrorsSER1501Carrier link is currently down. Please try after sometime.
Unexpected ErrorUXE0001Unexpected Error
Configuration ErrorCFG0101The application is currently not live for the operator and price point. Please contact the iPayy team for more information.
Configuration ErrorCFG0102An error occurred while trying to obtain consent. Please retry again.
Configuration ErrorCFG0501An internal configuration error occurred. Please contact the iPayy team if the issue persists.
Configuration ErrorCFG0601An error occurred while obtaining consent for the carrier. Please contact the iPayy team if the issue persists.

Next : Approval for launch