---
updatedAt: 2026-03-17T16:01:36.000Z
agentTools:
  siteIndex: https://docs.bitso.com/llms.txt
  projectIndex: https://docs.bitso.com/juno/llms.txt
---

# Create a transaction

Creates a new transaction of the specified type. Supported types are ISSUANCE (mint stablecoins), REDEMPTION (burn stablecoins and settle fiat), and CONVERSION (execute a previously obtained quote). ISSUANCE and REDEMPTION are currently available for BRL1 operations only. CONVERSION is available for MXNB. The response is returned with HTTP 202 Accepted since transaction processing is asynchronous.

# OpenAPI definition

````json
{
  "openapi": "3.0.2",
  "info": {
    "title": "Juno API",
    "version": "v1.0"
  },
  "servers": [
    {
      "url": "https://stage.buildwithjuno.com",
      "description": "Juno stage environment"
    },
    {
      "url": "https://buildwithjuno.com",
      "description": "Juno production environment"
    }
  ],
  "security": [
    {
      "BitsoAuth": []
    }
  ],
  "tags": [
    {
      "description": "Transaction management operations",
      "name": "Transactions"
    }
  ],
  "paths": {
    "/mint_platform/v2/transactions": {
      "post": {
        "description": "Creates a new transaction of the specified type. The request body is polymorphic: the 'type' field determines which payload shape is expected. Supported types are ISSUANCE (mint stablecoins), REDEMPTION (burn stablecoins and settle fiat), and CONVERSION (execute a previously obtained quote). The response is returned with HTTP 202 Accepted since transaction processing is asynchronous.",
        "operationId": "createTransaction",
        "parameters": [
          {
            "description": "Client-generated idempotency key to prevent duplicate transaction creation. If a request with the same key was already processed, the original response is returned.",
            "example": "idem-key-abc-123",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 36,
              "minLength": 0
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "Conversion": {
                  "description": "Conversion",
                  "summary": "Create a conversion transaction",
                  "value": {
                    "type": "CONVERSION",
                    "external_ref": "ext-ref-conv-001",
                    "conversion": {
                      "quote_id": "550e8400-e29b-41d4-a716-446655440000"
                    }
                  }
                },
                "Issuance": {
                  "description": "Issuance",
                  "summary": "Create an issuance (mint) transaction",
                  "value": {
                    "type": "ISSUANCE",
                    "external_ref": "ext-ref-12345",
                    "issuance": {
                      "asset": "MXNB",
                      "amount": "1000.00"
                    }
                  }
                },
                "Redemption": {
                  "description": "Redemption",
                  "summary": "Create a redemption (burn) transaction",
                  "value": {
                    "type": "REDEMPTION",
                    "external_ref": "ext-ref-67890",
                    "redemption": {
                      "asset": "MXN",
                      "amount": "500.00",
                      "receiver_account": {
                        "type": "MEXICAN_BANK_ACCOUNT",
                        "mexican_bank_account": {
                          "clabe": "012345678901234567"
                        }
                      }
                    }
                  }
                }
              },
              "schema": {
                "$ref": "#/components/schemas/TransactionCreateRequest"
              }
            }
          },
          "description": "Transaction creation request. The 'type' field determines the required payload.",
          "required": true
        },
        "responses": {
          "202": {
            "content": {
              "application/json": {
                "examples": {
                  "Conversion": {
                    "description": "Conversion",
                    "summary": "Accepted conversion transaction",
                    "value": {
                      "id": "d4e5f6a7-b8c9-0123-defa-234567890123",
                      "created_at": "2026-02-03T09:00:00Z",
                      "updated_at": "2026-02-03T09:00:00Z",
                      "status": "PENDING",
                      "external_ref": "ext-ref-conv-001",
                      "type": "CONVERSION",
                      "conversion": {
                        "quote_id": "550e8400-e29b-41d4-a716-446655440000"
                      }
                    }
                  },
                  "Issuance": {
                    "description": "Issuance",
                    "summary": "Accepted issuance transaction",
                    "value": {
                      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
                      "created_at": "2026-01-20T14:00:00Z",
                      "updated_at": "2026-01-20T14:00:00Z",
                      "status": "IN_PROGRESS",
                      "external_ref": "ext-ref-12345",
                      "type": "ISSUANCE",
                      "issuance": {
                        "asset": "MXNB",
                        "amount": "1000.00"
                      }
                    }
                  },
                  "Redemption": {
                    "description": "Redemption",
                    "summary": "Accepted redemption transaction",
                    "value": {
                      "id": "f3587f27-452f-4b18-9c34-6599171f6be7",
                      "created_at": "2026-01-15T10:30:00Z",
                      "updated_at": "2026-01-15T10:30:00Z",
                      "status": "IN_PROGRESS",
                      "external_ref": "ext-ref-67890",
                      "type": "REDEMPTION",
                      "redemption": {
                        "asset": "MXN",
                        "amount": "500.00",
                        "destination_bank_account_id": "ba-12345"
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/TransactionCreateResponse"
                }
              }
            },
            "description": "Transaction accepted for processing"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "errors": [
                    {
                      "code": "invalid_field",
                      "message": "issuance.amount: must not be null"
                    }
                  ]
                },
                "schema": {
                  "$ref": "#/components/schemas/BadRequestErrorResponse"
                }
              }
            },
            "description": "Bad request — validation error or malformed input"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UnauthorizedErrorResponse"
                }
              }
            },
            "description": "Container error schema for authorization errors."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ForbiddenErrorResponse"
                }
              }
            },
            "description": "Container error schema for forbidden errors."
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NotFoundErrorResponse"
                }
              }
            },
            "description": "Container error schema for not found errors."
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TooManyRequestsErrorResponse"
                }
              }
            },
            "description": "Container error schema for rate-limiting errors."
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InternalErrorResponse"
                }
              }
            },
            "description": "Container error schema for internal errors."
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServiceUnavailableErrorResponse"
                }
              }
            },
            "description": "Container error schema for service unavailable errors."
          }
        },
        "summary": "Create a transaction",
        "tags": [
          "Transactions"
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "ApiKeyDisabledError": {
        "description": "Disabled API key error schema. Indicates the API key used to sign the request is disabled.",
        "properties": {
          "code": {
            "type": "string",
            "default": "api_key_disabled",
            "description": "Error code.",
            "example": "api_key_disabled"
          },
          "message": {
            "type": "string",
            "default": "The API key used to sign the request is disabled.",
            "description": "Error message.",
            "example": "The API key used to sign the request is disabled."
          }
        }
      },
      "ApiKeyInvalidFormatError": {
        "description": "Invalid API format key error schema. Indicates the API key used to sign the request has an invalid format.",
        "properties": {
          "code": {
            "type": "string",
            "default": "api_key_invalid_format",
            "description": "Error code.",
            "example": "api_key_invalid_format"
          },
          "message": {
            "type": "string",
            "default": "The API key used to sign the request has an invalid format. The API key should contain only letters and numbers, and its length must be 10.",
            "description": "Error message.",
            "example": "The API key used to sign the request has an invalid format. The API key should contain only letters and numbers, and its length must be 10."
          }
        }
      },
      "ApiKeyNotFoundError": {
        "description": "Invalid API key not found error schema. Indicates the API key used to sign the request was not found.",
        "properties": {
          "code": {
            "type": "string",
            "default": "api_key_not_found",
            "description": "Error code.",
            "example": "api_key_not_found"
          },
          "message": {
            "type": "string",
            "default": "The API key used to sign the request was not found.",
            "description": "Error message.",
            "example": "The API key used to sign the request was not found."
          }
        }
      },
      "BadRequestErrorResponse": {
        "description": "Container error schema for bad request errors.",
        "properties": {
          "errors": {
            "type": "array",
            "items": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/InvalidFieldError"
                },
                {
                  "$ref": "#/components/schemas/UnparseableInputError"
                },
                {
                  "$ref": "#/components/schemas/MissingParameterError"
                }
              ],
              "description": "Bad request error schema."
            },
            "minItems": 1,
            "uniqueItems": true
          }
        }
      },
      "ErrorDefinition": {
        "allOf": [
          {
            "$ref": "#/components/schemas/InternalError"
          },
          {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              }
            }
          }
        ],
        "description": "Internal error schema."
      },
      "ForbiddenErrorResponse": {
        "description": "Container error schema for forbidden errors.",
        "example": {
          "errors": [
            {
              "code": "forbidden_request",
              "message": "Permission denied. You do not have the required authorization to access this resource or perform this action."
            }
          ]
        },
        "properties": {
          "errors": {
            "type": "array",
            "items": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/ForbiddenRequestError"
                },
                {
                  "$ref": "#/components/schemas/IpAddressNotAllowedError"
                },
                {
                  "$ref": "#/components/schemas/SuspendedAccountError"
                }
              ],
              "description": "Forbidden error schema."
            },
            "minItems": 1,
            "uniqueItems": true
          }
        }
      },
      "ForbiddenRequestError": {
        "description": "Authorization error schema. Indicates the authenticated user lacks necessary permissions.",
        "properties": {
          "code": {
            "type": "string",
            "default": "forbidden_request",
            "description": "Error code.",
            "example": "forbidden_request"
          },
          "message": {
            "type": "string",
            "default": "Permission denied. You do not have the required authorization to access this resource or perform this action.",
            "description": "Error message.",
            "example": "Permission denied. You do not have the required authorization to access this resource or perform this action."
          }
        }
      },
      "InternalError": {
        "description": "Internal error schema. Indicates the system encountered an internal error.",
        "properties": {
          "code": {
            "type": "string",
            "default": "internal_error",
            "description": "Error code.",
            "example": "internal_error"
          },
          "message": {
            "type": "string",
            "default": "Internal error.",
            "description": "Error message.",
            "example": "Internal error."
          }
        }
      },
      "InternalErrorResponse": {
        "description": "Container error schema for internal errors.",
        "example": {
          "errors": [
            {
              "code": "internal_error",
              "message": "Internal error."
            }
          ]
        },
        "properties": {
          "errors": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ErrorDefinition"
            },
            "maxItems": 1,
            "minItems": 1,
            "uniqueItems": true
          }
        }
      },
      "InvalidFieldError": {
        "description": "Invalid field error schema. Indicates the provided request has an invalid field.",
        "properties": {
          "code": {
            "type": "string",
            "default": "invalid_field",
            "description": "Error code.",
            "example": "invalid_field"
          },
          "message": {
            "type": "string",
            "description": "Error message."
          }
        }
      },
      "IpAddressNotAllowedError": {
        "description": "Invalid IP error schema. Indicates the IP address to access the resource is not allowed.",
        "properties": {
          "code": {
            "type": "string",
            "default": "ip_address_not_allowed",
            "description": "Error code.",
            "example": "ip_address_not_allowed"
          },
          "message": {
            "type": "string",
            "default": "IP address is not allowed to access the resource.",
            "description": "Error message.",
            "example": "IP address is not allowed to access the resource."
          }
        }
      },
      "MissingParameterError": {
        "description": "Missing parameter error schema. Indicates the provided request is missing a required parameter.",
        "properties": {
          "code": {
            "type": "string",
            "default": "missing_parameter",
            "description": "Error code.",
            "example": "missing_parameter"
          },
          "message": {
            "type": "string",
            "description": "Error message.",
            "example": "sender_id parameter is missing."
          }
        }
      },
      "NotFoundErrorResponse": {
        "description": "Container error schema for not found errors.",
        "example": {
          "errors": [
            {
              "code": "resource_not_found",
              "message": "Resource not found."
            }
          ]
        },
        "properties": {
          "errors": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ErrorDefinition"
            },
            "maxItems": 1,
            "minItems": 1,
            "uniqueItems": true
          }
        }
      },
      "RequestNonceAlreadyInUseError": {
        "description": "Request nonce already in use error schema. Indicates the provided request nonce was already used.",
        "properties": {
          "code": {
            "type": "string",
            "default": "request_nonce_already_in_use",
            "description": "Error code.",
            "example": "request_nonce_already_in_use"
          },
          "message": {
            "type": "string",
            "default": "The provided request nonce was already used.",
            "description": "Error message.",
            "example": "The provided request nonce was already used."
          }
        }
      },
      "RequestNonceDatetimeError": {
        "description": "Request nonce date-time error schema. Indicates the provided request nonce has a invalid date-time range.",
        "properties": {
          "code": {
            "type": "string",
            "default": "request_nonce_date_time_error",
            "description": "Error code.",
            "example": "request_nonce_date_time_error"
          },
          "message": {
            "type": "string",
            "default": "The request nonce date-time must be in the past and is valid only for 30 seconds.",
            "description": "Error message.",
            "example": "The request nonce date-time must be in the past and is valid only for 30 seconds."
          }
        }
      },
      "RequestNonceNegativeError": {
        "description": "Request nonce negative error schema. Indicates the nonce provided for the request is negative value.",
        "properties": {
          "code": {
            "type": "string",
            "default": "request_nonce_negative",
            "description": "Error code.",
            "example": "request_nonce_negative"
          },
          "message": {
            "type": "string",
            "default": "The request nonce must be a positive number.",
            "description": "Error message.",
            "example": "The request nonce must be a positive number."
          }
        }
      },
      "RequestSignatureInvalidError": {
        "description": "Request signature invalid error schema. Indicates the request signature is invalid.",
        "properties": {
          "code": {
            "type": "string",
            "default": "request_signature_invalid",
            "description": "Error code.",
            "example": "request_signature_invalid"
          },
          "message": {
            "type": "string",
            "default": "The request signature used for the request is invalid.",
            "description": "Error message.",
            "example": "The request signature used for the request is invalid."
          }
        }
      },
      "ServiceUnavailableErrorResponse": {
        "description": "Container error schema for service unavailable errors.",
        "example": {
          "errors": [
            {
              "code": "service_unavailable",
              "message": "Service temporarily unavailable. Please try again later."
            }
          ]
        },
        "properties": {
          "errors": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ErrorDefinition"
            },
            "maxItems": 1,
            "minItems": 1,
            "uniqueItems": true
          }
        }
      },
      "SuspendedAccountError": {
        "description": "Suspended account error schema. Indicates the user's account is suspended.",
        "properties": {
          "code": {
            "type": "string",
            "default": "suspended_account",
            "description": "Error code.",
            "example": "suspended_account"
          },
          "message": {
            "type": "string",
            "default": "Account is currently suspended. Please, contact customer support for additional information.",
            "description": "Error message.",
            "example": "Account is currently suspended. Please, contact customer support for additional information."
          }
        }
      },
      "TooManyRequestsErrorResponse": {
        "description": "Container error schema for rate-limiting errors.",
        "example": {
          "errors": [
            {
              "code": "too_many_requests",
              "message": "Too many requests were made in the current time period."
            }
          ]
        },
        "properties": {
          "errors": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ErrorDefinition"
            },
            "maxItems": 1,
            "minItems": 1,
            "uniqueItems": true
          }
        }
      },
      "TransactionCreateRequest": {
        "type": "object",
        "description": "Request body for creating a transaction. The 'type' field determines the payload shape.",
        "discriminator": {
          "propertyName": "type"
        },
        "properties": {
          "external_ref": {
            "type": "string",
            "description": "Client-provided external reference for idempotency and tracing",
            "example": "ext-ref-12345"
          },
          "type": {
            "$ref": "#/components/schemas/TransactionCreateType",
            "description": "Type of transaction to create",
            "enum": [
              "ISSUANCE",
              "REDEMPTION",
              "CONVERSION"
            ],
            "example": "ISSUANCE"
          }
        },
        "required": [
          "type"
        ]
      },
      "TransactionCreateResponse": {
        "type": "object",
        "description": "Response body for a created transaction",
        "properties": {
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the transaction was created",
            "example": "2026-01-15T10:30:00Z"
          },
          "external_ref": {
            "type": "string",
            "description": "Client-provided external reference, echoed back for correlation",
            "example": "ext-ref-12345"
          },
          "id": {
            "type": "string",
            "description": "Unique identifier of the created transaction",
            "example": "f3587f27-452f-4b18-9c34-6599171f6be7"
          },
          "status": {
            "type": "string",
            "description": "Current status of the transaction",
            "example": "PENDING"
          },
          "type": {
            "$ref": "#/components/schemas/TransactionCreateType",
            "description": "Type of the created transaction",
            "enum": [
              "ISSUANCE",
              "REDEMPTION",
              "CONVERSION"
            ],
            "example": "ISSUANCE"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the transaction was last updated",
            "example": "2026-01-15T10:35:00Z"
          }
        },
        "required": [
          "type"
        ]
      },
      "TransactionCreateType": {
        "type": "string",
        "description": "Type of transaction for create operations",
        "enum": [
          "ISSUANCE",
          "REDEMPTION",
          "CONVERSION"
        ]
      },
      "UnauthorizedError": {
        "description": "Authentication error schema. Indicates missing or invalid authentication credentials.",
        "properties": {
          "code": {
            "type": "string",
            "default": "unauthorized_request",
            "description": "Error code."
          },
          "message": {
            "type": "string",
            "default": "Authentication required. Valid credentials must be provided to access this resource.",
            "description": "Error message."
          }
        }
      },
      "UnauthorizedErrorResponse": {
        "description": "Container error schema for authorization errors.",
        "properties": {
          "errors": {
            "type": "array",
            "items": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/UnauthorizedError"
                },
                {
                  "$ref": "#/components/schemas/ApiKeyInvalidFormatError"
                },
                {
                  "$ref": "#/components/schemas/ApiKeyNotFoundError"
                },
                {
                  "$ref": "#/components/schemas/ApiKeyDisabledError"
                },
                {
                  "$ref": "#/components/schemas/RequestSignatureInvalidError"
                },
                {
                  "$ref": "#/components/schemas/RequestNonceNegativeError"
                },
                {
                  "$ref": "#/components/schemas/RequestNonceDatetimeError"
                },
                {
                  "$ref": "#/components/schemas/RequestNonceAlreadyInUseError"
                }
              ],
              "description": "Authorization error schema."
            },
            "minItems": 1,
            "uniqueItems": true
          }
        }
      },
      "UnparseableInputError": {
        "description": "Unparseable input error schema. Indicates the provided request is unparseable.",
        "properties": {
          "code": {
            "type": "string",
            "default": "unparseable_input",
            "description": "Error code.",
            "example": "unparseable_input"
          },
          "message": {
            "type": "string",
            "default": "The provided input is unparseable.",
            "description": "Error message.",
            "example": "The provided input is unparseable."
          }
        }
      }
    },
    "securitySchemes": {
      "BitsoAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "Bitso",
        "description": "Custom bitso authentication mechanism that requires a signed token sent in the `Authorization` header. Use the following format: ``` Authorization: Bitso <token> ```\n"
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
````

# Sibling pages

* [List transactions](https://docs.bitso.com/juno/reference/gettransactions.md)
* [Get transaction details](https://docs.bitso.com/juno/reference/gettransactiondetail.md)
* [Create crypto withdrawal](https://docs.bitso.com/juno/reference/createcryptowithdrawal.md)
* [Initiates an issuance process](https://docs.bitso.com/juno/reference/initiateissuance.md)
* [Initiates a token redemption process](https://docs.bitso.com/juno/reference/initiateredemption.md)