Transaction - ptxid
Most of the following API's will require a PTXID(Parent Transaction ID) and are based around handling transactions once they have been created. For information on how to create a transaction via a REST call, see the SID Section
Get the latest status of the transaction
Parent txid of the transaction
md5 hash of sid and rcode(this is a new version)
GET /api/v1/index.php/{ptxid}/getstatus HTTP/1.1
Host: uat.txshield.payshield.ai
Accept: */*
{
"tid": "text",
"txid": 1,
"parent_txid": 1,
"status": "text",
"tx_action": "text",
"amount": 1,
"currency": "text",
"reference": "text",
"ref1": "text",
"ref2": "text",
"ref3": "text",
"ref4": "text",
"vrfy": "text"
}
Requery the status of the transaction from gateway[Gateway dependant]
Parent txid of the transaction
sid of site
Rcode of the sid
Reference
url to which a postback should be sent
POST /api/v1/index.php/{ptxid}/requery HTTP/1.1
Host: uat.txshield.payshield.ai
Accept: */*
{
"tid": "text",
"txid": 1,
"parent_txid": 1,
"status": "text",
"tx_action": "text",
"amount": 1,
"currency": "text",
"reference": "text",
"ref1": "text",
"ref2": "text",
"ref3": "text",
"ref4": "text",
"vrfy": "text"
}
request to continue transaction submission with auth
Parent txid of the transaction
The authentication method.
The authentication value, either the SMS Code or Password.
Additional data required for processing. eg) Name|Card Number
md5(sid+rcode)
POST /api/v1/index.php/{ptxid}/sendauth HTTP/1.1
Host: uat.txshield.payshield.ai
Content-Type: multipart/form-data
Accept: */*
Content-Length: 69
{
"authtype": "SMS",
"authvalue": "text",
"miscdata": "text",
"hash": "text"
}
{
"tid": "text",
"txid": 1,
"parent_txid": 1,
"status": "text",
"tx_action": "text",
"amount": 1,
"currency": "text",
"reference": "text",
"ref1": "text",
"ref2": "text",
"ref3": "text",
"ref4": "text",
"vrfy": "text"
}
request to resend the auth
Parent txid of the transaction
md5(sid+rcode)
GET /api/v1/index.php/{ptxid}/resendauth HTTP/1.1
Host: uat.txshield.payshield.ai
Accept: */*
{
"tid": "text",
"txid": 1,
"parent_txid": 1,
"status": "text",
"tx_action": "text",
"amount": 1,
"currency": "text",
"reference": "text",
"ref1": "text",
"ref2": "text",
"ref3": "text",
"ref4": "text",
"vrfy": "text"
}
get access token
Username
Password
POST /api/v2/index.php/gettoken HTTP/1.1
Host: uat.txshield.payshield.ai
Content-Type: application/json
Accept: */*
Content-Length: 37
{
"username": "text",
"password": "text"
}
{
"tid": "text",
"txid": 1,
"parent_txid": 1,
"status": "text",
"tx_action": "text",
"amount": 1,
"currency": "text",
"reference": "text",
"ref1": "text",
"ref2": "text",
"ref3": "text",
"ref4": "text",
"vrfy": "text"
}
processrefund
processrefund uses your Bearer token for Authentication and takes in JSON data. If the transaction is still a PREAUTH that hasn't been settled, the transaction will be VOID instead. It should be noted that you can't do a partial VOID, a VOID is for the full transaction amount. You can however do a partial refund.
Parent Transaction Id to get the tx_Action list
POST /api/v3/txprocess/transaction/{parentxid}/processrefund HTTP/1.1
Host: uat.txshield.payshield.ai
Authorization: Bearer JWT
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 30
"amount=1¤cy='text'"
{
"sid": 1,
"status": "text",
"parent_txid": 1,
"txid": 1,
"tx_action": "text",
"amount": 0,
"currency": "text",
"tid": "text",
"ref1": "text",
"ref2": "text",
"ref3": "text",
"ref4": "text",
"comment": "text",
"descriptor": "text",
"pay_method": "text"
}
Last updated