Intra Client Wallet to Wallet Transfer

post

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

The Interface componentsends a request using this API to transfer fundsfrom one wallet to another, of the same client. 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).

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
201	FNDTRN000	Successful
400	102	Suspected fraud.
400	119	Transaction not permitted.
400	997	Wallet Number field value must have max length 24.
400	997	Destination Wallet Number field value must have max length 24.
400	997	Month’s data is invalid
403	900	Invalid User
404	998	Device(s) does not exist
500	999	Statement not available for last 3
400	997	Card Number Alias field value must have max length 24.
400	997	Product Type field is invalid.
400	997	Program Code field should only contain [A-Z 0-9] and underscore and must start and end with alphanumeric character.
400	997	Program Code field value must have max length 10.
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 max length 10.
400	FNDTRN001	Invalid transaction code
400	FNDTRN002	Fund transfer failed due to internal error. Please contact system admin.
400	FNDTRN009	Invalid source wallet
400	FNDTRN010	Invalid beneficiary wallet
400	FNDTRN011	Invalid source wallet/device
400	FNDTRN012	Invalid source wallet/device
400	FNDTRN013	Error in populating Product details
400	FNDTRN014	Insufficient balance
400	FNDTRN015	Invalid institution
400	FNDTRN016	Error while validating wallet promotion plan
400	FNDTRN017	Error while validating wallet plan
400	FNDTRN021	Balance is less than minimum balance configured.
400	FNDTRN022	Invalid source device
400	FNDTRN023	Error in populating Product details
400	FNDTRN050	Invalid source currency
400	FNDTRN051	Invalid source currency
400	FNDTRN052	Invalid beneficiary currency
400	FNDTRN053	Invalid beneficiary currency
400	FNDTRN054	Error in business date
400	FNDTRN024	Error while generating main debit transaction
400	FNDTRN025	Error while generating main debit transaction
400	FNDTRN026	Error while generating debit fee transaction
400	FNDTRN027	Error while generating debit fee transaction
400	FNDTRN028	Error while generating debit service fee transaction
400	FNDTRN029	Error while generating debit service fee transaction
400	FNDTRN030	Error while generating markup fee transaction
400	FNDTRN031	Error while generating markup fee transaction
400	FNDTRN032	Error while generating markup service tax transaction
400	FNDTRN033	Error while generating markup service tax transaction
400	FNDTRN034	Error while generating main credit transaction
400	FNDTRN035	Error while generating main credit transaction
400	FNDTRN036	Error while generating credit fee transaction
400	FNDTRN037	Error while generating credit fee transaction
400	FNDTRN038	Error while generating fee service tax transaction
400	FNDTRN039	Error while generating fee service tax transaction
400	FNDTRN040	Error while updating transaction hist table.
400	FNDTRN041	Error in transaction generation.
400	FNDTRN042	Error in fetching default wallet for beneficiary device.
400	FNDTRN043	Error updating source wallet balance
400	FNDTRN044	Error updating target wallet balance
400	FNDTRN045	Error while activating beneficiary wallet
400	FNDTRN046	Error in updating initiating wallet limit
400	FNDTRN047	Error in updating beneficiary wallet limit
400	FNDTRN048	Invalid source client
400	FNDTRN059	Source device status is not normal
400	FNDTRN060	Source device is not delivered
400	FNDTRN061	Cancellation request already registered for originator wallet
400	FNDTRN062	Source wallet is not active
400	FNDTRN063	Source device BIN is stoplisted
400	FNDTRN064	Source device range is stoplisted
400	FNDTRN065	Source device is stoplisted
400	FNDTRN066	Country is stoplisted
400	FNDTRN067	Beneficiary device is not delivered
400	FNDTRN068	Beneficiary wallet is closed
400	FNDTRN069	Cancellation request already registered for beneficiary wallet
400	FNDTRN056	Beneficiary wallet is dormant due to transaction not done
400	FNDTRN070	Beneficiary device status is not normal
400	FNDTRN071	Beneficiary device BIN is stoplisted
400	FNDTRN072	Beneficiary device range is stoplisted
400	FNDTRN073	Beneficiary device is stoplisted
400	FNDTRN074	Country is stoplisted
400	FNDTRN075	Source/beneficiary client must be primary
400	FNDTRN076	Transfer is not allowed to different client
400	FNDTRN079	Transfer from closed status wallet is not allowed.
400	FNDTRN080	Transfer is not allowed for closed loop source wallet
400	FNDTRN081	Transfer is not allowed for closed loop beneficiary wallet
400	FNDTRN057	Wallet To Wallet Transfer type is via reference currency. Either source wallet or destination wallet currency must be reference currency.
400	FNDTRN082	Transfer is not allowed as source wallet is not open loop wallet
400	FNDTRN083	Transaction set is not defined for source device
400	FNDTRN084	Transaction is not allowed for source device
400	FNDTRN085	Transaction set is not defined for beneficiary device
400	FNDTRN086	Transaction is not allowed for beneficiary device
400	FNDTRN090	Conversion rate is not defined for requested configuration
400	FNDTRN091	Limits on source device exceeded.
400	FNDTRN092	Frequency on source device exceeded.
400	FNDTRN093	Transaction amount is less than Minimum amount configured.
400	FNDTRN087	Limits on source wallet exceeded.
400	FNDTRN088	Frequency on source wallet exceeded.
400	FNDTRN089	Transaction amount is less than Minimum amount configured.
400	FNDTRN091	Limits on beneficiary wallet exceeded.
400	FNDTRN092	Frequency on beneficiary wallet exceeded.
400	FNDTRN093	Transaction amount is less than Minimum amount configured.
400	106	Error in transaction amount conversion
400	139	Conversion rate is not defined.
400	124	Transfer between wallets under same client is not allowed.
400	126	Source and beneficiary wallet must belong to same institution
400	107	Invalid source program code
400	107	Invalid beneficiary program code
400	121	Both originating and beneficiary device belongs to same institution. Use DEVICE to DEVICE transfer option
400	138	Error while fetching reference currency
400	125	Source and beneficiary wallets can not be same
400	101	Invalid source wallet
500	913	Backward offset time limit violated.
400	994	Invalid Request - Unrecognized field.
400	988	Encryption type Not Supported.
400	913	Forward offset time limit violated.
400	997	Transaction Amount field is mandatory.
400	997	Card Number Alias/ Device Number field is mandatory.
400	997	Destination Card Number Alias/ Destination Device Number field is mandatory.
400	994	Invalid Encryption-Algorithm header value
400	994	Invalid Encryption Request Parameters
400	994	Cryptography error

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

