> ## Documentation Index > Fetch the complete documentation index at: https://docs.payluk.ng/llms.txt > Use this file to discover all available pages before exploring further. # Confirm milestone > Buyer approves one milestone; its full amount is released to the seller's main balance. If the milestone was created with a `customerId`, the funds are released to that customer's main balance instead. Requires the escrow to be funded (`OPENED`) and the caller to be the buyer. The escrow completes automatically when the final milestone is released. ## OpenAPI ````yaml openapi.json POST /v1/escrow/milestone/confirm/{escrowId}/{milestoneId} openapi: 3.0.3 info: title: Payluk ThirdParty API version: 1.0.0 description: >- Merchant / Business API for the Payluk escrow and payments platform. All routes are mounted under `/v1` and authenticated with a secret key. Every response uses the standard envelope `{ status, message, data }`. contact: name: Payluk Developer Support email: support@payluk.ng url: https://payluk.ng servers: - url: https://staging.api.payluk.ng description: 'Staging: use sk_test_ keys here for safe testing' - url: https://api.payluk.ng description: 'Production: use sk_live_ keys' security: - bearerAuth: [] tags: - name: Escrow description: Create and manage standard escrow payment links. - name: Milestone Escrow description: Escrows that release funds in parts as milestones are confirmed. - name: Vault Escrow description: >- Merchant-only pooled-stake escrows: customers stake from their wallets and the merchant declares the winner. - name: Categories description: Organise escrows into merchant-defined categories. - name: Merchant Customers description: Manage the buyers and sellers that transact under your merchant account. - name: Disputes description: Confirm deliveries, raise disputes and resolve them. - name: Payments description: Fund wallets and escrows, verify references and manage payout details. - name: Debit Cards description: List and remove customers' saved debit cards. - name: Crypto Whitelist description: Manage whitelisted crypto withdrawal addresses. - name: Misc description: Supporting reference data. paths: /v1/escrow/milestone/confirm/{escrowId}/{milestoneId}: post: tags: - Milestone Escrow summary: Confirm milestone description: >- Buyer approves one milestone; its full amount is released to the seller's main balance. If the milestone was created with a `customerId`, the funds are released to that customer's main balance instead. Requires the escrow to be funded (`OPENED`) and the caller to be the buyer. The escrow completes automatically when the final milestone is released. operationId: confirmMilestone parameters: - $ref: '#/components/parameters/CustomerIdHeader' - $ref: '#/components/parameters/EscrowId' - $ref: '#/components/parameters/MilestoneId' responses: '200': description: >- Milestone confirmed. When the final milestone is released the escrow moves to `CLOSED` / `COMPLETED`. content: application/json: schema: $ref: '#/components/schemas/EscrowResponse' examples: stillOpen: summary: Milestone released, escrow still open value: status: 200 message: Milestone confirmed successfully data: id: 665f1b2c9a1e4d0012ab3c10 paymentToken: PY_8AB12C9D3045 state: OPENED status: ONGOING settlementType: MILESTONE milestones: - id: 665f1b2c9a1e4d0012ab3c21 title: Design amount: 300000 status: RELEASED releasedAt: '1750584900' - id: 665f1b2c9a1e4d0012ab3c22 title: Development amount: 500000 status: PENDING releasedAt: null - id: 665f1b2c9a1e4d0012ab3c23 title: Deployment amount: 200000 status: PENDING releasedAt: null completed: summary: Final milestone, escrow completed value: status: 200 message: Milestone confirmed successfully data: id: 665f1b2c9a1e4d0012ab3c10 paymentToken: PY_8AB12C9D3045 state: CLOSED status: COMPLETED completedAt: '1750585200' settlementType: MILESTONE milestones: - id: 665f1b2c9a1e4d0012ab3c21 title: Design amount: 300000 status: RELEASED releasedAt: '1750584900' - id: 665f1b2c9a1e4d0012ab3c22 title: Development amount: 500000 status: RELEASED releasedAt: '1750585000' - id: 665f1b2c9a1e4d0012ab3c23 title: Deployment amount: 200000 status: RELEASED releasedAt: '1750585200' '400': description: >- Bad request: header missing, escrow not funded, milestone already released, or not found. content: application/json: schema: $ref: '#/components/schemas/ApiError' examples: header: summary: Missing header value: status: 400 message: customer-id header is required data: {} notFunded: summary: Not funded value: status: 400 message: Escrow has not been funded yet data: {} released: summary: Already released value: status: 400 message: Milestone has already been released data: {} notFound: summary: Milestone not found value: status: 400 message: Milestone not found data: {} '401': $ref: '#/components/responses/AccessDenied' components: parameters: CustomerIdHeader: name: customer-id in: header required: true description: The merchant customer this request acts on behalf of. schema: type: string example: 665f1b2c9a1e4d0012ab3c01 EscrowId: name: escrowId in: path required: true description: The escrow's unique identifier. schema: type: string example: 665f1b2c9a1e4d0012ab3c10 MilestoneId: name: milestoneId in: path required: true description: The milestone's unique identifier. schema: type: string example: 665f1b2c9a1e4d0012ab3c20 schemas: EscrowResponse: type: object properties: status: type: integer example: 200 message: type: string example: Operation successful data: $ref: '#/components/schemas/Escrow' ApiError: type: object description: Standard error envelope. properties: status: type: integer example: 400 message: type: string example: Action not allowed data: type: object example: {} Escrow: type: object properties: id: type: string example: 665f1b2c9a1e4d0012ab3c10 amount: type: integer example: 150000 purpose: type: string example: MacBook Pro 14" description: type: string example: Space grey, sealed whoPays: type: string enum: - buyer - seller - both example: both imageUrl: type: array items: type: string example: - https://cdn.payluk.ng/escrow/abc.png fee: type: integer example: 3750 paymentToken: type: string example: PY_8AB12C9D3045 paidAt: type: string nullable: true example: null status: $ref: '#/components/schemas/EscrowStatus' state: $ref: '#/components/schemas/EscrowState' channel: type: string example: API isSeller: type: boolean example: true dispute: type: array nullable: true items: type: object example: null category: type: object nullable: true example: null completedAt: type: string nullable: true example: null maxDelivery: type: integer example: 3 deliveryTimeline: type: string example: days totalQuantity: type: integer example: 1 settlementType: $ref: '#/components/schemas/SettlementType' milestones: type: array items: $ref: '#/components/schemas/Milestone' participants: type: array nullable: true description: 'VAULT escrows only: the customers staking into the pot.' items: $ref: '#/components/schemas/VaultParticipant' winnerId: type: string nullable: true description: >- VAULT escrows only: the participant declared the winner by the merchant. example: null createdAt: type: string example: '2026-06-22T10:15:00.000Z' updatedAt: type: string example: '2026-06-22T10:15:00.000Z' EscrowStatus: type: string description: High-level escrow status. enum: - PENDING - ONGOING - COMPLETED - REFUNDED - CLAIMED - DISPUTED - INVESTIGATING EscrowState: type: string description: Lifecycle state of the escrow. enum: - AWAITING_PAYMENT - OPENED - CLOSED SettlementType: type: string enum: - STANDARD - MILESTONE - VAULT Milestone: type: object properties: id: type: string example: 665f1b2c9a1e4d0012ab3c21 title: type: string example: Design description: type: string example: Figma mockups amount: type: integer example: 300000 dueDate: type: string nullable: true example: '2026-07-15' customerId: type: string nullable: true description: >- Optional beneficiary. When set, releasing this milestone credits this customer's main balance instead of the seller's. example: null status: type: string enum: - PENDING - RELEASED example: PENDING releasedAt: type: string nullable: true example: null VaultParticipant: type: object properties: customerId: type: string example: 665f1b2c9a1e4d0012ab3c40 amount: type: integer example: 600000 status: type: string enum: - STAKED - RELEASED - REFUNDED example: STAKED stakedAt: type: string description: Unix timestamp (seconds) the stake was locked. example: '1784900000' settledAt: type: string nullable: true description: Unix timestamp (seconds) the stake was released or refunded. example: null responses: AccessDenied: description: Access denied. content: application/json: schema: $ref: '#/components/schemas/ApiError' example: status: 401 message: Access denied data: {} securitySchemes: bearerAuth: type: http scheme: bearer description: >- Your secret key as a Bearer token. The key prefix selects the environment: `sk_test_...` (test) or `sk_live_...` (live). ````