Mercoa payment-gateway > process API
The payment-gateway > process API from Mercoa — 2 operation(s) for payment-gateway > process.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/mercoa:mercoa-payment-gateway-process-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Reference payment-gateway > process API
version: 1.0.0
servers:
- url: https://api.mercoa.com
description: Production
tags:
- name: payment-gateway > process
paths:
/payment-gateway/process-jobs:
get:
operationId: paymentGateway_process_find
summary: Find Process Jobs
description: Search payment gateway process jobs
tags:
- payment-gateway > process
parameters:
- name: status
in: query
description: Filter jobs by status
required: false
schema:
$ref: '#/components/schemas/paymentGatewayTypes_PaymentGatewayJobStatus'
- name: startDate
in: query
description: Start date filter for job creation time
required: false
schema:
type: string
format: date-time
- name: endDate
in: query
description: End date filter for job creation time
required: false
schema:
type: string
format: date-time
- name: orderBy
in: query
description: Field to order jobs by. Defaults to CREATED_AT.
required: false
schema:
$ref: '#/components/schemas/paymentGatewayTypes_PaymentGatewayJobOrderByField'
- name: orderDirection
in: query
description: Direction to order jobs by. Defaults to desc.
required: false
schema:
$ref: '#/components/schemas/commons_OrderDirection'
- name: limit
in: query
description: Number of jobs to return. Limit can range between 1 and 100, and the default is 10.
required: false
schema:
type: integer
- name: startingAfter
in: query
description: The ID of the job to start after. If not provided, the first page of jobs will be returned.
required: false
schema:
type: string
responses:
'200':
description: Response with status 200
content:
application/json:
schema:
$ref: '#/components/schemas/paymentGatewayTypes_SearchPaymentGatewayProcessJobsResponse'
'400':
description: Error response with status 400
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- BadRequest
content:
type: string
required:
- errorName
- content
'401':
description: Error response with status 401
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Unauthorized
content:
type: string
required:
- errorName
- content
'403':
description: Error response with status 403
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Forbidden
content:
type: string
required:
- errorName
- content
'404':
description: Error response with status 404
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- NotFound
content:
type: string
required:
- errorName
- content
'409':
description: Error response with status 409
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Conflict
content:
type: string
required:
- errorName
- content
'500':
description: Error response with status 500
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- InternalServerError
content:
type: string
required:
- errorName
- content
'501':
description: Error response with status 501
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Unimplemented
content:
type: string
required:
- errorName
- content
security:
- default: []
/payment-gateway/process/{jobId}:
get:
operationId: paymentGateway_process_get
summary: Get Process Job
description: Get the status of a payment gateway processing job
tags:
- payment-gateway > process
parameters:
- name: jobId
in: path
description: The ID of the payment gateway processing job
required: true
schema:
type: string
responses:
'200':
description: Response with status 200
content:
application/json:
schema:
$ref: '#/components/schemas/paymentGatewayTypes_ProcessPaymentGatewayResponse'
'400':
description: Error response with status 400
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- BadRequest
content:
type: string
required:
- errorName
- content
'401':
description: Error response with status 401
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Unauthorized
content:
type: string
required:
- errorName
- content
'403':
description: Error response with status 403
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Forbidden
content:
type: string
required:
- errorName
- content
'404':
description: Error response with status 404
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- NotFound
content:
type: string
required:
- errorName
- content
'409':
description: Error response with status 409
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Conflict
content:
type: string
required:
- errorName
- content
'500':
description: Error response with status 500
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- InternalServerError
content:
type: string
required:
- errorName
- content
'501':
description: Error response with status 501
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Unimplemented
content:
type: string
required:
- errorName
- content
security:
- default: []
components:
schemas:
paymentGatewayTypes_PaymentGatewayJobStatus:
type: string
enum:
- PENDING
- COMPLETED
- FAILED
title: PaymentGatewayJobStatus
commons_OrderDirection:
type: string
enum:
- ASC
- DESC
title: OrderDirection
paymentGatewayTypes_PaymentGatewayJobOrderByField:
type: string
enum:
- CREATED_AT
- UPDATED_AT
- STATUS
title: PaymentGatewayJobOrderByField
paymentGatewayTypes_ProcessPaymentGatewayResponse:
oneOf:
- type: object
properties:
jobStatus:
type: string
enum:
- pending
description: 'Discriminator value: pending'
jobId:
type: string
description: The job ID of the payment gateway processing job
createdAt:
type: string
format: date-time
description: The timestamp when the job was created
updatedAt:
type: string
format: date-time
description: The timestamp when the job was last updated
required:
- jobStatus
- jobId
- createdAt
- updatedAt
- type: object
properties:
jobStatus:
type: string
enum:
- success
description: 'Discriminator value: success'
jobId:
type: string
description: The job ID of the payment gateway processing job
receiptUrl:
type: string
description: The URL of the receipt that was downloaded from the payment gateway
invoiceAmount:
type: number
format: double
description: The invoice amount detected from the payment gateway
gatewayAmount:
type: number
format: double
description: The amount displayed on the payment gateway (may include fees)
vendorName:
type: string
description: The vendor name detected from the payment gateway
requiredData:
$ref: '#/components/schemas/paymentGatewayTypes_ValidatePaymentGatewayRequiredData'
description: Information about what data is required to proceed with payment
attempts:
type: array
items:
$ref: '#/components/schemas/paymentGatewayTypes_PaymentGatewayAttempt'
description: List of payment gateway attempts for this job
createdAt:
type: string
format: date-time
description: The timestamp when the job was created
updatedAt:
type: string
format: date-time
description: The timestamp when the job was last updated
required:
- jobStatus
- jobId
- attempts
- createdAt
- updatedAt
- type: object
properties:
jobStatus:
type: string
enum:
- failed
description: 'Discriminator value: failed'
jobId:
type: string
description: The job ID of the payment gateway processing job
errorType:
$ref: '#/components/schemas/paymentGatewayTypes_PaymentGatewayError'
description: The error that occurred during the payment gateway processing job
errorMessage:
type: string
description: The error message that occurred during the payment gateway processing job
createdAt:
type: string
format: date-time
description: The timestamp when the job was created
updatedAt:
type: string
format: date-time
description: The timestamp when the job was last updated
required:
- jobStatus
- jobId
- errorType
- createdAt
- updatedAt
discriminator:
propertyName: jobStatus
title: ProcessPaymentGatewayResponse
paymentGatewayTypes_PaymentGatewayAttempt:
type: object
properties:
id:
type: string
description: The unique identifier for the payment gateway attempt
status:
$ref: '#/components/schemas/paymentGatewayTypes_PaymentGatewayJobStatus'
description: The status of the attempt
amount:
type: number
format: double
description: The amount processed in this attempt
receiptUrl:
type: string
description: The URL of the receipt for this attempt
createdAt:
type: string
format: date-time
description: The timestamp when the attempt was created
required:
- id
- status
- createdAt
title: PaymentGatewayAttempt
paymentGatewayTypes_SearchPaymentGatewayProcessJobsResponse:
type: object
properties:
jobs:
type: array
items:
$ref: '#/components/schemas/paymentGatewayTypes_ProcessPaymentGatewayResponse'
description: List of payment gateway process jobs matching the search criteria
hasMore:
type: boolean
description: Whether there are more jobs available beyond the current page
required:
- jobs
- hasMore
title: SearchPaymentGatewayProcessJobsResponse
paymentGatewayTypes_PaymentGatewayError:
type: string
enum:
- NO_VALID_PAYMENT_GATEWAY_FOUND
- PAYMENT_GATEWAY_UNSUPPORTED
- CARD_DETAILS_INVALID
- CARD_DECLINED
- INVOICE_AMOUNT_MISMATCH
title: PaymentGatewayError
paymentGatewayTypes_ValidatePaymentGatewayRequiredData:
type: object
properties:
needsAccountNumber:
type: boolean
description: Whether the payment gateway requires an account number to proceed
needsPostalCode:
type: boolean
description: Whether the payment gateway requires a postal code to proceed
needsEmail:
type: boolean
description: Whether the payment gateway requires an email address to proceed
needsAccountHolderFirstName:
type: boolean
description: Whether the payment gateway requires the account holder's first name to proceed
needsAccountHolderLastName:
type: boolean
description: Whether the payment gateway requires the account holder's last name to proceed
needsFullServiceAddress:
type: boolean
description: Whether the payment gateway requires a full service address to proceed
needsPhoneNumber:
type: boolean
description: Whether the payment gateway requires a phone number to proceed
title: ValidatePaymentGatewayRequiredData
securitySchemes:
default:
type: http
scheme: bearer