Get Merchant List
POST /v4/merchants/reports
Environment and operation
Use this endpoint contract with the account and environment assigned to your integration. Values in angle brackets are placeholders. This reference does not execute requests. Documented server https://sandbox.nmi.com/api Schema reference: field definitions do not include every behavioral rule. Follow the workflow guidance and account prerequisites for this operation before submitting requests.
Request route
<details> <summary>Usage</summary> This is a query to get all merchant accounts under your partner account. </details> POST /v4/merchants/reports Security scheme Type Credential location Scopes None declared Verify account setup Not inferred Not inferred
Request language templates
Original transport templates derived from this endpoint’s documented method, server, authentication and media type. Replace path/query/credential placeholders with authorized sandbox values. These examples print the raw status and response; they do not infer business success or retry a request. Save one valid request variant from the fields/examples below as request.json. Do not combine mutually exclusive variants. The payload is deliberately not fabricated from schema defaults. Node requires a runtime with fetch; PHP requires cURL. Generated source-based examples have not been executed against provider accounts. curl --request POST \ --url 'https://sandbox.nmi.com/api/v4/merchants/reports' \ --header 'Content-Type: application/json' \ --header 'Authorization: <Authorization>' \ --data-binary '@request.json' import { readFile } from 'node:fs/promises'; const body = await readFile('request.json', 'utf8'); const response = await fetch("https://sandbox.nmi.com/api/v4/merchants/reports", { method: 'POST', headers: { "Content-Type": "application/json", "Authorization": "<Authorization>" }, body }); console.log(response.status, await response.text()); from urllib.request import Request, urlopen from urllib.error import HTTPError from pathlib import Path request = Request('https://sandbox.nmi.com/api/v4/merchants/reports', method='POST', headers={'Content-Type': 'application/json', 'Authorization': '<Authorization>'}, data=Path('request.json').read_bytes()) try: with urlopen(request, timeout=30) as response: print(response.status, response.read().decode()) except HTTPError as error: print(error.code, error.read().decode()) require 'net/http' require 'uri' uri = URI("https://sandbox.nmi.com/api/v4/merchants/reports") request = Net::HTTP::Post.new(uri) request["Content-Type"] = "application/json" request["Authorization"] = "<Authorization>" request.body = File.binread('request.json') response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https', read_timeout: 30) { |http| http.request(request) } puts response.code puts response.body <?php $curl = curl_init('https://sandbox.nmi.com/api/v4/merchants/reports'); curl_setopt_array($curl, [ CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, CURLOPT_HTTPHEADER => ['Content-Type: application/json', 'Authorization: <Authorization>'], CURLOPT_POSTFIELDS => file_get_contents('request.json') ]); $response = curl_exec($curl); if ($response === false) { throw new RuntimeException(curl_error($curl)); } echo curl_getinfo($curl, CURLINFO_HTTP_CODE), PHP_EOL, $response; curl_close($curl);
Path and query parameters
Required flags apply to the parameter itself. Additional limits and enum values appear in the contract below. Parameter Location Required Type Description Content-Type header true string The Content-Type representation header is used to indicate the original media type of the resource (prior to any content encoding applied for sending). Authorization header true string Your v4 API key that was generated in the Partner portal. [ { "name": "Content-Type", "in": "header", "required": true, "schema": { "type": "string" }, "description": "The Content-Type representation header is used to indicate the original media type of the resource (prior to any content encoding applied for sending).", "example": "application/json" }, { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string" }, "description": "Your v4 API key that was generated in the Partner portal." } ] true
Request body
Use the declared media type: application/json. Required flags below apply within the selected object or variant. Read the workflow notes before choosing a variant. Field Type Required Description Constraints [allOf 1].maxResults string yes Required. Value must be between 1-1000. [allOf 1].ids array no An array of merchant ids. [allOf 1].parentAffiliateId string no "parentAffiliateId": "1" // An affiliate id. Only merchants under this affiliate will be returned, rather than the full tree. [allOf 1].type string no "type": "gateway" // Only available options are gateway, test, splitFunding, mobile. [allOf 1].search string no "search": "Asdf" Performs a search on this text as a case-insensitive search on any of the following: email, company name, first and last name, phone number, external id, or username [allOf 1].offset string no "offset": 0 // Like all reports and search endpoints, you can specify the offset, which is the start point for the responses { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetMerchantListRequest" }, "examples": { "Create Standard Merchant": { "$ref": "#/components/examples/GetMerchantListExampleRequest" } } } } } true
Responses
Match the HTTP status to its response schema below. For financial operations, also inspect the payment outcome before updating your order or retrying. HTTP status Media type Meaning 200 application/json Success { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetMerchantListResponse" }, "examples": { "Create Standard Merchant": { "$ref": "#/components/examples/GetMerchantListExampleResponse" } } } } } } true
Response fields · 200 · application/json
Field Type Required Description Constraints objectType string no The type of object that was returned as a result of the request. enum: ["serviceConfig"] reportId number no The ID of the report. offset number no The first N skipped results. maxResults number no The max number results. totalResults number no The total number of results. hasMore boolean no If are there more results for the search. links array no Links for querying results. links[].first string no First page of query results. links[].last string no Last page of query results. links[].next string no Next page of current query results. links[].previous string no Previous page of current query results. results array no Results for the search. results[].objectType string no Type of the returned response object results[].id string no The ID for the transaction. results[].created string no The timestamp indicating when the transaction was created. format: "date-time" results[].updated string no The timestamp indicating when the transaction was last updated. format: "date-time" results[].firstName string no The first name of the merchant's company contact results[].lastName string no The last name of the merchant's company contact results[].company string no The merchant's company name. results[].email string no The email of the merchant's company contact results[].phone string no The phone number of the merchant's company contact results[].fax string no The fax number of the merchant's company contact results[].address1 string no The first line of the merchant's address results[].address2 string no The second line of the merchant's address results[].city string no The city associated with the merchant's address results[].state string no The state associated with the merchant's address results[].zip string no The postal code associated with the merchant's address results[].country string no The country associated with the merchant's address results[].timezone string no The merchant's timezone results[].costPlan string no The cost plan assigned to the merchant. results[].status string no The status of the merchant. results[].externalIdentifier string no A description to further describe or identify the merchant. results[].lastTransactionDate string no The date of the last transaction on the merchant. results[].parentAffiliateId string no The ID of the affiliate directly above the merchant. results[].accountInfo object no Banking information for merchant billing. results[].accountInfo.checkAba string no The routing/ABA number used to bill the merchant. results[].accountInfo.checkAccount string no The account number used to bill the merchant. results[].accountInfo.accountType string no The type of bank account being used. results[].accountInfo.accountHolderType string no The type of holder for the bank account being used. results[].features object no A collection of various merchant feature flags. results[].features.forceTos boolean no Whether or not the merchant is forced to accept the Terms of Service. results[].features.forceBillingAuth boolean no Whether or not the merchant is forced to accept the Billing Auth. results[].features.allowBlindCredits boolean no Whether or not the merchant is allowed to issue blind credits for Credit Cards. results[].features.allowBlindCheckCredits boolean no Whether or not the merchant is allowed to issue blind credits for Checks. results[].features.advancedTransactionRouting boolean no Whether or not the merchant has advanced transaction routing enabled. results[].features.sendBillingEmail boolean no Whether or not the merchant receives an email for their billing. results[].features.braspag object no Feature flags specifically related to the braspag processor. results[].features.braspag.advancedTransactionRouting boolean no Whether or not the braspag processor has advanced transaction routing enabled. results[].features.verifi object no Feature flags specifically related to the verifi service. results[].features.verifi.enabled boolean no Whether or not the verifi service is enabled for the merchant. results[].features.viewBillingStatement boolean no Whether or not the merchant can view their billing statement. results[].features.litle object no Feature flags specifically related to the litle processor. results[].features.litle.reportGroup string no The merchant's litle report group. Returns false if not configured. results[].features.litle.prePaidIndicator string no The merchant's litle prepaid indicator. Returns false if not configured. results[].features.litle.affluentIndicator string no The merchant's litle affluent indicator. Returns false if not configured. results[].features.litle.recycleAdvice string no The merchant's litle recycle advice. Returns false if not configured. results[].features.litle.campaign string no The merchant's litle campaign. Returns false if not configured. results[].features.litle.affiliate string no The merchant's litle affiliate. Returns false if not configured. results[].features.litle.merchantGroupId string no The merchant's litle group ID. Returns false if not configured. results[].features.allowEmptyCcExp boolean no Whether or not the merchant is allowed to pass empty Credit Card Expiration Dates. results[].features.pastDue boolean no Whether or not the merchant's bill is past due. results[].features.apiReceipt boolean no Whether or not the merchant's API transactions send receipts. results[].features.batchReceipt boolean no Whether or not the merchant can batch receipts. results[].features.delinquent boolean no Whether or not the merchant is in a delinquent state. results[].features.commercialCardIndicator string no The merchant's commercial card indicator. Returns false if not configured. results[].features.customDescription string no The merchant's custom description. Returns false if not configured. results[].features.apiAllowOnlyUsername boolean no Whether or not the merchant can authenticate with the APIs using only a username. results[].features.orderIdDuplicateCheck boolean no Whether or not the merchant has duplicate checking for the Order ID field. results[].features.cardLevelResult string no The merchant's card level result. Returns false if not configured. results[].features.pmsalem object no Feature flags specifically related to the pmsalem processor. results[].features.pmsalem.ignoreAmexCvv boolean no Whether or not the merchant's pmsalem processor ignores the Amex CVV field. results[].features.pmsalem.allowNovusVerify boolean no Whether or not the merchant's pmsalem processor can verify Novus cards schemes. results[].features.pmsalem.idInMdf11 boolean no Whether or not the merchant's pmsalem processor can pass the ID in MDF11. results[].features.credorax object no Feature flags specifically related to the credorax processor. results[].features.credorax.bankNet string no The merchant's bank net value for credorax. Returns false if not configured. results[].features.credorax.z5Risk string no The merchant's z5 risk value for credorax. Returns false if not configured. results[].features.vantiv object no Feature flags specifically related to the vantiv processor. results[].features.vantiv.remainingBalance string no The merchant's remaining balance for vantiv. Returns false if not configured. results[].features.prosa object no Feature flags specifically related to the prosa processor. results[].features.prosa.deferredPayment boolean no Whether or not the merchant has deferred payments enabled for the prosa processor. results[].features.cronopay object no Feature flags specifically related to the cronopay processor. results[].features.cronopay.customerId string no The merchant's cronopay customer ID. Returns false if not configured. results[].features.captureHigher boolean no Whether or not the merchant is allowed to capture higher than the preceding auth. results[].features.moneris object no Feature flags related specifically to the moneris processor. results[].features.moneris.orderId string no The merchant's order ID for moneris transactions. Returns false if not configured. results[].features.extendedFileBatchResponse boolean no Whether or not the merchant receives and extended file batch response. results[].features.credov3 object no Feature flags related specifically to the credov3 processor. results[].features.credov3.ignoreAmexCvv boolean no Whether or not the merchant's credov3 processor ignores the Amex CVV field. results[].features.enforceRequiredFieldsForSwiped boolean no Whether or not the merchant must continue to pass required fields when using Swipe. results[].features.preventDuplicateCvRecords boolean no Whether or not the merchant is prevented from making duplicate Customer Vault records. results[].features.preventConfiguringSurcharge boolean no Whether or not the merchant is prevented from configuring settings for surcharge. results[].features.tsys object no Feature flags related specifically to the tsys processor. results[].features.tsys.paymentFacilitatorFields string no The merchant's tsys payment facilitator fields. Returns false if not configured. results[].features.tsys.allowCustomReport boolean no Whether or not the merchant is allowed to do a custom report with tsys. results[].features.tsys.alternativePostData boolean no Whether or not the merchant is allowed to add alternative post data with tsys. results[].features.requireProcessorFieldOnVt string no Require a processor be specified on all transactions in the Virtual Terminal. results[].features.isCardTesting string no Is merchant's card testing. results[].features.allowTipOnVtKeyedTransactions string no Allow merchant to enter tips in the virtual terminal on keyed transactions. results[].features.transitForceAcceptance string no Merchant is approved for Force Acceptance. results[].features.level3 object no Merchant's level III template data. results[].features.level3.autoLoadTemplate boolean no Automatically add my Level III template data to the merchant's credit card transactions. results[].features.emvPartialApprovals string no Allow Merchant to accept Partial Approvals for EMV transactions. results[].features.supportsGooglePay string no Merchant supports Google Pay. results[].features.supportsApplePay string no Merchant supports Apple Pay. results[].features.isApplePayEnabled string no Is Apple Pay enabled. results[].features.useDeviceRecognition string no Enable device recognition for all merchant users when logging into the control panel (users with two-factor enabled are exempt). results[].needsPendingServicesActivated string no Merchant needs pending services activated. results[].payFacBillingPeriod string no Payment Facilitator Billing Period. results[].rejectedCertificates string no Number of rejected certificates.
Referenced schema definitions
References beginning with #/components resolve to these definitions. These are field contracts, not example payment values. Use the applicable variant, required fields and constraints. { "examples": { "GetMerchantListExampleRequest": { "summary": "Get Merchant List", "description": "Get list of merchants", "value": { "maxResults": 1000 } }, "GetMerchantListExampleResponse": { "summary": "Get Merchant List Response", "description": "Gets merchant list", "value": { "objectType": "report", "reportId": 34567345, "offset": null, "maxResults": 100, "totalResults": 43, "hasMore": false, "links": { "first": "https://sandbox.nmi.com/api/v4/merchants/reports/34567345?maxResults=100", "last": "https://sandbox.nmi.com/api/v4/merchants/reports/34567345?offset=0&maxResults=100", "next": "https://sandbox.nmi.com/api/v4/merchants/reports/34567345?offset=100&maxResults=100", "previous": "https://sandbox.nmi.com/api/v4/merchants/reports/34567345?offset=0&maxResults=100" }, "results": [ { "objectType": "merchant", "id": "3465345", "type": "gateway", "created": "2011-02-04T12:17:17+00:00", "updated": "2012-04-23T15:36:59+00:00", "firstName": "John", "lastName": "Doe", "company": "ACME, Inc.", "email": "someone@example.com", "phone": "555-555-5555", "fax": "", "url": "https://acme.com", "address1": "123 Main St", "address2": "", "city": "Chicago", "state": "IL", "zip": "60601", "country": "US", "timezone": "America/Chicago", "costPlan": "4", "status": "active", "externalIdentifier": "", "lastTransactionDate": null, "parentAffiliateId": "2", "accountInfo": { "checkAba": "490000018", "checkAccount": "*****6789", "accountType": "checking", "accountHolderType": "personal" }, "features": { "forceTos": false, "forceBillingAuth": false, "allowBlindCredits": false, "allowBlindCheckCredits": false, "advancedTransactionRouting": false, "sendBillingEmail": true, "braspag": { "advancedTransactionRouting": false }, "verifi": { "enabled": false }, "viewBillingStatement": true, "litle": { "reportGroup": false, "prePaidIndicator": false, "affluentIndicator": false, "recycleAdvice": false, "campaign": false, "affiliate": false, "merchantGroupId": false }, "allowEmptyCcExp": false, "pastDue": false, "apiReceipt": false, "batchReceipt": false, "delinquent": false, "commercialCardIndicator": false, "customDescriptor": false, "apiAllowOnlyUsername": false, "orderIdDuplicateCheck": false, "cardLevelResult": false, "pmsalem": { "ignoreAmexCvv": false, "allowNovusVerify": false, "idInMdf11": false }, "credorax": { "bankNet": false, "z5Risk": false }, "vantiv": { "remainingBalance": false }, "prosa": { "deferredPayment": false }, "cronopay": { "customerId": false }, "captureHigher": false, "moneris": { "orderId": false }, "extendedFileBatchResponse": false, "credov3": { "ignoreAmexCvv": false }, "enforceRequiredFieldsForSwiped": false, "preventDuplicateCvRecords": false, "preventConfiguringSurcharge": false, "tsys": { "paymentFacilitatorFields": false, "allowCustomReport": false, "alternativePosData": false }, "requireProcessorFieldOnVt": false, "isCardTesting": false, "allowTipOnVtKeyedTransactions": false, "transitForceAcceptance": false, "level3": { "autoLoadTemplate": false }, "emvPartialApprovals": false, "supportsGooglePay": false, "supportsApplePay": false, "isApplePayEnabled": false, "useDeviceRecognition": false }, "needsPendingServicesActivated": true, "payFacBillingPeriod": "monthly", "rejectedCertificates": "0" } ] } }, "auth-success": { "summary": "Successful Authorization", "description": "This transaction was successfully authorized.", "value": { "event_id": "322ac05a-cf6c-4c16-948a-3048d007f742", "event_type": "transaction.auth.success", "event_body": { "merchant": { "id": "944025", "name": "Test merchant account" }, "features": { "is_test_mode": true }, "transaction_id": "8584341675", "transaction_type": "cc", "condition": "pending", "processor_id": "ccprocessora", "ponumber": "", "order_description": "", "order_id": "", "customerid": "", "customertaxid": "", "website": "", "shipping": "", "currency": "USD", "tax": "", "surcharge": "", "convenience_fee": "", "misc_fee": "", "misc_fee_name": "", "cash_discount": "", "tip": "", "requested_amount": "10.00", "shipping_carrier": "", "tracking_number": "", "shipping_date": "", "partial_payment_id": "", "partial_payment_balance": "", "platform_id": "", "authorization_code": "123456", "social_security_number": "", "drivers_license_number": "", "drivers_license_state": "", "drivers_license_dob": "", "duty_amount": "0.00", "discount_amount": "0.00", "national_tax_amount": "0.00", "summary_commodity_code": "", "alternate_tax_amount": "0.00", "vat_tax_amount": "0.00", "vat_tax_rate": "0.00", "billing_address": { "first_name": "", "last_name": "", "address_1": "", "address_2": "", "company": "", "city": "", "state": "", "postal_code": "", "country": "", "email": "", "phone": "", "cell_phone": "", "fax": "" }, "shipping_address": { "first_name": "", "last_name": "", "address_1": "", "address_2": "", "company": "", "city": "", "state": "", "postal_code": "", "country": "", "email": "", "phone": "", "fax": "" }, "card": { "cc_number": "411111******1111", "cc_exp": "1025", "cavv": "", "cavv_result": "", "xid": "", "eci": "", "avs_response": "", "csc_response": "M", "cardholder_auth": "", "cc_start_date": "", "cc_issue_number": "", "card_balance": "", "card_available_balance": "", "entry_mode": "4", "cc_bin": "", "cc_type": "Visa", "feature_token": "" }, "merchant_defined_fields": {}, "action": { "amount": "10.00", "action_type": "auth", "date": "20230801113700", "success": "1", "ip_address": "123.123.123.123", "source": "api", "api_method": "direct_post", "username": "test", "response_text": "SUCCESS", "response_code": "100", "processor_response_text": "", "tap_to_mobile": false, "processor_response_code": "", "device_license_number": "", "device_nickname": "" } } } }, "auth-failed": { "summary": "Failed Authorization", "description": "The authorization request was declined by the processor.", "value": { "event_id": "322ac05a-cf6c-4c16-948a-3048d007f742", "event_type": "transaction.auth.failure", "event_body": { "merchant": { "id": "944025", "name": "Test merchant account" }, "features": { "is_test_mode": true }, "transaction_id": "8597004002", "transaction_type": "cc", "condition": "failed", "processor_id": "ccprocessora", "ponumber": "", "order_description": "", "order_id": "", "customerid": "", "customertaxid": "", "website": "", "shipping": "", "currency": "USD", "tax": "", "surcharge": "", "convenience_fee": "", "misc_fee": "", "misc_fee_name": "", "cash_discount": "", "tip": "", "requested_amount": "0.50", "shipping_carrier": "", "tracking_number": "", "shipping_date": "", "partial_payment_id": "", "partial_payment_balance": "", "platform_id": "", "authorization_code": "123456", "social_security_number": "", "drivers_license_number": "", "drivers_license_state": "", "drivers_license_dob": "", "duty_amount": "0.00", "discount_amount": "0.00", "national_tax_amount": "0.00", "summary_commodity_code": "", "alternate_tax_amount": "0.00", "vat_tax_amount": "0.00", "vat_tax_rate": "0.00", "billing_address": { "first_name": "", "last_name": "", "address_1": "", "address_2": "", "company": "", "city": "", "state": "", "postal_code": "", "country": "", "email": "", "phone": "", "cell_phone": "", "fax": "" }, "shipping_address": { "first_name": "", "last_name": "", "address_1": "", "address_2": "", "company": "", "city": "", "state": "", "postal_code": "", "country": "", "email": "", "phone": "", "fax": "" }, "card": { "cc_number": "411111******1111", "cc_exp": "1025", "cavv": "", "cavv_result": "", "xid": "", "eci": "", "avs_response": "", "csc_response": "M", "cardholder_auth": "", "cc_start_date": "", "cc_issue_number": "", "card_balance": "", "card_available_balance": "", "entry_mode": "4", "cc_bin": "", "cc_type": "Visa", "feature_token": "" }, "merchant_defined_fields": {}, "action": { "amount": "10.00", "action_type": "auth", "date": "20230801113700", "success": "0", "ip_address": "123.123.123.123", "source": "api", "api_method": "direct_post", "username": "test", "response_text": "DECLINE", "response_code": "200", "processor_response_text": "", "tap_to_mobile": false, "processor_response_code": "", "device_license_number": "", "device_nickname": "" } } } }, "capture-success": { "summary": "Transaction captured successfully", "description": "Transaction captured successfully", "value": { "event_id": "e5267749-c235-45c9-b93e-21f4379b94d1", "event_type": "transaction.capture.success", "event_body": { "merchant": { "id": "944025", "name": "Test merchant account" }, "features": { "is_test_mode": true }, "transaction_id": "8584341675", "transaction_type": "cc", "condition": "pendingsettlement", "processor_id": "ccprocessora", "ponumber": "", "order_description": "", "order_id": "", "customerid": "", "customertaxid": "", "website": "", "shipping": "0.00", "currency": "USD", "tax": "0.00", "surcharge": "", "convenience_fee": "", "misc_fee": "", "misc_fee_name": "", "cash_discount": "", "tip": "", "requested_amount": "10.00", "shipping_carrier": "", "tracking_number": "", "shipping_date": "", "partial_payment_id": "", "partial_payment_balance": "", "platform_id": "", "authorization_code": "123456", "social_security_number": "", "drivers_license_number": "", "drivers_license_state": "", "drivers_license_dob": "", "duty_amount": "0.00", "discount_amount": "0.00", "national_tax_amount": "0.00", "summary_commodity_code": "", "alternate_tax_amount": "0.00", "vat_tax_amount": "0.00", "vat_tax_rate": "0.00", "billing_address": { "first_name": "", "last_name": "", "address_1": "", "address_2": "", "company": "", "city": "", "state": "", "postal_code": "", "country": "", "email": "", "phone": "", "cell_phone": "", "fax": "" }, "shipping_address": { "first_name": "", "last_name": "", "address_1": "", "address_2": "", "company": "", "city": "", "state": "", "postal_code": "", "country": "", "email": "", "phone": "", "fax": "" }, "card": { "cc_number": "411111******1111", "cc_exp": "1025", "cavv": "", "cavv_result": "", "xid": "", "eci": "", "avs_response": "", "csc_response": "M", "cardholder_auth": "", "cc_start_date": "", "cc_issue_number": "", "card_balance": "", "card_available_balance": "", "entry_mode": "4", "cc_bin": "", "cc_type": "Visa", "feature_token": "" }, "merchant_defined_fields": {}, "action": { "amount": "10.00", "action_type": "capture", "date": "20230801113955", "success": "1", "ip_address": "123.123.123.123", "source": "api", "api_method": "direct_post", "username": "test", "response_text": "SUCCESS", "response_code": "100", "processor_response_text": "", "tap_to_mobile": false, "processor_response_code": "", "device_license_number": "", "device_nickname": "" } } } }, "sale-success": { "summary": "Sale transaction was successful", "description": "Sale transaction was successful", "value": { "event_id": "2aa1bb86-c790-4231-a46e-7cc544a8dc5c", "event_type": "transaction.sale.success", "event_body": { "merchant": { "id": "944025", "name": "Test merchant account" }, "features": { "is_test_mode": true }, "transaction_id": "8584364761", "transaction_type": "cc", "condition": "pendingsettlement", "processor_id": "ccprocessora", "ponumber": "", "order_description": "", "order_id": "", "customerid": "", "customertaxid": "", "website": "", "shipping": "", "currency": "USD", "tax": "", "surcharge": "", "convenience_fee": "", "misc_fee": "", "misc_fee_name": "", "cash_discount": "", "tip": "", "requested_amount": "10.00", "shipping_carrier": "", "tracking_number": "", "shipping_date": "", "partial_payment_id": "", "partial_payment_balance": "", "platform_id": "", "authorization_code": "123456", "social_security_number": "", "drivers_license_number": "", "drivers_license_state": "", "drivers_license_dob": "", "duty_amount": "0.00", "discount_amount": "0.00", "national_tax_amount": "0.00", "summary_commodity_code": "", "alternate_tax_amount": "0.00", "vat_tax_amount": "0.00", "vat_tax_rate": "0.00", "billing_address": { "first_name": "", "last_name": "", "address_1": "", "address_2": "", "company": "", "city": "", "state": "", "postal_code": "", "country": "", "email": "", "phone": "", "cell_phone": "", "fax": "" }, "shipping_address": { "first_name": "", "last_name": "", "address_1": "", "address_2": "", "company": "", "city": "", "state": "", "postal_code": "", "country": "", "email": "", "phone": "", "fax": "" }, "card": { "cc_number": "411111******1111", "cc_exp": "1025", "cavv": "", "cavv_result": "", "xid": "", "eci": "", "avs_response": "", "csc_response": "M", "cardholder_auth": "", "cc_start_date": "", "cc_issue_number": "", "card_balance": "", "card_available_balance": "", "entry_mode": "4", "cc_bin": "", "cc_type": "Visa", "feature_token": "" }, "merchant_defined_fields": {}, "action": { "amount": "10.00", "action_type": "sale", "date": "20230801114200", "success": "1", "ip_address": "123.123.123.123", "source": "api", "api_method": "direct_post", "username": "test", "response_text": "SUCCESS", "response_code": "100", "processor_response_text": "", "tap_to_mobile": false, "processor_response_code": "", "device_license_number": "", "device_nickname": "" } } } }, "sale-failure": { "summary": "Sale transaction failed", "description": "Sale transaction failed", "value": { "event_id": "a4807d52-4e40-4e93-92e2-b6d2dad3ddd9", "event_type": "transaction.sale.failure", "event_body": { "merchant": { "id": "944025", "name": "Test merchant account" }, "features": { "is_test_mode": true }, "transaction_id": "8584372177", "transaction_type": "cc", "condition": "failed", "processor_id": "ccprocessora", "ponumber": "", "order_description": "", "order_id": "", "customerid": "", "customertaxid": "", "website": "", "shipping": "", "currency": "USD", "tax": "", "surcharge": "", "convenience_fee": "", "misc_fee": "", "misc_fee_name": "", "cash_discount": "", "tip": "", "requested_amount": "0.50", "shipping_carrier": "", "tracking_number": "", "shipping_date": "", "partial_payment_id": "", "partial_payment_balance": "", "platform_id": "", "authorization_code": "", "social_security_number": "", "drivers_license_number": "", "drivers_license_state": "", "drivers_license_dob": "", "duty_amount": "0.00", "discount_amount": "0.00", "national_tax_amount": "0.00", "summary_commodity_code": "", "alternate_tax_amount": "0.00", "vat_tax_amount": "0.00", "vat_tax_rate": "0.00", "billing_address": { "first_name": "", "last_name": "", "address_1": "", "address_2": "", "company": "", "city": "", "state": "", "postal_code": "", "country": "", "email": "", "phone": "", "cell_phone": "", "fax": "" }, "shipping_address": { "first_name": "", "last_name": "", "address_1": "", "address_2": "", "company": "", "city": "", "state": "", "postal_code": "", "country": "", "email": "", "phone": "", "fax": "" }, "card": { "cc_number": "411111******1111", "cc_exp": "1025", "cavv": "", "cavv_result": "", "xid": "", "eci": "", "avs_response": "", "csc_response": "M", "cardholder_auth": "", "cc_start_date": "", "cc_issue_number": "", "card_balance": "", "card_available_balance": "", "entry_mode": "4", "cc_bin": "", "cc_type": "Visa", "feature_token": "" }, "merchant_defined_fields": {}, "action": { "amount": "0.50", "action_type": "sale", "date": "20230801114355", "success": "0", "ip_address": "123.123.123.123", "source": "api", "api_method": "direct_post", "username": "test", "response_text": "DECLINE", "response_code": "200", "processor_response_text": "", "tap_to_mobile": false, "processor_response_code": "", "device_license_number": "", "device_nickname": "" } } } }, "void-success": { "summary": "Void transaction was successful", "description": "Void transaction was successful", "value": { "event_id": "56fce295-ee70-46a1-83c2-1f423c43c34c", "event_type": "transaction.void.success", "event_body": { "merchant": { "id": "944025", "name": "Test merchant account" }, "features": { "is_test_mode": true }, "transaction_id": "8584341675", "transaction_type": "cc", "condition": "canceled", "processor_id": "ccprocessora", "ponumber": "", "order_description": "", "order_id": "", "customerid": "", "customertaxid": "", "website": "", "shipping": "0.00", "currency": "USD", "tax": "0.00", "surcharge": "", "convenience_fee": "", "misc_fee": "", "misc_fee_name": "", "cash_discount": "", "tip": "", "requested_amount": "10.00", "shipping_carrier": "", "tracking_number": "", "shipping_date": "", "partial_payment_id": "", "partial_payment_balance": "", "platform_id": "", "authorization_code": "123456", "social_security_number": "", "drivers_license_number": "", "drivers_license_state": "", "drivers_license_dob": "", "duty_amount": "0.00", "discount_amount": "0.00", "national_tax_amount": "0.00", "summary_commodity_code": "", "alternate_tax_amount": "0.00", "vat_tax_amount": "0.00", "vat_tax_rate": "0.00", "billing_address": { "first_name": "", "last_name": "", "address_1": "", "address_2": "", "company": "", "city": "", "state": "", "postal_code": "", "country": "", "email": "", "phone": "", "cell_phone": "", "fax": "" }, "shipping_address": { "first_name": "", "last_name": "", "address_1": "", "address_2": "", "company": "", "city": "", "state": "", "postal_code": "", "country": "", "email": "", "phone": "", "fax": "" }, "card": { "cc_number": "411111******1111", "cc_exp": "1025", "cavv": "", "cavv_result": "", "xid": "", "eci": "", "avs_response": "", "csc_response": "M", "cardholder_auth": "", "cc_start_date": "", "cc_issue_number": "", "card_balance": "", "card_available_balance": "", "entry_mode": "4", "cc_bin": "", "cc_type": "Visa", "feature_token": "" }, "merchant_defined_fields": {}, "action": { "amount": "10.00", "action_type": "void", "date": "20230801115329", "success": "1", "ip_address": "123.123.123.123", "source": "api", "api_method": "direct_post", "username": "test", "response_text": "SUCCESS", "response_code": "100", "processor_response_text": "", "tap_to_mobile": false, "processor_response_code": "", "device_license_number": "", "device_nickname": "" } } } }, "refund-success": { "summary": "Transaction refunded successfully", "description": "Transaction refunded successfully", "value": { "event_id": "e5267749-c235-45c9-b93e-21f4379b94d1", "event_type": "transaction.refund.success", "event_body": { "merchant": { "id": "944025", "name": "Test merchant account" }, "features": { "is_test_mode": true }, "transaction_id": "8597047042", "transaction_type": "cc", "condition": "pendingsettlement", "processor_id": "ccprocessora", "ponumber": "", "order_description": "", "order_id": "", "customerid": "", "customertaxid": "", "website": "", "shipping": "0.00", "currency": "USD", "tax": "0.00", "surcharge": "", "convenience_fee": "", "misc_fee": "", "misc_fee_name": "", "cash_discount": "", "tip": "", "requested_amount": "-1.50", "shipping_carrier": "", "tracking_number": "", "shipping_date": "", "partial_payment_id": "", "partial_payment_balance": "", "platform_id": "", "authorization_code": "123456", "social_security_number": "", "drivers_license_number": "", "drivers_license_state": "", "drivers_license_dob": "", "duty_amount": "0.00", "discount_amount": "0.00", "national_tax_amount": "0.00", "summary_commodity_code": "", "alternate_tax_amount": "0.00", "vat_tax_amount": "0.00", "vat_tax_rate": "0.00", "billing_address": { "first_name": "", "last_name": "", "address_1": "", "address_2": "", "company": "", "city": "", "state": "", "postal_code": "", "country": "", "email": "", "phone": "", "cell_phone": "", "fax": "" }, "shipping_address": { "first_name": "", "last_name": "", "address_1": "", "address_2": "", "company": "", "city": "", "state": "", "postal_code": "", "country": "", "email": "", "phone": "", "fax": "" }, "card": { "cc_number": "411111******1111", "cc_exp": "1025", "cavv": "", "cavv_result": "", "xid": "", "eci": "", "avs_response": "", "csc_response": "", "cardholder_auth": "", "cc_start_date": "", "cc_issue_number": "", "card_balance": "", "card_available_balance": "", "entry_mode": "4", "cc_bin": "", "cc_type": "Visa", "feature_token": "" }, "merchant_defined_fields": {}, "action": { "amount": "-1.50", "action_type": "refund", "date": "20230804155935", "success": "1", "ip_address": "123.123.123.123", "source": "api", "api_method": "direct_post", "username": "test", "response_text": "SUCCESS", "response_code": "100", "processor_response_text": "", "tap_to_mobile": false, "processor_response_code": "", "device_license_number": "", "device_nickname": "" } } } }, "validate-success": { "summary": "Validate transaction was successful", "description": "Validate transaction was successful", "value": { "event_id": "7c19bb37-8679-4ffb-b431-41ae49d8ff75", "event_type": "transaction.validate.success", "event_body": { "merchant": { "id": "944025", "name": "Test merchant account" }, "features": { "is_test_mode": true }, "transaction_id": "8584364761", "transaction_type": "cc", "condition": "complete", "processor_id": "ccprocessora", "ponumber": "", "order_description": "", "order_id": "", "customerid": "", "customertaxid": "", "website": "", "shipping": "", "currency": "USD", "tax": "", "surcharge": "", "convenience_fee": "", "misc_fee": "", "misc_fee_name": "", "cash_discount": "", "tip": "", "requested_amount": "", "shipping_carrier": "", "tracking_number": "", "shipping_date": "", "partial_payment_id": "", "partial_payment_balance": "", "platform_id": "", "authorization_code": "", "social_security_number": "", "drivers_license_number": "", "drivers_license_state": "", "drivers_license_dob": "", "duty_amount": "0.00", "discount_amount": "0.00", "national_tax_amount": "0.00", "summary_commodity_code": "", "alternate_tax_amount": "0.00", "vat_tax_amount": "0.00", "vat_tax_rate": "0.00", "billing_address": { "first_name": "", "last_name": "", "address_1": "", "address_2": "", "company": "", "city": "", "state": "", "postal_code": "", "country": "", "email": "", "phone": "", "cell_phone": "", "fax": "" }, "shipping_address": { "first_name": "", "last_name": "", "address_1": "", "address_2": "", "company": "", "city": "", "state": "", "postal_code": "", "country": "", "email": "", "phone": "", "fax": "" }, "card": { "cc_number": "411111******1111", "cc_exp": "1025", "cavv": "", "cavv_result": "", "xid": "", "eci": "", "avs_response": "", "csc_response": "M", "cardholder_auth": "", "cc_start_date": "", "cc_issue_number": "", "card_balance": "", "card_available_balance": "", "entry_mode": "4", "cc_bin": "", "cc_type": "Visa", "feature_token": "" }, "merchant_defined_fields": {}, "action": { "amount": "0", "action_type": "validate", "date": "20230804160357", "success": "1", "ip_address": "123.123.123.123", "source": "api", "api_method": "direct_post", "username": "test", "response_text": "SUCCESS", "response_code": "100", "processor_response_text": "", "tap_to_mobile": false, "processor_response_code": "", "device_license_number": "", "device_nickname": "" } } } }, "plan-added": { "summary": "Recurring Plan Added", "description": "Recurring Plan has been added", "value": { "event_id": "35f56738-4755-4cd9-9068-ea9e83d60d2e", "event_type": "recurring.plan.add", "event_body": { "merchant": { "id": "944025", "name": "Test merchant account" }, "features": { "is_test_mode": true }, "plan": { "id": "TestPlanId1", "name": "Test Plan", "amount": "10.00", "day_frequency": "", "payments": "Until canceled", "month_frequency": "1", "day_of_month": "15" } } } }, "plan-updated": { "summary": "Recurring Plan Updated", "description": "Recurring Plan has been updated", "value": { "event_id": "35f56738-4755-4cd9-9068-ea9e83d60d2e", "event_type": "recurring.plan.update", "event_body": { "merchant": { "id": "944025", "name": "Test merchant account" }, "features": { "is_test_mode": true }, "plan": { "id": "", "name": "Test Plan Updated", "amount": "20.00", "day_frequency": "", "payments": "Until canceled", "month_frequency": "", "day_of_month": "" } } } }, "plan-deleted": { "summary": "Recurring Plan Deleted", "description": "Recurring Plan has been deleted", "value": { "event_id": "35f56738-4755-4cd9-9068-ea9e83d60d2e", "event_type": "recurring.plan.delete", "event_body": { "merchant": { "id": "944025", "name": "Test merchant account" }, "features": { "is_test_mode": true }, "plan": { "id": "TestPlanId1", "name": "Test Plan Updated", "amount": "20.00", "day_frequency": "15", "payments": "Until canceled", "month_frequency": "1", "day_of_month": "0" } } } }, "subscription-added": { "summary": "Subscription Added", "description": "A new subscription has been added.", "value": { "event_id": "5f5706a2-aec2-4d69-b699-32e5745cf1fd", "event_type": "recurring.subscription.add", "event_body": { "merchant": { "id": "944025", "name": "Test merchant account" }, "features": { "is_test_mode": true }, "subscription_id": "8608342724", "subscription_type": "cc", "processor_id": "", "next_charge_date": "1970-01-01", "completed_payments": "0", "attempted_payments": "0", "remaining_payments": "Until canceled", "ponumber": "", "order_id": "", "order_description": "", "shipping": "", "tax": "", "website": "", "plan": { "id": "TestPlanId1", "name": "Test Plan", "amount": "10.00", "day_frequency": "", "payments": "Until canceled", "month_frequency": "1", "day_of_month": "15" }, "billing_address": { "first_name": "John", "last_name": "Smith", "address_1": "123 Lovely Lane", "address_2": "", "company": "", "city": "New York City", "state": "NY", "postal_code": "11111", "country": "US", "email": "", "phone": "", "cell_phone": "", "fax": "" }, "card": { "cc_number": "411111******1111", "cc_exp": "1025", "cavv": "", "cavv_result": "", "xid": "", "eci": "", "avs_response": "", "csc_response": "", "cardholder_auth": "", "cc_start_date": "", "cc_issue_number": "", "card_balance": "", "card_available_balance": "", "entry_mode": "", "cc_bin": "", "cc_type": "Visa" } } } }, "subscription-updated": { "summary": "Subscription Updated", "description": "A new subscription has been updated.", "value": { "event_id": "9f4c6478-e875-44d5-a83c-e2afebdaab86", "event_type": "recurring.subscription.update", "event_body": { "merchant": { "id": "944025", "name": "Test merchant account" }, "features": { "is_test_mode": true }, "subscription_id": "8608342724", "subscription_type": "cc", "processor_id": "", "next_charge_date": "2023-09-15", "completed_payments": "0", "attempted_payments": "0", "remaining_payments": "Until canceled", "ponumber": "", "order_id": "", "order_description": "", "shipping": "0.00", "tax": "0.00", "website": "", "plan": { "id": "", "name": "", "amount": "10.00", "day_frequency": "", "payments": "Until canceled", "month_frequency": "1", "day_of_month": "15" }, "billing_address": { "first_name": "John", "last_name": "Smith", "address_1": "123 Lovely Lane", "address_2": "", "company": "", "city": "New York City", "state": "NY", "postal_code": "11111", "country": "US", "email": "", "phone": "", "cell_phone": "", "fax": "" }, "card": { "cc_number": "411111******1111", "cc_exp": "1025", "cavv": "", "cavv_result": "", "xid": "", "eci": "", "avs_response": "", "csc_response": "", "cardholder_auth": "", "cc_start_date": "", "cc_issue_number": "", "card_balance": "", "card_available_balance": "", "entry_mode": "", "cc_bin": "", "cc_type": "Visa" } } } }, "subscription-deleted": { "summary": "Subscription Deleted", "description": "A new subscription has been deleted.", "value": { "event_id": "a1c0839a-4156-4f7c-a875-dc9411e2d3a6", "event_type": "recurring.subscription.delete", "event_body": { "merchant": { "id": "944025", "name": "Test merchant account" }, "features": { "is_test_mode": true }, "subscription_id": "8608342724", "subscription_type": "cc", "processor_id": "", "next_charge_date": "2023-09-15", "completed_payments": "0", "attempted_payments": "0", "remaining_payments": "Until canceled", "ponumber": "", "order_id": "", "order_description": "", "shipping": "0.00", "tax": "0.00", "website": "", "plan": { "id": "", "name": "", "amount": "10.00", "day_frequency": "", "payments": "Until canceled", "month_frequency": "1", "day_of_month": "15" }, "billing_address": { "first_name": "John", "last_name": "Smith", "address_1": "123 Lovely Lane", "address_2": "", "company": "", "city": "New York City", "state": "NY", "postal_code": "11111", "country": "US", "email": "", "phone": "", "cell_phone": "", "fax": "" }, "card": { "cc_number": "411111******1111", "cc_exp": "1025", "cavv": "", "cavv_result": "", "xid": "", "eci": "", "avs_response": "", "csc_response": "", "cardholder_auth": "", "cc_start_date": "", "cc_issue_number": "", "card_balance": "", "card_available_balance": "", "entry_mode": "", "cc_bin": "", "cc_type": "Visa" } } } }, "settlement-completed": { "summary": "Settlement Batch Completed", "description": "Settlement batch completed", "value": { "event_id": "11750910-bd03-4f9a-871a-786203df177f", "event_type": "settlement.batch.complete", "event_body": { "batch_id": "12345678", "count": 4, "amount": "402.81", "merchant": { "id": "123456", "name": "Test Account" }, "processor": { "id": "ccprocessor", "name": "CC Processor", "type": "cc" }, "by_card_type": { "visa": { "count": 4, "amount": "402.81" } }, "transaction_ids": [ "1234000000", "1234000001", "1234000002", "1234000003" ] } } }, "settlement-failed": { "summary": "Settlement Batch Failed", "description": "Settlement batch failed", "value": { "event_id": "dfe8156d-5dd9-43ac-8928-3cf70ef74108", "event_type": "settlement.batch.failure", "event_body": { "batch_id": "123456", "merchant": { "id": "123456", "name": "Test Merchant" }, "processor": { "id": "ccprocessor", "name": "CC Processor", "type": "cc" } } } }, "acu.summary.automaticallyupdated": { "summary": "Automatically Updated", "description": "Automatically updated", "value": { "event_id": "7958c536-88f0-47f4-bb55-54575259a3be", "event_type": "acu.summary.automaticallyupdated", "event_body": { "updated_date": "2022-08-22", "merchant": { "id": 123456, "name": "Test Account" }, "cards_checked": { "customer_vault": { "checked": 376, "updated": 4 }, "subscriptions": { "checked": 434, "updated": 3 } }, "vault_count_updated_cards": 1, "vault_updated_cards": [ { "customer_vault_id": "308229500", "billing_id": "1781228768", "cc_number": "445701******0009", "cc_exp": "01/50", "first_name": "Bob", "last_name": "Smith", "email": "bsmith@example.com", "phone": "+14801112222" } ], "vault_count_updated_expiration_dates": 3, "vault_updated_expiration_dates": [ { "customer_vault_id": "2061222895", "billing_id": "350282046", "cc_number": "400000******0002", "cc_exp": "11/70", "first_name": "Bob", "last_name": "Smith", "email": "bobsmith@company.com", "phone": "4801112222" }, { "customer_vault_id": "1039486483", "billing_id": "1408598861", "cc_number": "400000******0034", "cc_exp": "11/70", "first_name": "Jane", "last_name": "Smith", "email": "jane@organization.org", "phone": "+12125551222" }, { "customer_vault_id": "1033346428", "billing_id": "1460247050", "cc_number": "520000******0007", "cc_exp": "12/33", "first_name": "Steve", "last_name": "Customer", "email": "steve@customer.com", "phone": "+13104053434" } ], "recurring_count_updated_cards": 2, "recurring_updated_cards": [ { "subscription_id": "281474976710720", "cc_number": "445701******0459", "cc_exp": "01/50", "first_name": "", "last_name": "", "email": "", "phone": "" }, { "subscription_id": "281474976710726", "cc_number": "445701******1123", "cc_exp": "01/50", "first_name": "Frank", "last_name": "Jones", "email": "fjones@example.com", "phone": "6021234567" } ], "recurring_count_updated_expiration_dates": 1, "recurring_updated_expiration_dates": [ { "subscription_id": "281474976710725", "cc_number": "400000******3223", "cc_exp": "11/70", "first_name": "Susan", "last_name": "Harris", "email": "harris@company.com", "phone": "3125551212" } ] } } }, "acu.summary.closedaccount": { "summary": "Closed Account", "description": "Closed Account", "value": { "event_id": "7bbd4af6-4075-4902-af56-9fc59ab71362", "event_type": "acu.summary.closedaccount", "event_body": { "updated_date": "2022-08-23", "merchant": { "id": 123456, "name": "Test Account" }, "cards_checked": { "customer_vault": { "checked": 123, "updated": 1 }, "subscriptions": { "checked": 232, "updated": 1 } }, "vault_count_updated_closed_account": 1, "vault_updates": [ { "customer_vault_id": "281474976710722", "billing_id": "230304034", "cc_number": "434343******0123", "cc_exp": "11/25", "first_name": "Longterm", "last_name": "Client", "email": "sample@customer.com", "phone": "6025551213" } ], "recurring_count_updated_closed_account": 1, "recurring_updates": [ { "subscription_id": "281474976710727", "cc_number": "601101******0002", "cc_exp": "11/32", "first_name": "Bob", "last_name": "Smith", "email": "bsmith@example.co.uk", "phone": "+440111122222" } ] } } }, "acu.summary.contactcustomer": { "summary": "Contact Support", "description": "Contact Support", "value": { "event_id": "7bbd4af6-4075-4902-af56-9fc59ab71362", "event_type": "acu.summary.contactcustomer", "event_body": { "updated_date": "2022-08-23", "merchant": { "id": 123456, "name": "Test Account" }, "cards_checked": { "customer_vault": { "checked": 123, "updated": 2 }, "subscriptions": { "checked": 232, "updated": 1 } }, "vault_count_updated_contact_customer": 2, "vault_updates": [ { "customer_vault_id": "40403043545", "billing_id": "34544356", "cc_number": "445343******7432", "cc_exp": "06/29", "first_name": "Happy", "last_name": "Customer", "email": "frequent@shopper.com", "phone": "5555559999" }, { "customer_vault_id": "281474976710722", "billing_id": "230304034", "cc_number": "434343******0123", "cc_exp": "11/25", "first_name": "Bill", "last_name": "Thompson", "email": "bill@anothercustomer.com", "phone": "6025551213" } ], "recurring_count_updated_contact_customer": 1, "recurring_updates": [ { "subscription_id": "323232232445", "cc_number": "465333******4232", "cc_exp": "04/30", "first_name": "Recurring", "last_name": "Customer", "email": "buy@repeatedly.com", "phone": "8185552323" } ] } } }, "chargeback.batch.complete": { "summary": "Chargeback Batch Completed", "description": "Chargeback Batch Completed", "value": { "event_id": "7bbd4af6-4075-4902-af56-9fc59ab71362", "event_type": "chargeback.batch.complete", "event_body": { "merchant": { "id": "123456", "name": "Test Account" }, "processor": { "id": "ccprocessor", "name": "CC Processor", "type": "cc" }, "count": 1, "chargeback_amount": "12.34", "chargebacks": [ { "id": "12345678", "date": "2023-08-11", "customer_name": "John Doe", "cc_number": "411111******1111", "amount": "12.34", "reason": "Cardholder Does Not Recognize" } ] } } } }, "schemas": { "GetMerchantListRequest": { "title": "Get Merchant List", "allOf": [ { "type": "object", "required": [ "maxResults" ], "properties": { "maxResults": { "type": "string", "description": "Required. Value must be between 1-1000." }, "ids": { "type": "array", "description": "An array of merchant ids.", "items": { "type": "string" } }, "parentAffiliateId": { "type": "string", "description": "\"parentAffiliateId\": \"1\" // An affiliate id. Only merchants under this affiliate will be returned, rather than the full tree." }, "type": { "type": "string", "description": "\"type\": \"gateway\" // Only available options are gateway, test, splitFunding, mobile." }, "search": { "type": "string", "description": "\"search\": \"Asdf\" Performs a search on this text as a case-insensitive search on any of the following: email, company name, first and last name, phone number, external id, or username" }, "offset": { "type": "string", "description": "\"offset\": 0 // Like all reports and search endpoints, you can specify the offset, which is the start point for the responses" } } } ] }, "GetMerchantListResponse": { "type": "object", "title": "Response", "properties": { "objectType": { "type": "string", "enum": [ "serviceConfig" ], "description": "The type of object that was returned as a result of the request." }, "reportId": { "type": "number", "description": "The ID of the report." }, "offset": { "type": "number", "description": "The first N skipped results." }, "maxResults": { "type": "number", "description": "The max number results." }, "totalResults": { "type": "number", "description": "The total number of results." }, "hasMore": { "type": "boolean", "description": "If are there more results for the search." }, "links": { "type": "array", "description": "Links for querying results.", "items": { "type": "object", "properties": { "first": { "type": "string", "description": "First page of query results." }, "last": { "type": "string", "description": "Last page of query results." }, "next": { "type": "string", "description": "Next page of current query results." }, "previous": { "type": "string", "description": "Previous page of current query results." } } } }, "results": { "type": "array", "description": "Results for the search.", "items": { "type": "object", "properties": { "objectType": { "type": "string", "description": "Type of the returned response object" }, "id": { "type": "string", "description": "The ID for the transaction." }, "created": { "type": "string", "format": "date-time", "description": "The timestamp indicating when the transaction was created." }, "updated": { "type": "string", "format": "date-time", "description": "The timestamp indicating when the transaction was last updated." }, "firstName": { "type": "string", "description": "The first name of the merchant's company contact" }, "lastName": { "type": "string", "description": "The last name of the merchant's company contact" }, "company": { "type": "string", "description": "The merchant's company name." }, "email": { "type": "string", "description": "The email of the merchant's company contact" }, "phone": { "type": "string", "description": "The phone number of the merchant's company contact" }, "fax": { "type": "string", "description": "The fax number of the merchant's company contact" }, "address1": { "type": "string", "description": "The first line of the merchant's address" }, "address2": { "type": "string", "description": "The second line of the merchant's address" }, "city": { "type": "string", "description": "The city associated with the merchant's address" }, "state": { "type": "string", "description": "The state associated with the merchant's address" }, "zip": { "type": "string", "description": "The postal code associated with the merchant's address" }, "country": { "type": "string", "description": "The country associated with the merchant's address" }, "timezone": { "type": "string", "description": "The merchant's timezone" }, "costPlan": { "type": "string", "description": "The cost plan assigned to the merchant." }, "status": { "type": "string", "description": "The status of the merchant." }, "externalIdentifier": { "type": "string", "description": "A description to further describe or identify the merchant." }, "lastTransactionDate": { "type": "string", "description": "The date of the last transaction on the merchant." }, "parentAffiliateId": { "type": "string", "description": "The ID of the affiliate directly above the merchant." }, "accountInfo": { "type": "object", "description": "Banking information for merchant billing.", "properties": { "checkAba": { "type": "string", "description": "The routing/ABA number used to bill the merchant." }, "checkAccount": { "type": "string", "description": "The account number used to bill the merchant." }, "accountType": { "type": "string", "description": "The type of bank account being used." }, "accountHolderType": { "type": "string", "description": "The type of holder for the bank account being used." } } }, "features": { "type": "object", "description": "A collection of various merchant feature flags.", "properties": { "forceTos": { "type": "boolean", "description": "Whether or not the merchant is forced to accept the Terms of Service." }, "forceBillingAuth": { "type": "boolean", "description": "Whether or not the merchant is forced to accept the Billing Auth." }, "allowBlindCredits": { "type": "boolean", "description": "Whether or not the merchant is allowed to issue blind credits for Credit Cards." }, "allowBlindCheckCredits": { "type": "boolean", "description": "Whether or not the merchant is allowed to issue blind credits for Checks." }, "advancedTransactionRouting": { "type": "boolean", "description": "Whether or not the merchant has advanced transaction routing enabled." }, "sendBillingEmail": { "type": "boolean", "description": "Whether or not the merchant receives an email for their billing." }, "braspag": { "type": "object", "description": "Feature flags specifically related to the braspag processor.", "properties": { "advancedTransactionRouting": { "type": "boolean", "description": "Whether or not the braspag processor has advanced transaction routing enabled." } } }, "verifi": { "type": "object", "description": "Feature flags specifically related to the verifi service.", "properties": { "enabled": { "type": "boolean", "description": "Whether or not the verifi service is enabled for the merchant." } } }, "viewBillingStatement": { "type": "boolean", "description": "Whether or not the merchant can view their billing statement." }, "litle": { "type": "object", "description": "Feature flags specifically related to the litle processor.", "properties": { "reportGroup": { "type": "string", "description": "The merchant's litle report group. Returns false if not configured." }, "prePaidIndicator": { "type": "string", "description": "The merchant's litle prepaid indicator. Returns false if not configured." }, "affluentIndicator": { "type": "string", "description": "The merchant's litle affluent indicator. Returns false if not configured." }, "recycleAdvice": { "type": "string", "description": "The merchant's litle recycle advice. Returns false if not configured." }, "campaign": { "type": "string", "description": "The merchant's litle campaign. Returns false if not configured." }, "affiliate": { "type": "string", "description": "The merchant's litle affiliate. Returns false if not configured." }, "merchantGroupId": { "type": "string", "description": "The merchant's litle group ID. Returns false if not configured." } } }, "allowEmptyCcExp": { "type": "boolean", "description": "Whether or not the merchant is allowed to pass empty Credit Card Expiration Dates." }, "pastDue": { "type": "boolean", "description": "Whether or not the merchant's bill is past due." }, "apiReceipt": { "type": "boolean", "description": "Whether or not the merchant's API transactions send receipts." }, "batchReceipt": { "type": "boolean", "description": "Whether or not the merchant can batch receipts." }, "delinquent": { "type": "boolean", "description": "Whether or not the merchant is in a delinquent state." }, "commercialCardIndicator": { "type": "string", "description": "The merchant's commercial card indicator. Returns false if not configured." }, "customDescription": { "type": "string", "description": "The merchant's custom description. Returns false if not configured." }, "apiAllowOnlyUsername": { "type": "boolean", "description": "Whether or not the merchant can authenticate with the APIs using only a username." }, "orderIdDuplicateCheck": { "type": "boolean", "description": "Whether or not the merchant has duplicate checking for the Order ID field." }, "cardLevelResult": { "type": "string", "description": "The merchant's card level result. Returns false if not configured." }, "pmsalem": { "type": "object", "description": "Feature flags specifically related to the pmsalem processor.", "properties": { "ignoreAmexCvv": { "type": "boolean", "description": "Whether or not the merchant's pmsalem processor ignores the Amex CVV field." }, "allowNovusVerify": { "type": "boolean", "description": "Whether or not the merchant's pmsalem processor can verify Novus cards schemes." }, "idInMdf11": { "type": "boolean", "description": "Whether or not the merchant's pmsalem processor can pass the ID in MDF11." } } }, "credorax": { "type": "object", "description": "Feature flags specifically related to the credorax processor.", "properties": { "bankNet": { "type": "string", "description": "The merchant's bank net value for credorax. Returns false if not configured." }, "z5Risk": { "type": "string", "description": "The merchant's z5 risk value for credorax. Returns false if not configured." } } }, "vantiv": { "type": "object", "description": "Feature flags specifically related to the vantiv processor.", "properties": { "remainingBalance": { "type": "string", "description": "The merchant's remaining balance for vantiv. Returns false if not configured." } } }, "prosa": { "type": "object", "description": "Feature flags specifically related to the prosa processor.", "properties": { "deferredPayment": { "type": "boolean", "description": "Whether or not the merchant has deferred payments enabled for the prosa processor." } } }, "cronopay": { "type": "object", "description": "Feature flags specifically related to the cronopay processor.", "properties": { "customerId": { "type": "string", "description": "The merchant's cronopay customer ID. Returns false if not configured." } } }, "captureHigher": { "type": "boolean", "description": "Whether or not the merchant is allowed to capture higher than the preceding auth." }, "moneris": { "type": "object", "description": "Feature flags related specifically to the moneris processor.", "properties": { "orderId": { "type": "string", "description": "The merchant's order ID for moneris transactions. Returns false if not configured." } } }, "extendedFileBatchResponse": { "type": "boolean", "description": "Whether or not the merchant receives and extended file batch response." }, "credov3": { "type": "object", "description": "Feature flags related specifically to the credov3 processor.", "properties": { "ignoreAmexCvv": { "type": "boolean", "description": "Whether or not the merchant's credov3 processor ignores the Amex CVV field." } } }, "enforceRequiredFieldsForSwiped": { "type": "boolean", "description": "Whether or not the merchant must continue to pass required fields when using Swipe." }, "preventDuplicateCvRecords": { "type": "boolean", "description": "Whether or not the merchant is prevented from making duplicate Customer Vault records." }, "preventConfiguringSurcharge": { "type": "boolean", "description": "Whether or not the merchant is prevented from configuring settings for surcharge." }, "tsys": { "type": "object", "description": "Feature flags related specifically to the tsys processor.", "properties": { "paymentFacilitatorFields": { "type": "string", "description": "The merchant's tsys payment facilitator fields. Returns false if not configured." }, "allowCustomReport": { "type": "boolean", "description": "Whether or not the merchant is allowed to do a custom report with tsys." }, "alternativePostData": { "type": "boolean", "description": "Whether or not the merchant is allowed to add alternative post data with tsys." } } }, "requireProcessorFieldOnVt": { "type": "string", "description": "Require a processor be specified on all transactions in the Virtual Terminal." }, "isCardTesting": { "type": "string", "description": "Is merchant's card testing." }, "allowTipOnVtKeyedTransactions": { "type": "string", "description": "Allow merchant to enter tips in the virtual terminal on keyed transactions." }, "transitForceAcceptance": { "type": "string", "description": "Merchant is approved for Force Acceptance." }, "level3": { "type": "object", "description": "Merchant's level III template data.", "properties": { "autoLoadTemplate": { "type": "boolean", "description": "Automatically add my Level III template data to the merchant's credit card transactions." } } }, "emvPartialApprovals": { "type": "string", "description": "Allow Merchant to accept Partial Approvals for EMV transactions." }, "supportsGooglePay": { "type": "string", "description": "Merchant supports Google Pay." }, "supportsApplePay": { "type": "string", "description": "Merchant supports Apple Pay." }, "isApplePayEnabled": { "type": "string", "description": "Is Apple Pay enabled." }, "useDeviceRecognition": { "type": "string", "description": "Enable device recognition for all merchant users when logging into the control panel (users with two-factor enabled are exempt)." } } }, "needsPendingServicesActivated": { "type": "string", "description": "Merchant needs pending services activated." }, "payFacBillingPeriod": { "type": "string", "description": "Payment Facilitator Billing Period." }, "rejectedCertificates": { "type": "string", "description": "Number of rejected certificates." } } } } } }, "Merchant": { "type": "object", "title": "Merchant", "description": "Merchant Details", "properties": { "id": { "type": "string", "description": "Merchant identifier" }, "name": { "type": "string", "description": "Merchant name" } } }, "Features": { "type": "object", "title": "Features", "description": "Features associated with the transaction", "properties": { "is_test_mode": { "type": "boolean", "description": "Test mode status" } } }, "BillingAddress": { "type": "object", "title": "Billing Address", "description": "Billing Address details", "properties": { "first_name": { "type": "string", "description": "The first name of the person associated with the billing address." }, "last_name": { "type": "string", "description": "The last name of the person associated with the billing address." }, "address_1": { "type": "string", "description": "The first line of the street address." }, "address_2": { "type": "string", "description": "The second line of the street address." }, "company": { "type": "string", "description": "The name of the company associated with the billing address." }, "city": { "type": "string", "description": "The name of the city associated with the billing address." }, "state": { "type": "string", "description": "The name of the state or province associated with the billing address.\n \nFormat: `CC`" }, "postal_code": { "type": "string", "description": "The postal code or zip code associated with the billing address." }, "country": { "type": "string", "description": "The name of the country associated with the billing address. *Country codes are as shown in ISO 3166-1 alpha-2*.\n \nFormat: `CC`" }, "email": { "type": "string", "format": "email", "description": "The email address associated with the billing address." }, "phone": { "type": "string", "format": "phone", "description": "The phone number associated with the billing address." }, "cell_phone": { "type": "string", "format": "phone", "description": "The cell phone number associated with the billing address." }, "fax": { "type": "string", "format": "phone", "description": "The fax number associated with the billing address." } } }, "ShippingAddress": { "type": "object", "title": "Shipping Address", "description": "Shipping Address details.", "properties": { "first_name": { "type": "string", "description": "The first name of the person associated with the shipping address." }, "last_name": { "type": "string", "description": "The last name of the person associated with the shipping address." }, "address_1": { "type": "string", "description": "The first line of the street address." }, "address_2": { "type": "string", "description": "The second line of the street address." }, "company": { "type": "string", "description": "The name of the company associated with the shipping address." }, "city": { "type": "string", "description": "The city of the shipping address." }, "state": { "type": "string", "description": "The state or province of the shipping address.\n \nFormat: `CC`" }, "postal_code": { "type": "string", "description": "The postal or zip code of the shipping address." }, "country": { "type": "string", "description": "The country of the shipping address. *Country codes are as shown in ISO 3166-1 alpha-2*.\n \nFormat: `CC`" }, "email": { "type": "string", "description": "The email address associated with the shipping address." }, "phone": { "type": "string", "description": "The phone number associated with the shipping address." }, "fax": { "type": "string", "description": "The fax number associated with the shipping address." } } }, "CardDetails": { "type": "object", "title": "Card Details", "description": "Details related to the credit card used in the transaction. Available for credit card transactions only.", "properties": { "cc_number": { "type": "string", "description": "Masked credit card number" }, "cc_exp": { "type": "string", "description": "Credit card expiration date" }, "cavv": { "type": "string", "description": "Cardholder Authentication Verification Value" }, "cavv_result": { "type": "string", "description": "Cardholder Authentication Verification Value result" }, "xid": { "type": "string", "description": "Cardholder authentication transaction id" }, "eci": { "type": "string", "enum": [ "01", "02", "05", "06", "07", "08", "09", "" ], "description": "Electronic Commerce Indicator" }, "avs_response": { "type": "string", "description": "Address Verification Service response" }, "csc_response": { "type": "string", "description": "Card Security Code response" }, "cardholder_auth": { "type": "string", "enum": [ "verified", "attempted", "" ], "description": "Cardholder Authentication response" }, "cc_start_date": { "type": "string", "description": "Credit card start date" }, "cc_issue_number": { "type": "string", "description": "Credit card issue number" }, "card_balance": { "type": "string", "description": "Card balance" }, "card_available_balance": { "type": "string", "description": "Card available balance" }, "entry_mode": { "type": "string", "enum": [ "0", "1", "2", "3", "4", "5", "6", "7", "8" ], "description": "The type of transaction data to be processed.\n\n<details>\n<summary>Possible values:</summary>\n\n| Code | Description |\n|:------|:--------------------|\n| 0 | Unknown |\n| 1 | Invalid |\n| 2 | NFC MSD |\n| 3 | Swiped |\n| 4 | Keyed |\n| 5 | EMV ICC |\n| 6 | NFC EMV |\n| 7 | Keyed - Fallback |\n| 8 | Swiped - Fallback |\n</details>" }, "cc_bin": { "type": "string", "description": "Credit card BIN (first 6 digits)" }, "cc_type": { "type": "string", "description": "Credit card type (visa, ..)" }, "feature_token": { "type": "string", "description": "Feature token" } } }, "ACHAccountHolderType": { "type": "string", "enum": [ "business", "personal" ], "description": "The customer's ACH account entity." }, "ACHAccountType": { "type": "string", "enum": [ "checking", "savings" ], "description": "The customer's ACH account type." }, "ACHSecCode": { "type": "string", "enum": [ "PPD", "WEB", "TEL", "CCD" ], "description": "ACH standard entry class codes." }, "CheckDetails": { "type": "object", "title": "Check Details", "description": "Details about a check payment. Available for ACH transactions only.", "properties": { "check_account": { "type": "string", "description": "The customer's bank account number." }, "check_aba": { "type": "string", "description": "The customer's bank routing number." }, "check_name": { "type": "string", "description": "The customer's name." }, "account_holder_type": { "$ref": "#/components/schemas/ACHAccountHolderType" }, "account_type": { "$ref": "#/components/schemas/ACHAccountType" }, "sec_code": { "$ref": "#/components/schemas/ACHSecCode" } } }, "EmvMetaData": { "type": "object", "title": "EMV Meta Data", "description": "Details about the EMV transaction", "properties": { "application_id": { "type": "string", "description": "EMV Application ID" }, "application_label": { "type": "string", "description": "EMV Application Label" }, "application_preferred_name": { "type": "string", "description": "EMV Application Preferred Name" }, "transaction_status_info": { "type": "string", "description": "Transaction Status Information" }, "application_pan_sequence_number": { "type": "string", "description": "EMV Application PAN Sequence Number" }, "customer_verification_method": { "type": "string", "enum": [ "signature", "offline_pin", "online_pin", "none", "offline_pin_signature", "consumer_device", "consumer_device_plus_signature", "" ], "description": "EMV Customer Verification Method" } } }, "TransactionAction": { "type": "object", "title": "Transaction Action", "description": "Transaction Action details", "properties": { "amount": { "type": "string", "description": "Amount of the transaction", "format": "decimal" }, "action_type": { "type": "string", "enum": [ "auth", "capture", "sale", "void", "refund", "credit", "return", "validate" ], "description": "Type of transaction" }, "date": { "type": "string", "format": "date-time", "description": "Date of the transaction" }, "success": { "type": "string", "enum": [ "0", "1" ], "description": "Transaction Success Flag (0 - Failed, 1 - Success)" }, "ip_address": { "type": "string", "description": "IP Address of the transaction", "format": "ipv4" }, "source": { "type": "string", "enum": [ "api", "batch_upload", "mobile", "quickclick", "quickbooks", "recurring", "swipe", "virtual_terminal", "internal" ], "description": "Source of the transaction" }, "api_method": { "type": "string", "description": "API Method used for the transaction (direct_post, ..)" }, "username": { "type": "string", "description": "Username" }, "response_text": { "type": "string", "enum": [ "APPROVED", "SUCCESS", "DECLINE" ], "description": "Transaction Response Text" }, "response_code": { "type": "string", "description": "Response Code (100 - OK, 200 - Declined)" }, "processor_response_text": { "type": "string", "description": "Processor Response Text" }, "processor_response_code": { "type": "string", "description": "Processor Response Code" }, "tap_to_mobile": { "type": "boolean", "description": "Tap to Mobile Flag" }, "device_license_number": { "type": "string", "description": "Mobile Device License Number" }, "device_nickname": { "type": "string", "description": "Mobile Device Nickname" } } }, "RecurringCardDetails": { "type": "object", "title": "Card Details", "description": "Details related to the credit card used in the transaction. Available for credit card transactions only.", "properties": { "cc_number": { "type": "string", "description": "Masked credit card number" }, "cc_exp": { "type": "string", "description": "Credit card expiration date" }, "cavv": { "type": "string", "description": "Cardholder Authentication Verification Value" }, "cavv_result": { "type": "string", "description": "Cardholder Authentication Verification Value result" }, "xid": { "type": "string", "description": "Cardholder authentication transaction id" }, "eci": { "type": "string", "enum": [ "01", "02", "05", "06", "07", "08", "09", "" ], "description": "Electronic Commerce Indicator" }, "avs_response": { "type": "string", "description": "Address Verification Service response" }, "csc_response": { "type": "string", "description": "Card Security Code response" }, "cardholder_auth": { "type": "string", "enum": [ "verified", "attempted", "" ], "description": "Cardholder Authentication response" }, "cc_start_date": { "type": "string", "description": "Credit card start date" }, "cc_issue_number": { "type": "string", "description": "Credit card issue number" }, "card_balance": { "type": "string", "description": "Card balance" }, "card_available_balance": { "type": "string", "description": "Card available balance" }, "entry_mode": { "type": "string", "enum": [ "0", "1", "2", "3", "4", "5", "6", "7", "8", "" ], "description": "The type of transaction data to be processed.\n\n<details>\n<summary>Possible values:</summary>\n\n| Code | Description |\n|:------|:--------------------|\n| 0 | Unknown |\n| 1 | Invalid |\n| 2 | NFC MSD |\n| 3 | Swiped |\n| 4 | Keyed |\n| 5 | EMV ICC |\n| 6 | NFC EMV |\n| 7 | Keyed - Fallback |\n| 8 | Swiped - Fallback |\n</details>" }, "cc_bin": { "type": "string", "description": "Credit card BIN (first 6 digits)" }, "cc_type": { "type": "string", "description": "Credit card type (visa, ..)" } } }, "RecurringEventBody": { "type": "object", "title": "Subscription Event Body", "description": "Details about Subscription.", "required": [ "merchant", "features", "plan" ], "properties": { "merchant": { "$ref": "#/components/schemas/Merchant" }, "features": { "$ref": "#/components/schemas/Features" }, "subscription_id": { "type": "string", "description": "Subscription ID" }, "subscription_type": { "type": "string", "enum": [ "cc", "ck" ], "description": "Subscription Type (cc - Credit Card, ck - Check)" }, "processor_id": { "type": "string", "description": "Processor ID" }, "next_charge_date": { "type": "string", "format": "date", "description": "Next Charge Date" }, "completed_payments": { "type": "string", "format": "number", "description": "Completed Payments" }, "attempted_payments": { "type": "string", "format": "number", "description": "Attempted Payments" }, "remaining_payments": { "type": "string", "description": "Remaining Payments (`Until canceled` or number of remaining payments)" }, "ponumber": { "type": "string", "description": "PO Number" }, "order_id": { "type": "string", "description": "Order ID" }, "order_description": { "type": "string", "description": "Order Description" }, "shipping": { "type": "string", "description": "Shipping Details" }, "tax": { "type": "string", "description": "Tax Details" }, "website": { "type": "string", "description": "Website Details" }, "plan": { "type": "object", "title": "Plan", "description": "Plan Details", "properties": { "id": { "type": "string", "description": "Plan ID" }, "name": { "type": "string", "description": "Plan Name" }, "amount": { "type": "string", "description": "Plan Amount" }, "day_frequency": { "type": "string", "description": "Day Frequency" }, "payments": { "type": "string", "description": "Payments Details" }, "month_frequency": { "type": "string", "format": "number", "description": "Month Frequency" }, "day_of_month": { "type": "string", "format": "number", "description": "Day of Month" } } }, "billing_address": { "$ref": "#/components/schemas/BillingAddress" }, "card": { "$ref": "#/components/schemas/RecurringCardDetails" }, "check": { "$ref": "#/components/schemas/CheckDetails" } } }, "TransactionSummary": { "type": "object", "title": "Transactions summary", "description": "Summary (number of transactions and total amount)", "properties": { "count": { "type": "integer", "format": "int64", "description": "Transactions Count" }, "amount": { "type": "string", "format": "number", "description": "Transactions Amount" } } }, "SettlementEventBody": { "type": "object", "title": "Settlement Event Body", "description": "Details about Settlement.", "required": [ "batch_id", "merchant", "processor" ], "properties": { "batch_id": { "type": "string", "format": "int64", "description": "Batch ID" }, "merchant": { "$ref": "#/components/schemas/Merchant" }, "processor": { "type": "object", "title": "Processor", "description": "Processor Details", "properties": { "id": { "type": "string", "description": "Processor ID" }, "name": { "type": "string", "description": "Processor Name" }, "type": { "type": "string", "enum": [ "cc", "ck" ], "description": "Processor Type (cc - Credit Card, ck - Check)" } } }, "count": { "type": "integer", "format": "int64", "description": "Transactions Count" }, "amount": { "type": "string", "format": "number", "description": "Transactions Amount" }, "transaction_ids": { "type": "array", "description": "Transaction IDs", "items": { "type": "string", "description": "Transaction ID" } }, "by_card_type": { "type": "object", "title": "By Card Type", "description": "Transactions by Card Type", "properties": { "visa": { "$ref": "#/components/schemas/TransactionSummary" }, "mastercard": { "$ref": "#/components/schemas/TransactionSummary" }, "amex": { "$ref": "#/components/schemas/TransactionSummary" }, "discover": { "$ref": "#/components/schemas/TransactionSummary" }, "diners": { "$ref": "#/components/schemas/TransactionSummary" }, "jcb": { "$ref": "#/components/schemas/TransactionSummary" }, "maestro": { "$ref": "#/components/schemas/TransactionSummary" }, "ebt": { "$ref": "#/components/schemas/TransactionSummary" } }, "additionalProperties": { "type": "object", "description": "Other card types" } } } }, "AcuCustomerVaultDetails": { "type": "object", "description": "Details about a customer vault card with updated expiration date.", "properties": { "customer_vault_id": { "type": "string", "description": "The ID of the customer vault." }, "billing_id": { "type": "string", "description": "The billing ID of the customer." }, "cc_number": { "type": "string", "description": "The masked credit card number." }, "cc_exp": { "type": "string", "description": "The updated expiration date of the credit card." }, "first_name": { "type": "string", "description": "The first name of the customer." }, "last_name": { "type": "string", "description": "The last name of the customer." }, "email": { "type": "string", "description": "The email address of the customer." }, "phone": { "type": "string", "description": "The phone number of the customer." } } }, "AcuSubscriptionDetails": { "type": "object", "description": "Details about a recurring card that was updated.", "properties": { "subscription_id": { "type": "string", "description": "The ID of the subscription." }, "cc_number": { "type": "string", "description": "The masked credit card number." }, "cc_exp": { "type": "string", "description": "The expiration date of the credit card." }, "first_name": { "type": "string", "description": "The first name of the customer." }, "last_name": { "type": "string", "description": "The last name of the customer." }, "email": { "type": "string", "description": "The email address of the customer." }, "phone": { "type": "string", "description": "The phone number of the customer." } } }, "AcuAutoUpdatedEventBody": { "type": "object", "title": "ACU Automatically Updated Event Body", "description": "Details about ACU Automatically Updated Event.", "required": [ "updated_date", "merchant", "cards_checked" ], "properties": { "updated_date": { "type": "string", "format": "date", "description": "The update date." }, "merchant": { "type": "object", "title": "Merchant", "description": "Merchant Details", "properties": { "id": { "type": "integer", "description": "Merchant identifier" }, "name": { "type": "string", "description": "Merchant name" } } }, "cards_checked": { "type": "object", "description": "Details about the cards that were checked.", "properties": { "customer_vault": { "type": "object", "description": "Details about the customer vault cards that were checked.", "properties": { "checked": { "type": "integer", "description": "The number of customer vault cards that were checked." }, "updated": { "type": "integer", "description": "The number of customer vault cards that were updated." } } }, "subscriptions": { "type": "object", "description": "Details about the subscription cards that were checked.", "properties": { "checked": { "type": "integer", "description": "The number of subscription cards that were checked." }, "updated": { "type": "integer", "description": "The number of subscription cards that were updated." } } } } }, "vault_count_updated_cards": { "type": "integer", "description": "The number of customer vault cards that were updated." }, "vault_updated_cards": { "type": "array", "description": "Details about the customer vault cards that were updated.", "items": { "$ref": "#/components/schemas/AcuCustomerVaultDetails" } }, "vault_count_updated_expiration_dates": { "type": "integer", "description": "The number of customer vault cards with updated expiration dates." }, "vault_updated_expiration_dates": { "type": "array", "description": "Details about the customer vault cards with updated expiration dates.", "items": { "$ref": "#/components/schemas/AcuCustomerVaultDetails" } }, "recurring_count_updated_cards": { "type": "integer", "description": "The number of recurring cards that were updated." }, "recurring_updated_cards": { "type": "array", "description": "Details about the recurring cards that were updated.", "items": { "$ref": "#/components/schemas/AcuSubscriptionDetails" } }, "recurring_count_updated_expiration_dates": { "type": "integer", "description": "The number of recurring cards with updated expiration dates." }, "recurring_updated_expiration_dates": { "type": "array", "description": "Details about the recurring cards with updated expiration dates.", "items": { "$ref": "#/components/schemas/AcuSubscriptionDetails" } } } }, "AcuClosedAccountEventBody": { "type": "object", "title": "ACU Closed Account Event Body", "description": "Details about ACU Closed Account Event.", "required": [ "updated_date", "merchant", "cards_checked" ], "properties": { "updated_date": { "type": "string", "format": "date", "description": "The update date." }, "merchant": { "type": "object", "description": "Details about the merchant.", "properties": { "id": { "type": "integer", "description": "The ID of the merchant." }, "name": { "type": "string", "description": "The name of the merchant." } } }, "cards_checked": { "type": "object", "description": "Details about the cards checked.", "properties": { "customer_vault": { "type": "object", "description": "Details about the customer vault.", "properties": { "checked": { "type": "integer", "description": "The number of customer vaults checked." }, "updated": { "type": "integer", "description": "The number of customer vaults updated." } } }, "subscriptions": { "type": "object", "description": "Details about the subscriptions.", "properties": { "checked": { "type": "integer", "description": "The number of subscriptions checked." }, "updated": { "type": "integer", "description": "The number of subscriptions updated." } } } } }, "vault_count_updated_closed_account": { "type": "integer", "description": "The number of vaults updated for the closed account." }, "vault_updates": { "type": "array", "description": "Details about the vault updates.", "items": { "$ref": "#/components/schemas/AcuCustomerVaultDetails" } }, "recurring_count_updated_closed_account": { "type": "integer", "description": "The number of recurring payments updated for the closed account." }, "recurring_updates": { "type": "array", "description": "Details about the recurring payment updates.", "items": { "$ref": "#/components/schemas/AcuSubscriptionDetails" } } } }, "AcuContactCustomerEventBody": { "type": "object", "title": "ACU Contact Customer Event Body", "description": "Details about ACU Contact Customer Event.", "required": [ "updated_date", "merchant", "cards_checked" ], "properties": { "updated_date": { "type": "string", "format": "date", "description": "The date when the event was updated." }, "merchant": { "type": "object", "description": "Details about the merchant.", "required": [ "id", "name" ], "properties": { "id": { "type": "integer", "description": "The ID of the merchant." }, "name": { "type": "string", "description": "The name of the merchant." } } }, "cards_checked": { "type": "object", "description": "Details about the cards checked.", "required": [ "customer_vault", "subscriptions" ], "properties": { "customer_vault": { "type": "object", "description": "Details about the customer vault.", "required": [ "checked", "updated" ], "properties": { "checked": { "type": "integer", "description": "The number of customer vaults checked." }, "updated": { "type": "integer", "description": "The number of customer vaults updated." } } }, "subscriptions": { "type": "object", "description": "Details about the subscriptions.", "required": [ "checked", "updated" ], "properties": { "checked": { "type": "integer", "description": "The number of subscriptions checked." }, "updated": { "type": "integer", "description": "The number of subscriptions updated." } } } } }, "vault_count_updated_contact_customer": { "type": "integer", "description": "The number of vaults updated." }, "vault_updates": { "type": "array", "description": "Details about the vault updates.", "items": { "$ref": "#/components/schemas/AcuCustomerVaultDetails" } }, "recurring_count_updated_contact_customer": { "type": "integer", "description": "The number of recurring subscriptions updated." }, "recurring_updates": { "type": "array", "description": "Details about the recurring subscriptions updates.", "items": { "$ref": "#/components/schemas/AcuSubscriptionDetails" } } } } }, "parameters": { "ContentType": { "name": "Content-Type", "in": "header", "required": true, "schema": { "type": "string" }, "description": "The Content-Type representation header is used to indicate the original media type of the resource (prior to any content encoding applied for sending).", "example": "application/json" }, "Authorization": { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string" }, "description": "Your v4 API key that was generated in the Partner portal." }, "WebhookSignature": { "name": "Webhook-Signature", "in": "header", "required": true, "schema": { "type": "string" }, "description": "Signature to validate the webhook event." } } } true
Integration checks
Validate the request against its selected schema before submission. Keep secrets outside browser code. Test permitted and denied account access, validation failures and interrupted responses in the sandbox. Account-management or messaging operations require the corresponding partner access and intended recipient context.