Create Transaction

The operation to create an escrow transaction

POSThttps://api.sandbox.centiiv.com/api/v1/escrow/transactions/create

Body

application/json

customerName*string

The name of the customer

Example: "Damien Darhk"

customerEmail*string

The email of the customer

Example: "[email protected]"

itemsarray of ProductDto (object)

Array of products for the transaction

tax*number

The tax percentage for the transaction

Example: 10

coupon*all of

The coupon codes available

additionalNotesstring

Additional notes for the transaction

Example: "Additional notes for the transaction"

Response

201404

The escrow transaction has been created.

Body

application/json

any

Request

JavaScriptCurlPython

const response = await fetch('https://api.sandbox.centiiv.com/api/v1/escrow/transactions/create', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "customerName": "Damien Darhk",
      "customerEmail": "[email protected]",
      "tax": 10,
      "coupon": {
        "code": "EID2024",
        "discount": 0.04
      }
    }),
});
const data = await response.json();

Response

201404

{
  "success": false,
  "message": "The escrow transaction has been created.",
  "statusCode": 201,
  "code": "ESCROW_TRANSACTION_CREATED",
  "data": {
    "id": "EST-4e9c10",
    "link": "http://localhost:3000/escrow/checkout?type=escrow&t_id=4e9c10"
  }
}