Comment on page
Transaction
Create and retrieve transactions.
Get transaction history for a given address.
Header | Type | Description |
X-REQUEST-SIGNATURE | string |
Attribute | Type | Description |
currency | string | |
address | string | The public address associated with the transactions. |
Attribute | Type | Description |
status | string | Optional. Either Confirmed or Incomplete .
Confirmed (default) - Only includes confirmed transactions on the blockchain. Incomplete - Only includes unconfirmed and failed transactions in Gluwa. |
offset | int | Optional. The number of entries to skip. |
limit | int | Optional. The number of transactions returned in in the response (max 100). |
HTTP Status | Return Object |
200 |
Attribute | Type | Description |
Status | string | The status of the transaction. Unconfirmed , Confirmed , or Failed .
Unconfirmed - The transaction was announce to the blockchain, but is not included in any block yet.
Confirmed - The transaction was included in the blockchain and received a confirmation. Failed - The transaction has failed for some reason. |
Amount | string | The amount sent or received in this transaction. |
TotalAmount | string | The sum of the Amount and the Fee . |
Currency | string | |
Sources | array of string | The sources of the transaction. For BTC, there can be multiple sources. |
Targets | array of string | The targets of the transaction. For BTC, there can be multiple targets. |
TxnHash | string | Blockchain transaction hash. |
CreatedDateTime | datetime | Time at which the transaction was created. |
ModifiedDateTime | datetime | Time at which the transaction was last modified. |
MerchantOrderID | string | Optional. Used by the receiver to identify a payment. Supported by QR code payment feature only. |
Note | string | Optional. A message attached to the transaction. It is an optional memo you can associate with the transaction. |
Fee | string | Optional. Transaction fee. |
ID | UUID | Optional. Gluwa's internal transaction ID. If the transaction was made outside of Gluwa's system (ex> Transaction was made directly on the blockchain), then this will not be available. |
HTTP Status | Error Code | Description |
400 | InvalidUrlParameters | Invalid URL parameters |
400 | BadRequest | Invalid address format. |
403 | SignatureMissing | X-REQUEST-SIGNATURE header is missing. |
403 | SignatureExpired | X-REQUEST-SIGNATURE has expired. |
403 | InvalidSignature | Invalid X-REQUEST-SIGNATURE . |
500 | InternalServerError | Server error. |
503 | ServiceUnavailable | Service unavailable for the specified currency |
Header | Type | Description |
X-REQUEST-SIGNATURE | string |
Attribute | Type | Description |
currency | string | |
txnhash | string | Blockchain transaction hash. |
HTTP Status | Return Object |
200 |
HTTP Status | Error Code | Description |
400 | InvalidUrlParameters | Invalid URL parameters |
400 | BadRequest | Invalid txnhash value. |
403 | SignatureMissing | X-REQUEST-SIGNATURE header is missing. |
403 | SignatureExpired | X-REQUEST-SIGNATURE has expired. |
403 | InvalidSignature | Invalid X-REQUEST-SIGNATURE . |
404 | NotFound | Transaction not found. |
500 | InternalServerError | Server error. |
503 | ServiceUnavailable | Service unavailable for the specified currency |
Attribute | Type | Description |
Signature | string | |
Amount | string | Transaction amount, not including the fee. This is the amount that the receiver receives. |
Fee | string | Transaction fee amount. Generally, you should use the amount from the Fee endpoint. Your transaction may not get processed by Gluwa if the fee amount is smaller than the minimum fee amount. |
Currency | string | |
Source | string | Address of the sender. |
Target | string | Address of the receiver. |
Nonce | string | Optional. Required if using Gluwacoin as the currency of the transaction. Nonce is an unsigned integer used when creating reserve transaction signature. It must be unique each time you make any new transactions (transfer, exchange, etc). Maximum value is 2^256-1. |
MerchantOrderID | string | Optional. A string value attached to the transaction which can be used for traceability between Gluwa and your application. |
Note | string | Optional. Optional memo attached to the transaction. |
Idem | UUID | |
PaymentID | UUID | Optional. A unique identifier for a payment used with QR code payment feature. You can get this value by decoding the QR code. |
PaymentSig | string | Optional. Required if PaymentID is not null. This is provided to you when you use QR Code endpoint. You can get this value by decoding the QR code. |
HTTP Status | Return Object |
202 |
Attribute | Type | Description |
TxnHash | string | BTC transaction hash. For Gluwacoin transactions, the transaction hash is not immediately available, so it is not included in the response. |
HTTP Status | Error Code | Description |
400 | InvalidUrlParameters | Invalid URL parameters |
400 | MissingBody | Request body is missing. |
400 | InvalidBody | Request validation errors. |
400 | ValidationError | Request validation errors. |
403 | InvalidPaymentSignature | Invalid payment signature. |
409 | Conflict | Transfer already exists. |
500 | InternalServerError | Server error. |
503 | ServiceUnavailable | Service unavailable for the specified currency |
Last modified 2yr ago