Sign in

v1

latestOpenAPI 3.1.02026-08-04751,1671.3 MB
Transactions

Create Transaction And Wait

Create a new transaction and wait until transaction reaches given state.

post/api/v1/transactions/create-and-wait

Headers

x-signaturestring

Signature of the body. Base64 encoded string. If the request is made programatically by an API user, signing of the request is required and is intended to protect you from malicious backends. x_signature is valid for 120 seconds.

Example:SGVsbG8=

Signature of the body. Base64 encoded string. If the request is made programatically by an API user, signing of the request is required and is intended to protect you from malicious backends. x_signature is valid for 120 seconds.

x-timestampinteger

Timestamp of the signature. Integer. Specify an Epoch date. If the request is made programatically by an API user, the timestamp of the request is required and is intended to protect you from replay attacks.

Timestamp of the signature. Integer. Specify an Epoch date. If the request is made programatically by an API user, the timestamp of the request is required and is intended to protect you from replay attacks.

x-idempotence-idstring uuid

Optional idempotence ID of a transaction.

Optional idempotence ID of a transaction.

Request body

OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR

Example request

{
  "details": {
    "message_to_sign": "SGVsbG8="
  }
}

Response

Successful Response

idstring uuid required

The unique identifier of the object in the Fordefi platform.

created_atstring date-time required

The date and time when the object was created.

modified_atstring date-time required

The date and time when the object was last modified. Any change to any field of the resource is considered a modification.

signaturesstring[] required

The transaction signatures.

has_timed_outboolean required

Whether the transaction has timed out while waiting for the requested state.

Example response

{
  "signatures": [
    "SGVsbG8="
  ]
}