Transaction

Module endpoints

GET /transactions

GET https://api.slyk.io/transactions

Retrieves a paginated list of transactions.

Name

Type

Example

assetCode

= in nin

filter[assetCode]=in:USD,EUR,BTC

code

= in nin

filter[code]=in:internal,bank:wire

createdAt

= gte lte

filter[createdAt]=lte:2019-07-21

description

like

filter[description]=some description excerpt

destinationWalletId

= in nin

filter[destinationWalletId]=705af61e-1387-49b0-90f8-45c39fe56686

externalId

= in nin

filter[externalId]=in:3feaac72-7330-4b32-9801-28b6f69aaf25,705af61e-1387-49b0-90f8-45c39fe56686

externalReference

=

filter[externalReference]=thud

id

= in nin

filter[id]=nin:802a5163-7ad3-4047-b600-088c1f746733,9d3bed88-34b6-4a06-aa79-ed4b32ba0d44

originWalletId

= in nin

filter[originWalletId]=705af61e-1387-49b0-90f8-45c39fe56686

reference

=

filter[originWalletId]=waldo

status

= in nin

filter[status]=nin:pending,failed,rejected

type

= in nin

filter[type]=in:deposit

walletId

= in nin

filter[walletId]=802a5163-7ad3-4047-b600-088c1f746733

The description filter performs a SQL query using the like operator.

The walletId filter will return any transaction where its set as destinationWalletId or originWalletId.

GET /transactions/:id

GET https://api.slyk.io/transactions/:id

Retrieves the transactions of the given id.

{
  "data": {
    "amount": "10.00",
    "assetCode": "usd",
    "code": "internal",
    "createdAt": "2019-07-20T14:30:37.483Z",
    "customData": {},
    "description": "A deposit transaction so `originWalletId` field is `null`",
    "destinationAddress": null,
    "destinationWalletId": "2a5489f2-73a5-4cba-a6b2-0b77b1ad94ce",
    "externalId": null,
    "externalReference": null,
    "id": "35589275-5db3-4b99-88cc-0bbdaa94ae8f",
    "metadata": {},
    "originAddress": null,
    "originWalletId": null,
    "status": "rejected",
    "type": "deposit",
    "updatedAt": "2019-07-20T14:30:37.483Z"
  }
}

POST /transactions/:id/approve

POST https://api.slyk.io/transactions/:id/approve

Approves the transaction of the given id.

Its only possible to approve transactions that are pending.

{
  "data": {
    "amount": "9800.00000000",
    "assetCode": "eur",
    "code": "bank:wire",
    "createdAt": "2019-07-20T14:30:37.483Z",
    "customData": {
      "month": "03",
      "year": "2020"
    }
    "description": "Salary",
    "destinationAddress": null,
    "destinationWalletId": null,
    "externalId": null,
    "externalReference": null,
    "id": "35589275-5db3-4b99-88cc-0bbdaa94ae8f",
    "metadata": {
      "transactionData": {
        "bankAddress": "Tussen Meer 375C, 1069 DR Amsterdam",
        "bankName": "IGN",
        "country": "Netherlands",
        "iban": "NL64INGB8219153XXX",
        "swiftCode": "INGBNL2AXXX"
      }
    },
    "originAddress": null,
    "originWalletId": "167d4b2b-5607-47d1-b54a-fb9036bf40dd",
    "status": "processing",
    "type": "withdrawal",
    "updatedAt": "2019-07-20T14:30:37.483Z"
  }
  }
}

POST /transactions/:id/confirm

POST https://api.slyk.io/transactions/:id/confirm

Confirms the transaction of the given id.

