---
updatedAt: 2026-07-09T16:24:00.000Z
agentTools:
  projectIndex: https://c-vmch.readme.io/llms.txt
---

# Create Escrow Transaction

Initialize a new escrow transaction between parties.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "paths": {
    "/api/v1/escrow": {
      "post": {
        "operationId": "EscrowController_create",
        "summary": "Create Escrow Transaction",
        "description": "Initialize a new escrow transaction between parties.",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateEscrowTransactionDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "The escrow transaction has been created.",
            "content": {
              "application/json": {
                "schema": {
                  "example": {
                    "success": true,
                    "message": "The escrow transaction has been created.",
                    "code": "ESCROW_TRANSACTION_CREATED",
                    "data": {
                      "id": "d31059",
                      "link": "https://centiiv.com/pay?id=d31059&type=escrow"
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Escrow Transactions"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    }
  },
  "info": {
    "title": "Centiiv Public API",
    "description": "The OpenAPI specifications for the API.",
    "version": "1.0",
    "contact": {}
  },
  "servers": [
    {
      "url": "https://api.centiiv.com",
      "description": "Production"
    },
    {
      "url": "http://localhost:3002",
      "description": "Local"
    }
  ],
  "components": {
    "securitySchemes": {
      "bearer": {
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "type": "http"
      }
    },
    "schemas": {
      "ItemDto": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "example": "MacBook 2016"
          },
          "qty": {
            "type": "number",
            "example": 2
          },
          "price": {
            "type": "number",
            "example": 300
          }
        },
        "required": [
          "name",
          "qty",
          "price"
        ]
      },
      "CreateEscrowTransactionDto": {
        "type": "object",
        "properties": {
          "customerName": {
            "type": "string",
            "example": "Damien Darhk",
            "description": "The name of the customer"
          },
          "customerEmail": {
            "type": "string",
            "example": "customer@example.com",
            "description": "The email of the customer",
            "default": "customer@example.com"
          },
          "currency": {
            "type": "string",
            "example": "NGN",
            "enum": [
              "NGN",
              "USD",
              "GBP",
              "EUR"
            ]
          },
          "items": {
            "description": "Array of products for the transaction",
            "example": [
              {
                "name": "Oraimo 72000mAh Powerbank",
                "price": 72000,
                "qty": 1
              }
            ],
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ItemDto"
            }
          },
          "additionalNotes": {
            "type": "string",
            "example": "Additional notes for the transaction",
            "description": "Additional notes for the transaction",
            "default": "Additional notes for the transaction"
          },
          "allowedPaymentMethods": {
            "type": "string",
            "example": [
              "NGN",
              "USDT",
              "USDC"
            ],
            "description": "The payment methods that are allowed for the payment link",
            "enum": [
              "NGN",
              "USDC",
              "USDT",
              "XLM",
              "APT",
              "USD",
              "GBP",
              "EUR"
            ]
          }
        },
        "required": [
          "customerName",
          "customerEmail",
          "items"
        ]
      }
    }
  }
}
```