---
title: "Create Quote for Payment Order with optional VOP validation"
method: POST
path: "/customers/{customerId}/batches/{batchId}/quote"
tags: ["Quote Resource"]
---

# Create Quote for Payment Order with optional VOP validation

`POST /customers/{customerId}/batches/{batchId}/quote`

Create a quote with optional VOP (Validation of Payee) validation. Returns different response structures based on validation outcomes: standard quote (no VOP), VOP-only validation results, or combined quote with VOP data.

## Path parameters

- `customerId` string, required
- `batchId` string, required

## Response `201`

Quote created successfully with optional VOP validation

- union
  - FundingQuoteResultData
    - `expirationIntervalInSec` integer
    - `createdOn` string
    - `status` string
    - `lastUpdatedOn` string
    - `quotedItems` CoupledQuoteResultItemData[]
      - `isDirectRate` boolean
      - `rate` number, double
      - `rateInverted` number, double
      - `decimalsDirect` integer
      - `decimalsIndirect` integer
      - `tradeAmount` integer
      - `settlementAmount` integer
      - `tradeCurrency` string
      - `settlementCurrency` string
    - `validationOfBeneficiary` ValidationOfBeneficiaryData[]
      - `paymentId` string, required — Unique payment identifier
      - `name` string, required — Beneficiary name from the payment request
      - `iban` string, required — International Bank Account Number
      - `matchScore` string, required — Match confidence score (0-1 or 0-100 scale)
      - `matchType` 'MTCH' | 'CMTC' | 'NMTC' | 'NOAP' | 'NTVL', required — VOP match type: MTCH (Strong Match), CMTC (Close Match), NMTC (No Match), NOAP (Verification Not Possible), NTVL (Not Validated)
      - `matchDescription` string, required — Human-readable match result description
      - `validationMessage` string, required — Detailed validation message with instructions for the user
      - `disclaimer` string — Risk disclaimer and liability information
      - `suggestedName` string — Suggested beneficiary name (present for CMTC responses)
      - `responseCode` string — VOP service response code
      - `validatorName` string — Name of the validation service provider
  - VOPValidationOnlyResultData — VOP validation-only response without quote data
    - `expirationIntervalInSec` 0, required — Always 0 for VOP-only responses
    - `validationOfBeneficiary` ValidationOfBeneficiaryData[], required — VOP validation results for payments
      - `paymentId` string, required — Unique payment identifier
      - `name` string, required — Beneficiary name from the payment request
      - `iban` string, required — International Bank Account Number
      - `matchScore` string, required — Match confidence score (0-1 or 0-100 scale)
      - `matchType` 'MTCH' | 'CMTC' | 'NMTC' | 'NOAP' | 'NTVL', required — VOP match type: MTCH (Strong Match), CMTC (Close Match), NMTC (No Match), NOAP (Verification Not Possible), NTVL (Not Validated)
      - `matchDescription` string, required — Human-readable match result description
      - `validationMessage` string, required — Detailed validation message with instructions for the user
      - `disclaimer` string — Risk disclaimer and liability information
      - `suggestedName` string — Suggested beneficiary name (present for CMTC responses)
      - `responseCode` string — VOP service response code
      - `validatorName` string — Name of the validation service provider
  - FundingQuoteWithVOPResultData — Complete quote response with VOP validation data
    - `expirationIntervalInSec` integer
    - `createdOn` string
    - `status` string
    - `lastUpdatedOn` string
    - `quotedItems` CoupledQuoteResultItemData[]
      - `isDirectRate` boolean
      - `rate` number, double
      - `rateInverted` number, double
      - `decimalsDirect` integer
      - `decimalsIndirect` integer
      - `tradeAmount` integer
      - `settlementAmount` integer
      - `tradeCurrency` string
      - `settlementCurrency` string
    - `validationOfBeneficiary` ValidationOfBeneficiaryData[], required — VOP validation results for payments in the quote
      - `paymentId` string, required — Unique payment identifier
      - `name` string, required — Beneficiary name from the payment request
      - `iban` string, required — International Bank Account Number
      - `matchScore` string, required — Match confidence score (0-1 or 0-100 scale)
      - `matchType` 'MTCH' | 'CMTC' | 'NMTC' | 'NOAP' | 'NTVL', required — VOP match type: MTCH (Strong Match), CMTC (Close Match), NMTC (No Match), NOAP (Verification Not Possible), NTVL (Not Validated)
      - `matchDescription` string, required — Human-readable match result description
      - `validationMessage` string, required — Detailed validation message with instructions for the user
      - `disclaimer` string — Risk disclaimer and liability information
      - `suggestedName` string — Suggested beneficiary name (present for CMTC responses)
      - `responseCode` string — VOP service response code
      - `validatorName` string — Name of the validation service provider

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error

---

[API](https://skmtc.net/convera/apis/payments-api.md) · [All operations](https://skmtc.net/convera/apis/payments-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/convera/payments-api/revisions/ff82548143cf/schema)