Get Transaction List
A merchant can perform following Invoice operations using our REST API.
Merchant can get List Of Transaction for the customer.
How to Get Transaction List?
Transaction List request has to be sent to our REST endpoint i.e. transactionServices/REST/v1/getTransactionList using POST method.
To get transaction list merchant first needs to generate authentication token and set it in header. To generate auth token please refer Auth token API.
Sample Request
Language:
curl https://sandbox.shimotomo.com/transactionServices/REST/v1/getTransactionList \ curl --header "AuthToken:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJjb25tZXJjaGFudDEiLCJyb2xlIjoibWVyY2hhbnQiLCJpc3MiOiJQWiIsImV4cCI6MTUwMTE0NjY0MX0.TFmGGKDUgkktmZQvrUTeox1buH1J6lgBVE3Mcy8OVjA" -d "authentication.memberId=11979" \ -d "authentication.checksum=1e8114a55e006b10fc5d9c67baf188d91" \ -d "authentication.key=ORuMcgduMstp1ckKCQwPrKNwT62gqz7b" \ -d "merchant.username=GloryDaleMerchant" \ -d "actionType=GET" \ -d "pagination.pageno=1" \ -d "pagination.records=30"
Sample Response
Language:
{ "result": { "code": "00029", "description": "Transaction details retrived successfully." }, "transaction": [ { "amount": "10.00", "currency": "USD", "systemPaymentId": "133543", "transactionStatus": "capturesuccess", "captureamount": "10.00", "refundamount": "0.00", "chargebackamount": "0.00", "payoutamount": "0.00", "date": "2020-09-14 19:18:13.0", "remark": "SYS:Transaction Successful", "customer": { "givenName": "kamleshkumari", "surname": "Choudhary", "phone": "7021113293", "email": "test@email.com", "telnocc": "91", "country": "IN", "city": "", "street": "" }, "card": { "bin": "411111", "lastFourDigits": "0021" }, "transactionReceiptImg": "Base64String" }, { "amount": "10.00", "currency": "USD", "systemPaymentId": "133527", "transactionStatus": "capturesuccess", "captureamount": "10.00", "refundamount": "0.00", "chargebackamount": "0.00", "payoutamount": "0.00", "date": "2020-09-14 17:19:05.0", "remark": "SYS:Transaction Successful", "customer": { "givenName": "kamleshkumari", "surname": "Choudhary", "phone": "7021113293", "email": "test@email.com", "telnocc": "91", "country": "IN", "city": "", "street": "" }, "card": { "bin": "411111", "lastFourDigits": "0021" }, "transactionReceiptImg": "Base64String" } ] }
Hashing Rule
Shimotomo is supporting MD5 Cryptographic Hash for the authenticity of payment request send to the server.
Below is the description of fields use for generating checksum.
- memberId <Merchant ID as shared by Shimotomo >
- secureKey <Secure Key that can be generated through Shimotomo's dashboard>
How to generate Checksum ?
Checksum has to be calculated with following combination and need to be send along with the authentication parameters in each server-to-server request:
Generate Invoice:
<memberId>|<memberSecureKey>
Sample Code
Language:
import java.security.MessageDigest def generateMD5Checksum() { String values= "memberID|key"; MessageDigest digest = MessageDigest.getInstance(MD5) digest.update(values.bytes); new BigInteger(1, digest.digest()).toString(16).padLeft(32, '0') }