channel

string

length ≤ 2

^[0-9]{2}$

CSC / AGT / Network Code associated to Acquirer ID. Numeric, Fixed length: 2. Not null.

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 ≤ 19

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

The amount sent in this field is debited or credited based on 'transferType' indicator. Must have a valid numeric value. Must be greater than 0. Maximum Length: 12,7. Not null.

deviceNumber

string

length between 10 and 24

It is a unique code of a device. Either deviceNumber or cardNumberAlias must be provided. Maximum Length: 24. Minimum Length: 10.

destinationDeviceNumber

string

length between 10 and 24

Device to which amount is transferred. Either destinationDeviceNumber or destinationCardNumberAlias must be provided. Minimum Length: 10. Max length is 24.

cardNumberAlias

string

length ≤ 24

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

It is alias to identify a 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 programCode and devicePlanCode is not validated by the system. The system processes the request based on the device number. Maximum Length 24.

destinationCardNumberAlias

string

length ≤ 24

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

It is alias to identify 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. The 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 if cardNumberAlias is not null and multiple devices are linked with the same cardNumberAlias.

destinationProgramCode

string

length ≤ 10

^[A-Z0-9_]+$

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

devicePlanCode

string

length ≤ 10

^[A-Z0-9_]+$

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

destinationDevicePlanCode

string

length ≤ 10

^[A-Z0-9_]+$

Destination Type of plan assigned to the device. Maximum length 10. This field is required only if 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 Max 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. Fix length is 6. Not NULL.

origin

string

enum

required

Transaction Origin. Should be 'DOM'. Not NULL.

Allowed:

transferType

string

enum

This field indicates the transaction transfer type of wallet to wallet transfer. The amount sent in 'transactionAmount' request attribute is debited or credited based on this indicator. Valid values: DR (Debit from Source), CR (Credit to Destination, default value). If the value has not been provided, the system will consider 'CR' as the default value and accordingly send the request.

Allowed:

timestamp

string

required

^[0-9]+$

Current UTC timestamp in milliseconds. Numeric. AES key expiration criteria depends on input UTC timestamp. Applicable only for encrypted requests. Not NULL.

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.

Encryption-Algorithm

string

enum

required

API Consumer must share Encryption-Algorithm as a key (value: DES168) in HTTP header in order to encrypt the API requests.

Allowed:

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