---
title: "Payment Gateway Validation Job Completed"
method: POST
path: "webhooks_paymentGatewayValidationJobCompleted"
---

# Payment Gateway Validation Job Completed

`POST webhooks_paymentGatewayValidationJobCompleted` (webhook)

A payment gateway validation job has completed processing

## Payload

- WebhooksPaymentGatewayValidationJobCompletedWebhook
  - `eventType` string, required: The type of the event.
  - `jobId` string, required: The ID of the payment gateway validation job that completed.
  - `data` union, required
    - object
      - `jobStatus` 'pending', required: Discriminator value: pending
      - `jobId` string, required: The job ID of the payment gateway validation job
      - `createdAt` string, date-time, required: The timestamp when the job was created
      - `updatedAt` string, date-time, required: The timestamp when the job was last updated
    - object
      - `jobStatus` 'success', required: Discriminator value: success
      - `jobId` string, required: The job ID of the payment gateway validation job
      - `paymentGatewayUrl` string: The payment gateway URL that was found in the document
      - `card` PaymentGatewayTypesValidatePaymentGatewayCardResponse
        - `eligibility` 'ACCEPTED' | 'NOT_ACCEPTED' | 'UNKNOWN', required
        - `fee` union, required
          - object
            - `type` 'percentage', required: Discriminator value: percentage
            - `value` number, double, required: The fee percentage in bps. For example, if the fee is 2.5% and the payment amount is $100, set this to 250.
          - object
            - `type` 'flat', required: Discriminator value: flat
            - `value` number, double, required: The fee amount in major units of the invoice currency. For example, if the fee is a flat $2.50, set this to 2.5.
          - object
            - `type` 'none', required: Discriminator value: none
      - `invoiceAmount` number, double: The invoice amount detected from the invoice
      - `gatewayAmount` number, double: The amount displayed on the payment gateway (may include fees)
      - `vendorName` string: The vendor name
      - `requiredData` PaymentGatewayTypesValidatePaymentGatewayRequiredData
        - `needsAccountNumber` boolean: Whether the payment gateway requires an account number to proceed
        - `needsPostalCode` boolean: Whether the payment gateway requires a postal code to proceed
        - `needsEmail` boolean: Whether the payment gateway requires an email address to proceed
        - `needsAccountHolderFirstName` boolean: Whether the payment gateway requires the account holder's first name to proceed
        - `needsAccountHolderLastName` boolean: Whether the payment gateway requires the account holder's last name to proceed
        - `needsFullServiceAddress` boolean: Whether the payment gateway requires a full service address to proceed
        - `needsPhoneNumber` boolean: Whether the payment gateway requires a phone number to proceed
      - `createdAt` string, date-time, required: The timestamp when the job was created
      - `updatedAt` string, date-time, required: The timestamp when the job was last updated
    - object
      - `jobStatus` 'failed', required: Discriminator value: failed
      - `jobId` string, required: The job ID of the payment gateway validation job
      - `errorType` 'NO_VALID_PAYMENT_GATEWAY_FOUND' | 'PAYMENT_GATEWAY_UNSUPPORTED' | 'CARD_DETAILS_INVALID' | 'CARD_DECLINED' | 'INVOICE_AMOUNT_MISMATCH', required
      - `errorMessage` string: The error message that occurred during the payment gateway validation job
      - `createdAt` string, date-time, required: The timestamp when the job was created
      - `updatedAt` string, date-time, required: The timestamp when the job was last updated

## Acknowledgement `200`

Webhook received successfully

---

[API](https://skmtc.dev/mercoa/apis/mercoa-2.md) - [All operations](https://skmtc.dev/mercoa/apis/mercoa-2/llms.txt) - [OpenAPI document](https://skmtc.dev/mercoa/apis/mercoa-2/revisions/00a8e403ae18?raw)