Wallet-to-Wallet Fund Transfer API

The Wallet-to-Wallet Fund Transfer API will be used to do wallet-to-wallet fund transfers from one customer’s wallet to another customer’s wallet.

📘
Note:
This API does not support the sub-wallet transfers for the same customer.

Environment


Sandbox	https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/onboarding/v2/fundTransfer
Production	Contact your WIBMO KAM or support.

Sample request

curl --request POST \
     --url https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/onboarding/v2/fundTransfer \
     --header 'X-Consumer-Custom-ID: F42BC4E7B801C834B630DE498473533F' \
     --header 'bankId: 6060' \
     --header 'clientId: 1060' \
     --header 'content-type: application/json' \
     --header 'entityId: 100' \
     --header 'secureCode: pu8gSMLNE7pNv36IlUmstU' \
     --header 'x-api-key: 4A02C4267C9A97A1488AB3259FD1A725' \
     --data '
{
  "token": "b5yvvQCWcnjxlOyswxOkjgfGC1DqL+Hf3MqekUA7SnCaEBfhZj7Yo4wxUEqMCsjs8TlPWxBBgJA7ZIKPgTbNzdDDhyVm04Cr9Yy8zHT+pCGnTJ/WgbmM7eAsYnB+CoA/KLIfTkimrZQVhDS5M8+phIol3EIxGn4b0w2+mYPCBfviHGYP1MKqcjoqZR2zd6G2GG2Z/R5N5Tyksoo44DD2KFrpymt9iuEXzZAkKu87PW69Y+GtN0ESstFMDI6dQ0BmgcOubZ4pyiTt0ikUNgX08IR8yxX4grSHAI5h/L+camhpB3B0evRHbzNMpckxhRkLmAxnCCWdkVTY4ogJqJZFd0QIlGOC6l1gGYDxJwVqEX2izXgzRXU0oJ2eMtt/h5+g1to+YA3X8vu31UQ46OYBnxxroecApxZ61/4p2+spwkYHtwSpeXag07s4u5NDMqeawAX/B0zRaySTzX0VfW5XYt0+HpxmTue7eu+T1qdqdmjvRoHdHxdVMAtur3Uhdil3Livi1k/Co+hcU/Q/R9rHmY7P0Xpi+mTiTROvQawIx4E+AXssT2J6Ydd9S2nrdwsXQReXj96+2xL616HlaoXFi4S6Sv7Voago67MWGeocUgEuAxqzhun0/xc+f7o6b04cz3LexZ9SjPnsuM66ENfYok6NYt6yBxJ4NGfG2MYYPtNnC3YlLAcpFRr329n4VFKJ9YlPm9xKNERjwK4ctTOKakKdzXRx+T9LTH1jWPN9shu7lyV1mnm3Ak7NJFO+SWBdEaUXOi0mMgaxIRz20FeGGt+gkSjcnTHYJnAtHy74EGqQ3nbH81G4ak/ERo6KWSWhzkz4K8D8/rZylfjqfv3AjIqGoh7Jz71l7ty2Roca8mdeudeIXWvuq4DJ8a8N1RvF"
}
'

Response parameters (Decrypted)

This API will provide a token in the response that must be decrypted using the Decrypt API. The decrypted response is similar to the following:

Parameter	Type	Parameter Requirement	Description
messageCode	Numeric(4)	Mandatory	API Unique IDentifier.
clientTxnId	String(100)	Mandatory	Unique ID generated by the calling application for each API request.
urn	Numeric(11)	Mandatory	Unique reference number for the customer.
customerId	String(20)	Mandatory	Unique identifier for the customer.
accosaTransactionId	Numeric(10)	Mandatory	Unique ID for a particular transaction generated in Prepaid.
transactionAmount	Numeric(12)	Mandatory	Transaction amount for which card/wallet to be credited. It is in implied decimals based on the currency. E.g. INR 5.25 is 525 in implied decimal format.
availableBalance	Numeric (12)	Conditional	Available balance (implied decimals)

Sample response (Decrypted)

