Bit - Refund
posthttps://api.tranzila.com/v1/transaction/bit/refund
Use the transaction_id in the same terminal that transaction was initiated.
The customer will get an SMS from Bit about the refund with the refund sum.
Request
Headers
X-tranzila-api-app-keystringrequired
Application public key supplied by Tranzila
Example:
vnNtAoXX735jmQviLuMgXEk1fGNCasL92UKW4GLBh8Kk442gK7TqddLNuPnNReixTJI9z8b1g0AX-tranzila-api-request-timestringrequired
Request time sent in Unix format (large integer counting milliseconds from Jan 1 st , 1970 00:00:00
Example:
1682854362X-tranzila-api-noncestringrequired
A 40 bytes NONCE – unique random string generated with any random bytes function
Example:
KHitwR6Gsh5m5V5mgLOcUryE8msIhmtco1D9MSyHhBcHAppIt6rjXPAXeIveLuSfv1wLi05hbG19P0YDX-tranzila-api-access-tokenstringrequired
hash_hmac using ‘sha256’ on application key with secret + request-time + nonce. hash_hmac is available for all programming languages with samples found here: https://www.jokecamp.com/blog/examples-of-creating-base64-hashes-using-hmac-sha256-in- different-languages/
Example:
c4b3a017d5374cc96d4f4b320d619b195efd05e63da66400f94188ec49f26766Body
application/jsonterminal_namestring
transaction_idinteger
amountnumber
Responses
The response can be 200 with an Application error code:
| Error Code | Description |
|---|---|
| 20106 | Already refunded |
| 20107 | Refund error |
| 20109 | Refund amount is greater than original transaction amount |
| 20110 | Pending transaction not found |