Card Top-Up

Node

Child Node

Type 

Length 

Description

Remarks

header

msg_id

String

12

Unique Source Message ID

Mandatory

msg_type

String

13

Request Type Default: "TRANSACTION"

Mandatory

msg_function

String

50

Function name to be used Default: "REQ_CARD_TOPUP"

Mandatory

src_application

String

5

Source requesting channel  e.g. “IVR”

Mandatory

target_application 

String

10

Target application name e.g. : “PCMS”

Mandatory

timestamp

String

50

Timestamp of the request Format  “DD/MM/YYYY HH:MM:SS”

Mandatory

tracking_id

String

15

Transaction Tracking ID

Mandatory

bank_id

String

4

Source Bank e.g. “bankID”

Mandatory

instance_id

String

10

N/A

Optional

body

card_no

String

Min-16

Max-19

15/19-digit card no

e.g:

XXXXXXXXXXXX0833

First 6 digits will be BIN for PCMS cards

Mandatory 

topup_amount

String

8

Transaction Amount in Wallet Currency Sample: 2000.00

Mandatory

reference_number 

String

20

Unique reference id for the topup transaction  Acquirer Request Number            Sample  160119155439.2694

Mandatory

Node

Child Node

Type 

Length 

Description

Remarks

header

msg_id

String

12

The msg_id sent in the request will be sent back in response in this field.

Mandatory

msg_type

String

13

Request Type

Mandatory

msg_function

String

50

Function name to be used

Mandatory

src_application

String

5

The src_application sent in the request will be sent back in response in this field.

Source requesting channel e.g. “IVR”

Mandatory

target_application 

String

10

The target_application sent in the request will be sent back in response in this field.

Mandatory

timestamp

String

30

Timestamp of the response

Date & time. Format  “DD/MM/YYYY HH:MM:SS”

Mandatory

tracking_id

String

15

The tracking_id sent in the request will be sent back in response in this field.

Mandatory

bank_id

String

4

The bank_id sent in the request will be sent back in response in this field. E.g. ‘bankID’

Mandatory

exception_details

application_name

String

20

Tibco Application Name

Mandatory

date_time

String

30

Timestamp of the response

Format “DD/MM/YYYY HH:MM:SS”

Mandatory

status

String

1

Status of the request (S/F)

Success- S,  Failure - F

Mandatory

error_code

String

4

EAI Internal Error Code (Check error codes section for the complete list of error codes and error code descriptions)

Mandatory

error_description

String

100

Error Description (Check error codes section for the complete list of error codes and error code descriptions)

Mandatory

transaction_ref_id

String

20

The tracking_id sent in the request will be sent back in response in this field.

Optional

body

available_balance

String

Sample: 2000.00

Mandatory

card_holdername

String

Name of customer Sample: Muhammad Ahmed Khan

Optional

card_no

String

Card Number of the Customer Sample: 129283928398

Optional

topup_amount

String

Transaction Amount in Wallet Currency

Optional

unique_reference_number

String

Unique reference id for the topup transaction  Acquirer Request Number            Sample  160119155439.2694

Optional