{
    "customerId": "000000000048",
    "responseCode": "00",
    "messageCode": 1681,
    "clientTxnId": "FunDTrJMphIBit3e33111308",
    "clientId": "2030",
    "responseDateTime": "20240131161033",
    "accosaTransactionId": 11540,
    "responseMessage": "SUCCESS",
    "bankId": 7030,
    "transactionAmount": 3800,
    "senders": [
        {
            "urn": 70000001242,
            "customerId": "000000000048",
            "accosaRefNo": 73,
            "availableBalance": 96200,
            "transactionAmount": 3800
        }
    ],
    "receivers": [
        {
            "urn": 70000001241,
            "customerId": "000000000047",
            "accosaRefNo": 74,
            "availableBalance": 103800,
            "transactionAmount": 3800
        }
    ]
}

Error codes

Response Code	Description
00	SUCCESS
1030	INVALID MESSAGE
1031	INVALID BANK ID
1032	INVALID_CLIENT_CHANNEL
1049	INVALID SECURE CODE
1051	CHECKSUM FAILURE
1052	SYSTEM_ERROR
1054	DUPLICATE REQUEST
1055	MALFORMED_REQUEST
1080	IP_NOT_ALLOWED
1081	OPERATION NOT ALLOWED
1085	PRODUCT NOT ALLOWED
1088	INVALID REQUEST DATE format
1093	INVALID CLIENT TXN ID
1104	TRANSACTION AMOUNT MISMATCH
1107	SENDER CARD NOT FOUND
1110	RECEIVER CARD NOT FOUND
1262	CLIENT ID NOT PRESENT IN THE REQUEST
1264	BANK ID NOT PRESENT IN THE REQUEST
1310	XCONSUMERKEY NOT PRESENT IN THE REQUEST
1311	SECURE CODE NOT PRESENT IN REQUEST
1320	REQUEST_DATETIME_IS_MANDATORY
6900	SENDER ACCOUNT NUMBER NULL OR EMPTY
6901	RECEIVER ACCOUNT NUMBER NULL OR EMPTY
6902	SENDER RECEIVER INVALID ACCOUNT NUMBER
6905	INVALID ACCOUNT NUMBER IN REQUEST
6906	SENDER IMPL ID MISMATCH
6907	RECEIVER IMPL ID MISMATCH
6909	SENDER CUSTOMER NOT FOUND
6910	RECEIVER CUSTOMER NOT FOUND
6911	INVALID RESERVED FIELD 1
6912	INVALID RESERVED FIELD 2
6913	INVALID RESERVED FIELD 3
6914	INVALID RESERVED FIELD 4
6915	INVALID RESERVED FIELD 5
6916	INVALID RESERVED FIELD 6
6917	MORE THAN ONE CUSTOMER IDENTIFIER NOT ALLOWED FOR SENDER
6918	MORE THAN ONE CUSTOMER IDENTIFIER NOT ALLOWED FOR RECEIVER
6919	TRANSFER AMOUNT MORE THAN AVAILABLE BALANCE OF SENDER
6920	SOURCE ACCOUNT TYPE MUST BE A NUMBER WITH MAX LENGTH 2
6921	SENDER TRANSACTION AMOUNT IS ZERO OR INVALID
6922	SENDER URN LENGTH EXCEEDED
6923	SENDER ACCOUNT NUMBER LENGTH EXCEEDED
6924	SENDER TRANSACTION AMOUNT LENGTH EXCEEDED
6925	SENDER SOURCE ACCOUNT LENGTH EXCEEDED
6926	SENDER ACCOUNT NUMBER CURRENCY LENGTH EXCEEDED
6927	RECEIVER URN LENGTH EXCEEDED
6928	RECEIVER TRANSACTION AMOUNT LENGTH EXCEEDED
6929	RECEIVER ACCOUNT NUMBER LENGTH EXCEEDED
6930	SENDER CUSTOMER ID LENGTH EXCEEDED
6931	RECEIVER CUSTOMER ID LENGTH EXCEEDED
6932	SENDER RESERVED FIELD LENGTH EXCEEDED
6933	RECEIVER RESERVED FIELD LENGTH EXCEEDED
6934	RECEIVER TRANSACTION AMOUNT IS ZERO OR INVALID
10027	CURRENCY NOT PRESENT
303178	Request DateTime Length should not be more than 14 characters
303193	Message Code cannot be Blank, Empty or null
6936	FIELD OUT OF RANGE FOR DATA TYPE
1045	UNABLE TO PROCESS REQUEST CAUSE OF UNKNOWN FIELD
7948	PROGRAM LEVEL OUTSTANDING BALANCE BREACHED

Wallet-to-Wallet Fund Transfer API

📘
Note:

Request parameters

📘Note:

Request parameters

📘
Note: