Intra Bank Wallet to Wallet Transfer API

post

https://uatmea-iss-apigw.creditpluspinelabs.com/deviceapi/apis/v1/services/transactions/intraBankWalletTransfer

The Interface componentsends a request using this API to transfer fundsfrom one wallet to another, of the same bank. This API is applicable only for prepaid product issued on Pine Labs platform. NOTE: The API, if sent with Card Number Alias (CNA), will fetch the corresponding associated device for further processing only if DEVICE _STATUS_CODE = NORMAL (0) OR (DEVICE_STATUS_CODE = UPGRADE (9) AND UPGRADE_STATUS = 1).
The system performsthe following checksfor intra-bankwallet to wallet transfer transaction processing.
• When the Restrict Intra Bank W2W Transfer TXN check box is selected at the institution level, the system processes the request if the sender program code and receiver program code belong to the same plan code with active status on the Intra Bank Wallet to Wallet Transfer Plan screen.
• When the Restrict Intra Bank W2W Transfer TXN check box is notselected at the institution level, there is no program restrictions for intra bank wallet to wallet transfer.

HTTP Status and Response Status Matrix

HTTP Code: This is the response status code issued by a server in response to a client's request made to the server.
Error Code: This is the error code returned by Credit+ Issuing application in the ‘code’ field of the response message indicating if the request was processed successfully or failed.
Reason: This is the description of the error code returned by Credit+ Issuing application.

HTTP Code	Error Code	Reason
400	102	Suspected fraud.
400	119	Transaction not permitted.
400	997	Wallet Number field is mandatory.
400	997	Wallet Number field value must have max length 24.
400	997	Destination Wallet Number field is mandatory.
400	997	Destination Wallet Number field value must have max length 24.
400	997	Transaction Amount field is mandatory.
400	997	Transaction Amount field must be a positive value with maximum 12 integers and 7 fractions.
400	997	Device Number field is mandatory.
400	997	Device Number field value must have min length 10.
400	997	Device Number field value must have max length 24.
400	997	Destination Device Number field is mandatory.
400	997	Destination Device Number field value must have min length 10.
400	997	Destination Device Number field value must have max length 24.
400	997	Remarks field value must have max length 100.
400	997	Trace Audit Number field is mandatory.
400	997	Trace Audit Number field value must have max length 100.
400	997	Origin field is mandatory.
400	997	Origin field is invalid.
400	997	Device Plan Code field should only contain A-Z, 0-9 and underscore and must start and end with alphanumeric character.
400	997	Device Plan Code field value must have maximum length 10.
400	997	Program Code field value must have maximum length 10.
500	VALPAS002	Not valid Acquirer id.
500	VALPAS003	Acquirer is not active.
500	VALPAS004	Incorrect Password.
500	VALPAS005	Error while validating password.
500	INVCHA002	'Channel Error -'.
500	INVCHA001	Invalid channel -.
500	FNDTRN001	Invalid transaction code.
500	FNDTRN003	Invalid Agent User id.
500	FNDTRN004	Agent User is not Active.
500	FNDTRN005	Error while fetching agency details for user id.
500	FNDTRN006	Error while fetching agency details for Device.
500	FNDTRN007	Agency of device is closed agency, Transaction not permitted.
500	FNDTRN008	Agency is closed agency, Transaction not permitted.
500	FNDTRN009	Invalid source wallet.
500	FNDTRN010	Invalid beneficiary wallet.
500	FNDTRN011	Invalid source wallet/device.
500	FNDTRN012	Invalid source wallet/device.
500	FNDTRN013	Error in populating Product details.
500	FNDTRN014	Insufficient balance.
500	FNDTRN015	Invalid institution.
500	FNDTRN017	Error while validating wallet plan.
500	106	Error in transaction amount conversion.
500	139	Conversion rate is not defined.
500	FNDTRN021	Balance is less than minimum balance configured.
500	FNDTRN022	Invalid source device.
500	FNDTRN023	Error in populating Product details.
500	FNDTRN050	Invalid source currency.
500	FNDTRN051	Invalid source currency.
500	FNDTRN052	Invalid beneficiary currency.
500	FNDTRN053	Invalid beneficiary currency.
500	FNDTRN054	Error in business date.
500	FNDTRN055	Internal error.
500	FNDTRN024	Error while generating main debit transaction.
500	FNDTRN025	Error while generating main debit transaction.
500	FNDTRN027	Error while generating debit fee transaction.
500	FNDTRN029	Error while generating debit service fee transaction.
500	FNDTRN028	Error while generating debit service fee transaction.
500	FNDTRN030	Error while generating markup fee transaction.
500	FNDTRN031	Error while generating markup fee transaction.
500	FNDTRN032	Error while generating markup service tax transaction.
500	FNDTRN033	Error while generating markup service tax transaction.
500	FNDTRN034	Error while generating main credit transaction.
500	FNDTRN035	Error while generating main credit transaction.
500	FNDTRN037	Error while generating credit fee transaction.
500	FNDTRN038	Error while generating fee service tax transaction.
500	FNDTRN039	Error while generating fee service tax transaction.
500	FNDTRN040	Error while updating transaction hist table.
500	FNDTRN041	Error in transaction generation.
500	FNDTRN042	Error in fetching default wallet for beneficiary device.
500	FNDTRN043	Error updating source wallet balance.
500	FNDTRN044	Error updating target wallet balance.
500	FNDTRN045	Error while activating beneficiary wallet.
500	FNDTRN046	Error in updating initiating wallet limit.
500	FNDTRN047	Error in updating beneficiary wallet limit.
500	FNDTRN048	Invalid source client.
500	FNDTRN049	Transaction processed successfully.
500	FNDTRN002	Fund transfer failed due to internal error. Please contact system admin.
400	FNDTRN100	Intra bank wallet to wallet transfer is not allowed/restricted.
400	FNDTRN025	Trace Audit Number and Reference Number Should Be Unique.
400	997	RRN field value must have size 12.
400	997	Trace Audit Number field is mandatory.
400	997	Trace Audit Number field value must have maximum length 6.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

channel

string

The channel through which the request is received. No validation on channel for this API.

walletNumber

string

required

length ≤ 24

Wallet Number linked to the device. Mandatory for GPR Product as well as multicurrency wallet. Maximum length: 24. Not null.

destinationWalletNumber

string

required

length ≤ 24

It denotes the number of a remotely located wallet. Mandatory for GPR Product as well as multicurrency wallet. Maximum length: 24. Not null.

transactionAmount

string

required

length ≤ 20

^[0-9]{1,12}(\.[0-9]{1,7})?$

Must have a valid Numeric Value. Not null. Must be greater than 0. Must be positive value with maximum 12 integers and 7 fractions.

deviceNumber

string

length between 10 and 24

It is a unique code of a device. Must be a valid card number. Maximum length: 24. Minimum length: 10. Mandatory if cardNumberAlias is not present.

destinationDeviceNumber

string

length between 10 and 24

Device to which amount is transferred. Not null. Maximum length: 24. Minimum length: 10. Mandatory if destinationCardNumberAlias is not present.

cardNumberAlias

string

length ≤ 24

^[a-zA-Z0-9_]+$

Alias assigned against each device. Only alphanumeric characters and underscore are allowed. Either deviceNumber or cardNumberAlias must be provided. However, if device number is received in request along with alias, then productType, programCode and devicePlanCode is not be validated by the system. System processes the request based on the device number. Maximum Length 24.

destinationCardNumberAlias

string

length ≤ 24

^[a-zA-Z0-9_]+$

Alias assigned against each destination device. Only alphanumeric characters and underscore are allowed. Either destinationDeviceNumber or destinationCardNumberAlias must be provided. However, if the destination device number is received in request along with the destination alias, then destinationProgramCode and destinationDevicePlanCode is not validated by the system. System processes the request based on the device number. Maximum Length: 24.

programCode

string

length ≤ 10

^[A-Z0-9_]+$

Type of program assigned to the device. Max length 10. This field is required only when cardNumberAlias is not null.

devicePlanCode

string

length ≤ 10

^[A-Z0-9_]+$

Type of plan assigned to the device. Max length 10. This field is required only when cardNumberAlias is not null.

destinationProgramCode

string

length ≤ 10

^[A-Z0-9_]+$

Destination Type of program assigned to the device. Maximum length: 10. This field is required only when destinationCardNumberAlias is not null and multiple devices are linked with the same destinationCardNumberAlias.

destinationDevicePlanCode

string

length ≤ 10

^[A-Z0-9_]+$

Destination Type of plan assigned to the device. Max length 10. This field is required only when destinationCardNumberAlias is not null and multiple devices are linked with the same destinationCardNumberAlias.

remarks

string

length ≤ 100

User remarks. If it is present, then it should of maximum length 100.

traceAuditNumber

string

required

length between 6 and 6

^[0-9]{6}$

A number assigned by the originator of a transaction to uniquely identify a transaction throughout its life. Fixed length: 6. Not null.

rrn

string

length between 12 and 12

^[0-9\s]{12}$

Retrieval Reference Number. It can be used to retrieve the original transaction data. It is a unique authorization reference number (Reference Retrieval Number). Fixed length: 12. May contain spaces. Not null.

origin

string

enum

required

Transaction origin. It identify if the transaction is Domestic or International. In reference to this API, this field always should have value as 'DOM' which means domestic. Not null. Should be 'DOM'.

Allowed:

Headers

Correlation-ID

string

^[a-zA-Z0-9-]{1,50}$

API Consumer must share Correlation-ID in HTTP header for API requests. The Correlation-ID must be unique for each request. It is recommended to generate a universally unique identifier (UUID) of length 32 or 36 that is compliant with RFC 4122. The maximum supported length is 50 alphanumeric characters. For example, ac97d177-9345-4934-8343-0f91a7a02836. If the Correlation-ID is not received in the incoming request, the system generates the UUID dynamically and assigns it to the request.

Source

string

API Consumer can share Source in HTTP header for API requests. For the list of Source values, see the Pre-conditions for HTTP Header of REST API topic in the Pre-requisite for Rest API section.

Response

201Successful transfer