{
  "data": {
    "amount": "9800.00000000",
    "assetCode": "eur",
    "code": "bank:wire",
    "createdAt": "2019-07-20T14:30:37.483Z",
    "customData": {
      "month": "03",
      "year": "2020"
    }
    "description": "Salary",
    "destinationAddress": null,
    "destinationWalletId": null,
    "externalId": null,
    "externalReference": null,
    "id": "35589275-5db3-4b99-88cc-0bbdaa94ae8f",
    "metadata": {
      "transactionData": {
        "bankAddress": "Tussen Meer 375C, 1069 DR Amsterdam",
        "bankName": "IGN",
        "country": "Netherlands",
        "iban": "NL64INGB8219153XXX",
        "swiftCode": "INGBNL2AXXX"
      }
    },
    "originAddress": null,
    "originWalletId": "167d4b2b-5607-47d1-b54a-fb9036bf40dd",
    "status": "completed",
    "type": "withdrawal",
    "updatedAt": "2019-07-20T14:30:37.483Z"
  }
}

POST /transactions/:id/fail

POST https://api.slyk.io/transactions/:id/fail

Fails the transaction of the given id.

Field

Type

Required

Description

reason

string

false

Fail reason.

POST /transactions/:id/reject

POST https://api.slyk.io/transactions/:id/reject

Rejects the transaction of the given id.

Its only possible to reject transactions that are pending.

Field

Type

Required

Description

reason

string

false

Reject reason.

POST /transactions/deposit

POST https://api.slyk.io/transactions/deposit

Creates a new deposit transaction.

Field

Type

Required

Description

amount

string

true

Transacted amount.

assetCode

string

true

Code of the asset being transacted.

code

string

true

Defines through which feature and method the assets will be deposited (more information below).

commit

boolean

false

Transaction is created already as processing. Only available for crypto, bank and internal code features. Default: false.

customData

object

false

Stores any additional information the user may provide.

data

object

true

May contain necessary data for the payment gateway. The information required in this field depends on the provided code method.

description

string

false

A free text field.

destinationAddress

string

false

Destination address.

destinationWalletId

string

true

ID of the wallet where the assets are being deposited. Format: uuid.

externalReference

string

false

External reference.

POST /transactions/pay

POST https://api.slyk.io/transactions/pay

Creates a new transfer transaction with the code set to pay and set the defaultWalletId as the destinationWalletId.

Name

Type

Required

Description

amount

string

true

Transacted amount.

assetCode

string

true

Code of the asset being transacted.

customData

object

false

Stores any additional information the user may provide.

description

string

false

A free text field.

originWalletId

string

true

ID of the wallet from where the assets are coming. Format: uuid.

POST /transactions/transfer

POST https://api.slyk.io/transactions/transfer

Creates a new transfer transaction.

Field

Type

Required

Description

amount

string

true

Transacted amount.

assetCode

string

true

Code of the asset being transacted.

code

string

true

Defines through which feature and method the assets will be transfered.

commit

boolean

false

Confirms the transaction on creation. Default: false.

customData

object

false

Stores any additional information the user may provide.

description

string

false

A free text field.

destinationAddress

string

false

Destination address.

destinationWalletId

string

true

ID of the wallet where the assets are being deposited. Format: uuid.

externalReference

string

false

External Reference.

originAddress

string

false

Origin address.

originWalletId

string

true

ID of the wallet from where the assets are coming. Format: uuid.

POST /transactions/withdrawal

POST https://api.slyk.io/transactions/withdrawal

Creates a new withdrawal transaction.

Field

Type

Required

Description

amount

string

true

Transacted amount.

assetCode

string

true

Code of the asset being transacted.

code

enum<string>

true

Defines through which feature and method the assets will be withdrawn (there are more informations about it following this table).

commit

boolean

false

Transaction is created already as processing. Only available for crypto, bank and internal code features. Default: false.

customData

object

false

Stores any additional information the user may provide.

description

string

false

A free text field.

externalReference

string

false

External Reference.

originAddress

string

false

Origin address.

originWalletId

string

true

ID of the wallet from where the assets are coming. Format: uuid.

PreviousWalletNextAddress

Last updated

Was this helpful?