The Hello-Paisa Payment API is a  soap based web-service.

View Sample Code for Dot Net

View Sample Code for PHP

API Endpoint for Test Environment : http://110.44.114.210:8080/PaymentHandler/coreApi?wsdl

The payment process is carried out in two phases viz. Initiate Payment and Verify Transaction

To initiate a payment, you'll pass your request details to the method 'initiatePayment',

Request Object:

The request object contains the following properties,

Property Type Description
id String Merchant authentication id
pin String Secret of Merchant
serviceCode String Payment Service Code
value Double Transaction Amount
mobile Strng The mobile number of the customer

Response Object:

The response object contains the following properties.

Property Type Description
validity Boolean Represents whether the transaction has been requested successfully or not.
trxnTraceId String The transaction trace id for the transaction.
errorDescription String Response Code of Transaction status
errorMessage String Response Message

If all the supplied credentials are true, then the "initiatepayment" method will respond a Transaction ID  and validity of "true" else "false".

The second-phase of the process is to verify the transaction based on the 'transaction trace id' . For this, you should call the method 'verifyTransaction'.

The list of possible reponse codes are as follows:

Response code Response Type
101 SENDER_DOES_NOT_EXIST
102 SENDER_PROFILE_NOT_EXIST
103 SENDER_SERVICE_NOT_ASSIGNED
104 SENDER_INACTIVE_STATUS
105 SAME_SENDER_RECEIVER
106 SENDER_CUSTOMER_BLACKLIST
107 SENDER_BANK_ACCOUNT_NOT_EXISTING
108 SENDER_PROFILE_NOT_ACTIVE
111 RECEIVER_DOES_NOT_EXIST
112 RECEIVER_PROFILE_NOT_EXIST
114 RECEIVER_INACTIVE_STATUS
115 SAME_RECEIVER_SENDER
116 RECEIVEFR_CUSTOMER_BLACKLIST
117 RECEIVER_BANK_ACCOUNT_NOT_EXISTING
118 RECEIVER_PROFILE_NOT_ACTIVE
200 INVALID_SERVICE
203 MOBILENO_NO_DIGIT
204 MOBILENO_INCORRECT
205 AMOUNT_INCORRECT
206 AMOUNT_EXCEEDED
207 PIN_FORMAT_ERROR
212 AMOUNT_ZERO_OR_LESS_ERROR
301 FEE_NOT_FOUND
302 MULTIPLE_FEE_FOUND
303 FEE_CALCULATION_ERROR
304 BALANCE_NOT_FOUND
305 MULTIPLE_BALANCE_FOUND
306 INSUFFICIENT_BALANCE
311 TRANSACTION_REQUEST_DUMP_ERROR
321 LIMIT_NOT_FOUND
322 PER_TRANSACTION_LIMIT_EXCEEDS
323 DAILY_LIMIT_EXCEEDS
324 MONTHLY_LIMIT_EXCEEDS
325 HALF_YEARLY_LIMIT_EXCEEDS
326 YEARLY_LIMIT_EXCEEDS
327 LIMIT_DUPLICATE_ERROR
351 AUTHORIZATION_FAILED
401 PIN_NOT_FOUND
402 MULTIPLE_PIN_FOUND
403 PIN_COUNT_RESET_ERROR
404 WRONG_PIN_MULTIPLE_TIMES
405 ENTERED_PIN_NOT_MATCHED
406 NEW_PIN_NOT_TRAPPED_CORRECTLY
461 OUT_MESSAGE_DUMP_ERROR
501 NO_PIN_CAPTURE
502 PREMATURE_HUNGUP
503 USER_HUNGUP
504 ALL_CALL_RETRY_FAIILED
505 TRANSACTION_CANCELLED_BY_USER
506 TELCO_NOT_SUPPORTED
507 NO_ANSWER
508 MULTIPLE_TRANSACTION_AUTHENTICATION_CALLED
961 AMI_CONNECTION_ERROR
999 UNKNOWN_ERROR
1101 RMONEY_SENDER_DOES_NOT_EXIST
1102 RMONEY_SENDER_PROFILE_NOT_EXIST
1103 RMONEY_SENDER_SERVICE_NOT_ASSIGNED
1104 RMONEY_SENDER_INACTIVE_STATUS
1105 RMONEY_SAME_SENDER_RECEIVER
1111 RMONEY_RECEIVER_DOES_NOT_EXIST
1112 RMONEY_RECEIVER_PROFILE_NOT_EXIST
1113 RMONEY_RECEIVER_SERVICE_NOT_ASSIGNED
1114 RMONEY_RECEIVER_INACTIVE_STATUS
1301 RMONEY_FEE_NOT_FOUND
1302 RMONEY_MULTIPLE_FEE_FOUND
1303 RMONEY_FEE_CALCULATION_ERROR
1304 RMONEY_BALANCE_NOT_FOUND
1305 RMONEY_MULTIPLE_BALANCE_FOUND
1306 RMONEY_INSUFFICIENT_BALANCE
1311 RMONEY_TRANSACTION_REQUEST_DUMP_ERROR
1321 RMONEY_LIMIT_NOT_FOUND
1322 RMONEY_PER_TRANSACTION_LIMIT_EXCEEDS
1323 RMONEY_DAILY_LIMIT_EXCEEDS
1324 RMONEY_MONTHLY_LIMIT_EXCEEDS
1325 RMONEY_HALF_YEARLY_LIMIT_EXCEEDS
1326 RMONEY_YEARLY_LIMIT_EXCEEDS
1404 RMONEY_WRONG_PIN_MULTIPLE_TIMES
1501 RMONEY_NO_PIN
1502 RMONEY_PREMATURE_HUNGUP
1504 RMONEY_ALL_CALL_RETRY_FAIILED
1505 RMONEY_TRANSACTION_CANCELLED_BY_USER
1507 RMONEY_NO_ANSWER
9001 FAILED_AUTHENTICATION
9002 SUCCESSFUL_AUTHENTICATION
9003 RETRYING_CALL
9004 CALL_IN_PROGRESS
9005 CALL_NOT_QUEUED
9006 CALL_QUEUED


The services are available across the following Mobile Operators

Feedback
Request Registration