Function 031 helps adjust the card balance up or down. This API call has three main parameters. The second parameter (P2) accepts both positive and negative amounts. A negative adjustment requires a (-) sign in front of the amount field. There is also a provision for the fee amount. Remember the fee always deduct the applied fee amount from the balance.
Inputs | Description | Required | Data Type |
---|---|---|---|
FunctionID | 031 | Y | |
P1 | PAN OR ALT ID | Y | (16,19) numeric |
P2 | Adjustment Amount (insert a negative sign (-) for adjusting balances down (e.g.: P2= – 200)). For adjusting amounts up simply put the adjustment amount. (E.g.: P2=300) |
Y | numeric |
P3 | Fee amount. This field will always deduct the applied amount from card balance |
Y | numeric |
P4 | Description for the transaction | Y | (0, 30) varchar |
P5 | Currency Code (ISO4217-Alpha) | N | (3) varchar |
P6 | Settlement Currency Code (ISO4217-Alpha) | N | (3) varchar |
Outputs | Description | ||
P1 | Error Code | Y | |
P2 | Error Text | Y | |
adjustme nt |
Adjustment Amount | N | |
fee | Fee Amount | N | |
Symbol | Conversion symbol | N | e.g.)AUDUSD |
Rate | Exchange Rate used for transaction | N |
Example: Adjustment Request
https://api.m2fin.com:8443/AuthENGINAPI/AuthENGINAPI?CID=5&CUSR=myuseraccount&CPWD=passwordassignedtome&FUNC=031&MSGID=00005089060000012&P1=PAN or ALT ID&P2=200&P3=100&P4=ServiceFee
Example: Adjustment Response
P1=0000&P2=Adjustment Successful
Example: Adjustment Request
https://api.m2fin.com
/AuthENGINAPI/AuthENGINAPI?CID=5&CUSR=myuseraccount&CPWD=passwordassigned
tome &FUNC=031&MSGID=00005098895747687&P1=PAN or ALT
ID&P2=1000&P3=100&P4=Card%20Adjustment&P5=AUD&P6=USD&appname=AuthENGINAPI&username=us
ername
/AuthENGINAPI/AuthENGINAPI?CID=5&CUSR=myuseraccount&CPWD=passwordassigned
tome &FUNC=031&MSGID=00005098895747687&P1=PAN or ALT
ID&P2=1000&P3=100&P4=Card%20Adjustment&P5=AUD&P6=USD&appname=AuthENGINAPI&username=us
ername
Example: Adjustment Response
P1=0000&P2=Adjustment
Successful&adjustment=1498&fee=75&Symbol=AUDUSD&Rate=0.74915000796318054
Successful&adjustment=1498&fee=75&Symbol=AUDUSD&Rate=0.74915000796318054