# Visa Accept
Visa Accept provides bundled technology and program benefits for enablers offering small seller card acceptance. This solution allows providers to offer Visa Debit and Prepaid cardholders the ability to start accepting limited volumes of contactless card payments with their mobile device.
## Version: 1
### Servers
| URL | Description |
| --- | ----------- |
| https://sandbox.api.visa.com | Sandbox server |
---
## Visa Accept API
Provides a cost-effective, user-friendly payment acceptance solution, increasing Visa card acceptance, support for multiple payment methods, real-time funds settlement, and reduced dispute risks.
### [POST] /va/v1/apps/{appId}/sellers
**Enroll Seller**
Enrolls new sellers into the Visa Accept service. Supports new enrollments, adding cards to existing accounts, and reopening closed accounts.
#### Parameters
| Name | Located in | Description | Required | Schema | Explode |
| ---- | ---------- | ----------- | -------- | ------ | ------- |
| appId | path | application identifier, in UUID format | Yes | string | No |
#### Request Body
| Required | Schema |
| -------- | ------ |
| Yes | **application/json**: { **"locale"**: string, **"country"**: string, **"panData"**: { **"panId"**: string, **"accountNumber"**: string, **"expirationYear"**: string, **"expirationMonth"**: string, **"vProvisionTokenId"**: string }, **"customerId"**: string, **"enrollType"**: string,
**Available values:** "NEW", "ADD_NEW_CARD", "REOPEN", **"sellerNameTag"**: string }
|
#### Responses
| Code | Description | Schema |
| ---- | ----------- | ------ |
| 200 | Created | **application/json**: { **"status"**: string,
**Available values:** "ACTIVE", "PENDING", "SUSPENDED_FRAUD", "SUSPENDED_DISPUTE", "SUSPENDED_CLOSE", "CLOSED", **"sellerId"**: string, **"resetDate"**: dateTime, **"acceptTier"**: { **"id"**: string, **"name"**: string, **"region"**: string,
**Available values:** "US", "CA", "EURO", "AP", "LA", "CEMEA", **"country"**: string, **"mdrFees"**: [ { **"type"**: string,
**Available values:** "DOMESTIC", "CROSS_BORDER", **"feeConfigs"**: [ { **"fee"**: { **"type"**: string,
**Available values:** "DOMESTIC", "CROSS_BORDER", **"ceiling"**: integer, **"fixedFee"**: integer, **"maxFeeCap"**: number (BigDecimal), **"percentage"**: double, **"mdrMaxFeeCapEnabled"**: boolean }, **"card"**: string,
**Available values:** "VISA", "MASTERCARD", "AMEX", "DISCOVER", **"type"**: string,
**Available values:** "BASE_FEE", "APPLE_TAP_FEE", "BUYER_SIDE_FEE", **"threshold"**: number (int), **"thresholdFee"**: { **"type"**: string,
**Available values:** "DOMESTIC", "CROSS_BORDER", **"ceiling"**: integer, **"fixedFee"**: integer, **"maxFeeCap"**: number (BigDecimal), **"percentage"**: double, **"mdrMaxFeeCapEnabled"**: boolean }, **"walletProvider"**: string,
**Available values:** "APPLE_PAY", "GOOGLE_PAY", "SAMSUNG_PAY", "PAYPAL", **"refundFeeEnabled"**: boolean } ], **"buyerRegion"**: string,
**Available values:** "LAC", "APAC", "EMEA", "NA", "GLOBAL" or null, **"mdrMaxFeeCap"**: number (BigDecimal), **"mdrMaxFeeCapEnabled"**: boolean } ], **"currency"**: string, **"chargeCycle"**: string,
**Available values:** "Daily", "Weekly", "Monthly", "Yearly", "CalMonth", "CalYear", **"txnCountLimit"**: string, **"txnAmountLimit"**: string, **"refundExpiryDays"**: string, **"perTxnAmountLimit"**: string, **"fraudCountThreshold"**: string, **"fraudAmountThreshold"**: string, **"disputeCountThreshold"**: string, **"disputeAmountThreshold"**: string }, **"customerId"**: string, **"salesAmount"**: string,
**Available values:** "0.00", **"issuerConfig"**: { **"kybUrl"**: string (uri), **"tncUrl"**: string (uri) }, **"sellerNameTag"**: string, **"isRefundEnabled"**: boolean, **"txnCountRemaining"**: string, **"paymentInstruments"**: [ { **"panId"**: string, **"isPrimary"**: boolean, **"last4digits"**: string, **"axTokenStatus"**: string,
**Available values:** "ACTIVE", "INACTIVE", "SUSPENDED", "DELETED" } ], **"txnAmountRemaining"**: string, **"acceptTierStartDate"**: dateTime }
|
| 400 | Bad request | **application/json**: { **"reason"**: string, **"message"**: string, **"requestId"**: string, **"httpStatus"**: string, **"correlationId"**: string, **"errorMessages"**: [ { **"message"**: string, **"location"**: string } ] }
|
| 409 | Duplicated Seller enrollment | **application/json**: { **"reason"**: string, **"message"**: string, **"requestId"**: string, **"httpStatus"**: string, **"correlationId"**: string }
|
| 500 | Internal Server error | **application/json**: { **"reason"**: string, **"message"**: string, **"requestId"**: string, **"httpStatus"**: string, **"correlationId"**: string }
|
---
### Schemas
#### DetailResponse Schema
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| appId | string | Application identifier for the calling system. | No |
| items | [ { **"id"**: string, **"qty"**: integer, **"unitPrice"**: integer, **"description"**: string } ] | List of transaction line items with pricing details. | No |
| amount | integer | Transaction amount in minor currency units. | No |
| status | string | Transaction processing status indicating approval, decline or other status. | No |
| txnFee | integer | Fee amount charged for transaction processing. | No |
| currency | string | Three-digit ISO 4217 currency code. | No |
| sellerId | string | Seller profile - seller identifier, a 15 char-long alphanumeric string.
*Example:* `"vD4bq7RcOaZhTaz"` | No |
| payMethod | string | Payment method used for transaction processing. | No |
| receiptId | string | Unique identifier for the transaction receipt. | No |
| orderNumber | integer | Sequential order number for transaction tracking. | No |
| txnDatetime | dateTime | Timestamp when the transaction was processed. | No |
| vabsTransId | string | Visa Accept Service transaction identifier. | No |
| itemDescription | string | Description of the purchased item or service. | No |
| transactionType | string | Type of transaction operation being performed. | No |
| orderNumberIndex | integer | Order sequence index (displayed only for refund transactions).
*Example:* `1` | No |
| cardLastFourDigits | string | Last four digits of the payment card used in transaction. | No |
| relatedTransactions | [ { **"appId"**: string, **"items"**: [ { **"id"**: string, **"qty"**: integer, **"unitPrice"**: integer, **"description"**: string } ], **"amount"**: integer, **"linkId"**: string, **"status"**: string, **"txnFee"**: integer, **"linkUrl"**: string, **"currency"**: string, **"sellerId"**: string, **"payMethod"**: string, **"receiptId"**: string, **"orderNumber"**: integer, **"txnDatetime"**: dateTime, **"vabsTransId"**: string, **"itemDescription"**: string, **"linkValidBefore"**: string, **"transactionType"**: string, **"orderNumberIndex"**: integer, **"cardLastFourDigits"**: string, **"transactionInterface"**: string, **"originalTransactionId"**: string } ] | List of associated transactions such as refunds or adjustments. | No |
| transactionInterface | string | Interface method used for transaction processing. | No |
| availableToRefundUntil | dateTime | Expiration timestamp for refund eligibility window (displayed only for purchase transaction). | No |
| availableAmountToRefund | string | Remaining amount available for refund processing (displayed only for purchase transaction). | No |
#### SellerSearchCIDRequest Schema
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| customerId | string | Customer identifier for enrollment verification and duplicate checking.
*Example:* `"12345"` | Yes |
#### AcceptTier Schema
Seller acceptance tier configuration with fee structures and transaction limits details.
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| id | string | Unique identifier for the seller acceptance tier.
*Example:* `"1898923"` | No |
| name | string | Display name for the seller acceptance tier.
*Example:* `"BASIC"` | No |
| region | string,
**Available values:** "US", "CA", "EURO", "AP", "LA", "CEMEA" | Geographic region for seller acceptance tier configuration.
*Enum:* `"US"`, `"CA"`, `"EURO"`, `"AP"`, `"LA"`, `"CEMEA"` | No |
| country | string | Country code for seller acceptance tier configuration.
*Example:* `"USA"` | No |
| mdrFees | [ { **"type"**: string,
**Available values:** "DOMESTIC", "CROSS_BORDER", **"feeConfigs"**: [ { **"fee"**: { **"type"**: string,
**Available values:** "DOMESTIC", "CROSS_BORDER", **"ceiling"**: integer, **"fixedFee"**: integer, **"maxFeeCap"**: number (BigDecimal), **"percentage"**: double, **"mdrMaxFeeCapEnabled"**: boolean }, **"card"**: string,
**Available values:** "VISA", "MASTERCARD", "AMEX", "DISCOVER", **"type"**: string,
**Available values:** "BASE_FEE", "APPLE_TAP_FEE", "BUYER_SIDE_FEE", **"threshold"**: number (int), **"thresholdFee"**: { **"type"**: string,
**Available values:** "DOMESTIC", "CROSS_BORDER", **"ceiling"**: integer, **"fixedFee"**: integer, **"maxFeeCap"**: number (BigDecimal), **"percentage"**: double, **"mdrMaxFeeCapEnabled"**: boolean }, **"walletProvider"**: string,
**Available values:** "APPLE_PAY", "GOOGLE_PAY", "SAMSUNG_PAY", "PAYPAL", **"refundFeeEnabled"**: boolean } ], **"buyerRegion"**: string,
**Available values:** "LAC", "APAC", "EMEA", "NA", "GLOBAL" or null, **"mdrMaxFeeCap"**: number (BigDecimal), **"mdrMaxFeeCapEnabled"**: boolean } ] | List of seller discount rate fee structures by transaction type. | No |
| currency | string | Three-digit ISO 4217 currency code.
*Example:* `"USD"` | No |
| chargeCycle | string,
**Available values:** "Daily", "Weekly", "Monthly", "Yearly", "CalMonth", "CalYear" | Transaction limit reset frequency.
*Enum:* `"Daily"`, `"Weekly"`, `"Monthly"`, `"Yearly"`, `"CalMonth"`, `"CalYear"` | No |
| txnCountLimit | string | Maximum number of transactions allowed per billing cycle.
*Example:* `"100"` | No |
| txnAmountLimit | string | Maximum total transaction amount allowed per billing cycle.
*Example:* `"1000"` | No |
| refundExpiryDays | string | Number of days until refund eligibility expires.
*Example:* `"120"` | No |
| perTxnAmountLimit | string | Maximum amount limit per individual transaction.
*Example:* `"20"` | No |
| fraudCountThreshold | string | Maximum fraud count threshold for seller monitoring.
*Example:* `"5.0"` | No |
| fraudAmountThreshold | string | Maximum fraud amount threshold for seller monitoring.
*Example:* `"5.0"` | No |
| disputeCountThreshold | string | Maximum dispute count threshold for seller monitoring.
*Example:* `"5.0"` | No |
| disputeAmountThreshold | string | Maximum dispute amount threshold for seller monitoring.
*Example:* `"5.0"` | No |
#### SearchSellerProfileResponse Schema
seller profile, return when seller already enrolled.
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| status | string | Seller account status. Possible values: ACTIVE - SUSPENDED_FRAUD - SUSPENDED_DISPUTE - SUSPENDED_CLOSE - CLOSED - KYB_PENDING.
*Example:* `"ACTIVE"` | No |
| sellerId | string | Seller profile - seller identifier, a 15 char-long alphanumeric string.
*Example:* `"vD4bq7RcOaZhTaz"` | No |
| resetDate | string | Reset date for transaction limits and counters in the billing cycle. | No |
| acceptTier | { **"id"**: string, **"name"**: string, **"region"**: string,
**Available values:** "US", "CA", "EURO", "AP", "LA", "CEMEA", **"country"**: string, **"mdrFees"**: [ { **"type"**: string,
**Available values:** "DOMESTIC", "CROSS_BORDER", **"feeConfigs"**: [ { **"fee"**: { **"type"**: string,
**Available values:** "DOMESTIC", "CROSS_BORDER", **"ceiling"**: integer, **"fixedFee"**: integer, **"maxFeeCap"**: number (BigDecimal), **"percentage"**: double, **"mdrMaxFeeCapEnabled"**: boolean }, **"card"**: string,
**Available values:** "VISA", "MASTERCARD", "AMEX", "DISCOVER", **"type"**: string,
**Available values:** "BASE_FEE", "APPLE_TAP_FEE", "BUYER_SIDE_FEE", **"threshold"**: number (int), **"thresholdFee"**: { **"type"**: string,
**Available values:** "DOMESTIC", "CROSS_BORDER", **"ceiling"**: integer, **"fixedFee"**: integer, **"maxFeeCap"**: number (BigDecimal), **"percentage"**: double, **"mdrMaxFeeCapEnabled"**: boolean }, **"walletProvider"**: string,
**Available values:** "APPLE_PAY", "GOOGLE_PAY", "SAMSUNG_PAY", "PAYPAL", **"refundFeeEnabled"**: boolean } ], **"buyerRegion"**: string,
**Available values:** "LAC", "APAC", "EMEA", "NA", "GLOBAL" or null, **"mdrMaxFeeCap"**: number (BigDecimal), **"mdrMaxFeeCapEnabled"**: boolean } ], **"currency"**: string, **"chargeCycle"**: string,
**Available values:** "Daily", "Weekly", "Monthly", "Yearly", "CalMonth", "CalYear", **"txnCountLimit"**: string, **"txnAmountLimit"**: string, **"refundExpiryDays"**: string, **"perTxnAmountLimit"**: string, **"fraudCountThreshold"**: string, **"fraudAmountThreshold"**: string, **"disputeCountThreshold"**: string, **"disputeAmountThreshold"**: string } | Seller acceptance tier configuration with fee structures and transaction limits details. | No |
| customerId | string | Unique customer identifier from the calling application.
*Example:* `"ae5b5f7d-9188-2305-4720-1a835e8f4c01"` | No |
| salesAmount | string | Total sales amount processed by the seller within the charge cycle. | No |
| sellerNameTag | string | Merchant display name for customer-facing transactions.
*Example:* `"Mongo Store"` | No |
| isRefundEnabled | boolean | Indicates if refund flag enabled.
*Example:* `true` | No |
| txnCountRemaining | string | Remaining transaction count available in current billing cycle.
*Example:* `"9000.00"` | No |
| paymentInstruments | [ { **"panId"**: string, **"KYBValid"**: boolean, **"isPrimary"**: boolean, **"last4digits"**: string, **"axTokenStatus"**: string,
**Available values:** "ACTIVE", "INACTIVE", "SUSPENDED", "DELETED" } ] | List of enrolled payment cards and their status information. | No |
| suspendedCloseDate | string | Date when seller account was suspended for closure.
*Example:* `"2025-05-04T14:48:00Z"` | No |
| txnAmountRemaining | string | Remaining transaction amount available in current billing cycle.
*Example:* `"10000.00"` | No |
| acceptTierStartDate | string | Seller acceptance tier effective start date.
*Example:* `"2023-10-04T14:48:00Z"` | No |
#### ServiceKey Schema
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| keyFun | string,
**Available values:** "AUTHENTICITY", "KEY_AGREEMENT" | Cryptographic key function type for service operations.
*Enum:* `"AUTHENTICITY"`, `"KEY_AGREEMENT"`
*Example:* `"AUTHENTICITY"` | Yes |
| keyRef | { **"kid"**: string, **"use"**: string,
**Available values:** "sig", "enc" } | Cryptographic key reference information details. | Yes |
#### KeyRef Schema
Cryptographic key reference information details.
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| kid | string | Key identifier for cryptographic operations.
*Example:* `"bfcfe8e8"` | Yes |
| use | string,
**Available values:** "sig", "enc" | Cryptographic key usage designation.
*Enum:* `"sig"`, `"enc"`
*Example:* `"enc"` | Yes |
#### 409CodeResponse Schema
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| reason | string | Error code.
*Example:* `"VABSOBS_00008"` | No |
| message | string | Error message description.
*Example:* `"Seller Name Tag Conflict"` | No |
| requestId | string | Request identifier for the specific API call.
*Example:* `"1765866195358"` | No |
| httpStatus | string | HTTP status code for the error response.
*Example:* `"409"` | No |
| correlationId | string | Correlation identifier for tracking the error instance.
*Example:* `"1_1765866195_358_72_L9Q57X5V7_VABS-OBS-SERVICES"` | No |
#### DeviceInfo Schema
Device hardware and software information details.
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| model | string | Device model name.
*Example:* `"Pixel 2"` | Yes |
| osType | string | Device operating system type.
*Example:* `"Android"` | Yes |
| deviceId | string | Client device identifier (should be unique per application).
*Example:* `"2f883486-93e0-2e1d-3832-18c1bc273601"` | Yes |
| manufacturer | string | Device manufacturer name.
*Example:* `"Google"` | Yes |
#### DeviceCerts Schema
List of device certificate strings for cryptographic validation.
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| DeviceCerts | [ string ] | List of device certificate strings for cryptographic validation. | |
#### WalletSellerStatusRequest Schema
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| sellers | [ { **"sellerId"**: string, **"customerId"**: string, **"sellerStatus"**: string,
**Available values:** "ACTIVE", "SUSPENDED_FRAUD", "SUSPENDED_DISPUTE", "SUSPENDED_CLOSE", "CLOSED" } ] | | Yes |
#### TransactionLinkResponse Schema
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| id | string | Transaction identifier associated with the payment link. | No |
| linkUrl | string (uri) | Hosted payment URL for customer checkout. | No |
| linkExpiry | dateTime | Payment link expiration timestamp in ISO 8601 UTC format. | No |
#### IssuerSellerStatusRequest Schema
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| cards | [ { **"channel"**: string, **"kybValid"**: boolean, **"cardNumber"**: string, **"tncAccepted"**: boolean } ] | List of payment cards for issuer batch status updates. | Yes |
#### SellerEnrollRequest Schema
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| locale | string | Seller locale identifier (BCP‑47 format, e.g., en-US).
*Example:* `"en-US"` | Yes |
| country | string | Seller country code (e.g. USA).
*Example:* `"USA"` | Yes |
| panData | { **"panId"**: string, **"accountNumber"**: string, **"expirationYear"**: string, **"expirationMonth"**: string, **"vProvisionTokenId"**: string } | Payment card account number and expiration information details. | Yes |
| customerId | string | Unique customer identifier from client application.
*Example:* `"ae5b5f7d-9188-2305-4720-1a835e8f4c01"` | Yes |
| enrollType | string,
**Available values:** "NEW", "ADD_NEW_CARD", "REOPEN" | Seller enrollment action type. NEW (new seller enrollment), ADD_NEW_CARD (token provisioning only), REOPEN (reopen closed account).
*Enum:* `"NEW"`, `"ADD_NEW_CARD"`, `"REOPEN"`
*Example:* `"NEW"` | Yes |
| sellerNameTag | string | Merchant display name for customer-facing transactions.
*Example:* `"Mongo Store"` | Yes |
#### Device Schema
Seller device information and platform details.
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| deviceId | string | Unique identifier for the seller payment device.
*Example:* `"D-001"` | Yes |
| platform | string,
**Available values:** "Android", "iOS", "Other" | Device platform type for payment processing.
*Enum:* `"Android"`, `"iOS"`, `"Other"` | Yes |
#### TransactionProcessResponse Schema
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| id | string | Unique identifier for the processed transaction. | No |
| amount | { **"value"**: long, **"currency"**: string } | Transaction monetary value with currency specification details. | No |
| status | string,
**Available values:** "approved", "declined" | Transaction processing status indicating approval or decline.
*Enum:* `"approved"`, `"declined"` | No |
| cardPresent | boolean | Indicates if the card was present during the transaction. | No |
| approvalCode | string | Approval code for approved transactions. | No |
| responseCode | string | API response code indicating transaction processing result. | No |
| transactionType | string,
**Available values:** "payment", "refund" | Type of transaction operation being performed.
*Enum:* `"payment"`, `"refund"` | No |
| networkReferenceId | string | Acquirer or payment network reference identifier. | No |
#### CardEligibilityRequest Schema
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| cards | [ { **"id"**: string, **"cardNumber"**: string, **"vProvisionTokenId"**: string } ] | List of payment cards for eligibility verification. | No |
#### SellerEnrollPAN Schema
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| panId | string | Unique identifier for the payment card account.
*Example:* `"055a183f-5506-c09e-cc81-1cf039a50c01"` | No |
| isPrimary | boolean | Indicates if this payment instrument is the primary card for the seller.
*Example:* `true` | No |
| last4digits | string | Last four digits of the payment card number.
*Example:* `"7873"` | No |
| axTokenStatus | string,
**Available values:** "ACTIVE", "INACTIVE", "SUSPENDED", "DELETED" | Visa Accept token provisioning status for payment instrument.
*Enum:* `"ACTIVE"`, `"INACTIVE"`, `"SUSPENDED"`, `"DELETED"` | No |
#### Card Schema
Payment card brand for fee configuration.
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| id | string | Unique payment card identifier.
*Example:* `"12345"` | Yes |
| cardNumber | string | Payment card number for validation (conditional field - provide vProvisionTokenId if missing).
*Example:* `"x4444222211110000"` | Yes |
| vProvisionTokenId | string | Visa provisioning token identifier (conditional field - provide cardNumber if missing).
*Example:* `"8ba8e0a913f6bb2c809e1459cdefdd02"` | Yes |
#### CardData Schema
Raw payment card details for PAN-based transaction flows.
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| pan | string | Primary Account Number.
*Example:* `"4111111111111111"` | No |
| seqNum | string | Two-digit numeric value representing the card sequence number for the same Primary Account Number (PAN). Provide when available for PAN flows (e.g., magstripe/manual key entry). For EMV contact/contactless, this is typically present in EMV data (5F34) rather than in cardData.
*Example:* `"01"` | No |
| cryptogram | string | Payment cryptogram for wallet or 3DS authentication. Omit if not applicable.
*Example:* `""` | No |
| expiryYear | string | Payment card expiration year in YYYY format.
*Example:* `"2030"` | No |
| expiryMonth | string | Payment card expiration month in MM format.
*Example:* `"12"` | No |
| securityCode | string | Card verification value (CVV/CVC). Not used for EMV contact or contactless transactions.
*Example:* `"123"` | No |
#### BindDeviceRequest Schema
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| rebind | boolean | (Hybrid mode only) Indicates if the existing vacDeviceId should be overwritten.
*Example:* `true` | Yes |
| deviceInfo | { **"model"**: string, **"osType"**: string, **"deviceId"**: string, **"manufacturer"**: string } | Device hardware and software information details. | Yes |
| cryptographicKeys | { **"deviceCerts"**: [ string ], **"serviceKeys"**: [ { **"keyFun"**: string,
**Available values:** "AUTHENTICITY", "KEY_AGREEMENT", **"keyRef"**: { **"kid"**: string, **"use"**: string,
**Available values:** "sig", "enc" } } ] } | (Hybrid mode only) Cryptographic keys and certificates provided by KiC SDK. | Yes |
#### SellerUpdateRequest Schema
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| primaryPanId | string | Primary PAN identifier for the seller account.
*Example:* `"demoapp-card-1"` | No |
| sellerNameTag | string | Merchant display name for customer-facing transactions.
*Example:* `"Mongo Store"` | No |
#### Transaction Schema
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| id | string | Unique transaction identifier.
*Example:* `"ae5b5f7d-9188-2305-4720-1a835e8f4c01"` | No |
| type | string | Transaction classification. Possible values: Payment - Refund.
*Example:* `"purchase"` | No |
| items | [ { **"id"**: string, **"qty"**: integer, **"unitPrice"**: integer, **"description"**: string } ] | List of transaction line items with pricing details. | No |
| amount | string | Transaction monetary amount.
*Example:* `"100.00"` | No |
| status | string | Transaction processing status. Possible values: SUCCEED - FAILED.
*Example:* `"SUCCEED"` | No |
| txnFee | string | Fee amount charged for transaction processing.
*Example:* `"0.00"` | No |
| currency | string | Three-digit ISO 4217 transaction currency code.
*Example:* `"USD"` | No |
| sellerId | string | Seller profile - seller identifier, a 15 char-long alphanumeric string.
*Example:* `"vD4bq7RcOaZhTaz"` | No |
| payMethod | string | Payment method used for transaction processing.
*Example:* `"Contactless-Visa 1234"` | No |
| receiptId | string | Unique transaction receipt identifier.
*Example:* `"115b5f7d-9188-2305-8787-1a835e8f4c02"` | No |
| last4digits | string | Last four digits of the payment card number.
*Example:* `"4983"` | No |
| merchandise | string | Description of item or service for sale.
*Example:* `"Food"` | No |
| orderNumber | integer | Sequential order number (automatically incremented for each new transaction).
*Example:* `1` | No |
| txnDatetime | string | Transaction processing timestamp.
*Example:* `"1730106050"` | No |
| orderNumberIndex | integer | Order sequence index (displayed only for refund transactions).
*Example:* `1` | No |
#### PaymentMethod Schema
Payment method configuration object.
Provide either cardData (PAN flow) or tokenData (tokenized flow).
For card-not-present transactions with tokens: include tokenData with cryptogram and omit entryMode/emvTags/track2Equivalent.
For card-present contact/contactless: include emvTags object and do not send CVV in cardData.
For card-present magstripe: include track2Equivalent and expiry in cardData.
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| type | string,
**Available values:** "card", "token" | Payment credential type. Possible values: card - token.
*Enum:* `"card"`, `"token"` | Yes |
| brand | string,
**Available values:** "VISA", "MASTERCARD" | Payment card brand.
*Enum:* `"VISA"`, `"MASTERCARD"` | Yes |
| emvTags | object | EMV tag data for card-present transactions. Keys are EMV tag IDs (e.g., 9F02, 9F03, 9F26, 9F36, 95, 9C, 5F34). Values are tag data as uppercase hex strings, excluding TLV length bytes. Required for contact or contactless EMV transactions when cardPresent is true.
*Example:* `{"95":"8000008000","9C":"00","9F02":"000000025999","9F03":"000000000000","9F26":"A1B2C3D4E5F60700","9F36":"0030"}` | No |
| cardData | { **"pan"**: string, **"seqNum"**: string, **"cryptogram"**: string, **"expiryYear"**: string, **"expiryMonth"**: string, **"securityCode"**: string } | Raw payment card details for PAN-based transaction flows. | No |
| entryMode | string,
**Available values:** "contactless", "contact", "magstripe" | Card-present entry mode (use only when cardPresent is true).
*Enum:* `"contactless"`, `"contact"`, `"magstripe"` | No |
| tokenData | { **"token"**: string, **"tokenType"**: string,
**Available values:** "network", "device", **"cryptogram"**: string, **"expiryYear"**: string, **"expiryMonth"**: string } | Tokenized payment credential details for secure transaction processing. | No |
| cardPresent | boolean | Indicates if the card was present during the transaction. | Yes |
| track2Equivalent | string | Track 2 equivalent data for magstripe fallback processing.
*Example:* `""` | No |
#### SellerNameTagResponse Schema
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| available | boolean | Indicates whether the requested seller name tag is available for use.
*Example:* `false` | No |
| suggestions | [ string ] | List of available alternative seller name tag suggestions. | No |
| sellerNameTag | string | Merchant display name for customer-facing transactions.
*Example:* `"Mongo Store"` | No |
#### BadRequestResponse Schema
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| reason | string | Error code.
*Example:* `"VABSVC_00001"` | No |
| message | string | Error message description.
*Example:* `"Bad Request : Message Validation Failed"` | No |
| requestId | string | Request identifier for the specific API call.
*Example:* `"1765866195358"` | No |
| httpStatus | string | HTTP status code for the error response.
*Example:* `"400"` | No |
| correlationId | string | Correlation identifier for tracking the error instance.
*Example:* `"1_1765866195_358_72_L9Q57X5V7_VABS-OBS-SERVICES"` | No |
| errorMessages | [ { **"message"**: string, **"location"**: string } ] | List of error details. | No |
#### SellerSearchPAN Schema
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| panId | string | Unique identifier for the payment card account.
*Example:* `"898980809"` | No |
| KYBValid | boolean | Indicates if KYB is valid. | No |
| isPrimary | boolean | Indicates whether this is the primary payment instrument (true/false). | No |
| last4digits | string | Last four digits of the payment card number.
*Example:* `"7873"` | No |
| axTokenStatus | string,
**Available values:** "ACTIVE", "INACTIVE", "SUSPENDED", "DELETED" | Visa Accept token provisioning status for payment instrument.
*Enum:* `"ACTIVE"`, `"INACTIVE"`, `"SUSPENDED"`, `"DELETED"` | No |
#### FeeConfig Schema
MDR configuration
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| fee | { **"type"**: string,
**Available values:** "DOMESTIC", "CROSS_BORDER", **"ceiling"**: integer, **"fixedFee"**: integer, **"maxFeeCap"**: number (BigDecimal), **"percentage"**: double, **"mdrMaxFeeCapEnabled"**: boolean } | Seller discount rate configuration fee details. | No |
| card | string,
**Available values:** "VISA", "MASTERCARD", "AMEX", "DISCOVER" | *Enum:* `"VISA"`, `"MASTERCARD"`, `"AMEX"`, `"DISCOVER"`
*Example:* `"VISA"` | No |
| type | string,
**Available values:** "BASE_FEE", "APPLE_TAP_FEE", "BUYER_SIDE_FEE" | Fee configuration type classification.
*Enum:* `"BASE_FEE"`, `"APPLE_TAP_FEE"`, `"BUYER_SIDE_FEE"`
*Example:* `"BASE_FEE"` | No |
| threshold | number (int) | Transaction amount threshold for tiered fee calculation.
*Example:* `10` | No |
| thresholdFee | { **"type"**: string,
**Available values:** "DOMESTIC", "CROSS_BORDER", **"ceiling"**: integer, **"fixedFee"**: integer, **"maxFeeCap"**: number (BigDecimal), **"percentage"**: double, **"mdrMaxFeeCapEnabled"**: boolean } | Seller discount rate configuration fee details. | No |
| walletProvider | string,
**Available values:** "APPLE_PAY", "GOOGLE_PAY", "SAMSUNG_PAY", "PAYPAL" | Digital wallet provider for fee configuration.
*Enum:* `"APPLE_PAY"`, `"GOOGLE_PAY"`, `"SAMSUNG_PAY"`, `"PAYPAL"`
*Example:* `"APPLE_PAY"` | No |
| refundFeeEnabled | boolean | Indicates if refund processing fees are enabled.
*Example:* `true` | No |
#### EnrollDeviceResponse Schema
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| deviceId | string | Unique identifier assigned to the enrolled device.
*Example:* `"995b5f7d-9188-2305-4720-1a835e8d7"` | No |
| deviceKeys | [ { **"key"**: { **"kid"**: string }, **"keyFun"**: string,
**Available values:** "AUTHENTICITY" } ] | List of cryptographic keys assigned to the enrolled device. | No |
| vacDeviceId | string | Visa Accept Service device identifier.
*Example:* `"ae5b5f7d-9188-2305-4720-1a835e8f4c01"` | No |
#### TransactionResponse Schema
List of transaction records with processing details.
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| resetDate | string | Date when transaction limits and counters are reset.
*Example:* `"2024-08-11T12:45:33Z"` | No |
| salesAmount | string | Total sales amount processed by the seller within the charge cycle.
*Example:* `"1000.00"` | No |
| transactions | [ { **"id"**: string, **"type"**: string, **"items"**: [ { **"id"**: string, **"qty"**: integer, **"unitPrice"**: integer, **"description"**: string } ], **"amount"**: string, **"status"**: string, **"txnFee"**: string, **"currency"**: string, **"sellerId"**: string, **"payMethod"**: string, **"receiptId"**: string, **"last4digits"**: string, **"merchandise"**: string, **"orderNumber"**: integer, **"txnDatetime"**: string, **"orderNumberIndex"**: integer } ] | | No |
| LastTransaction | string | Timestamp of the most recent transaction processed.
*Example:* `"2024-04-11T12:00:00Z"` | No |
| txnCountRemaining | string | Remaining transaction count available in current billing cycle.
*Example:* `"9000.00"` | No |
| txnAmountRemaining | string | Remaining transaction amount available in current billing cycle.
*Example:* `"10000.00"` | No |
#### SellerId Schema
Seller profile - seller identifier, a 15 char-long alphanumeric string.
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| SellerId | string | Seller profile - seller identifier, a 15 char-long alphanumeric string. | |
**Example**
vD4bq7RcOaZhTaz
#### SellerNameTag Schema
Merchant display name for customer-facing transactions.
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| SellerNameTag | string | Merchant display name for customer-facing transactions. | |
**Example**
Mongo Store
#### WalletSellerStatusDto Schema
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| sellerId | string | Seller profile - seller identifier, a 15 char-long alphanumeric string.
*Example:* `"vD4bq7RcOaZhTaz"` | Yes |
| customerId | string | Customer identifier.
*Example:* `"a123456-t12345-67890-abcde"` | Yes |
| sellerStatus | string,
**Available values:** "ACTIVE", "SUSPENDED_FRAUD", "SUSPENDED_DISPUTE", "SUSPENDED_CLOSE", "CLOSED" | Seller account status
*Enum:* `"ACTIVE"`, `"SUSPENDED_FRAUD"`, `"SUSPENDED_DISPUTE"`, `"SUSPENDED_CLOSE"`, `"CLOSED"`
*Example:* `"ACTIVE"` | Yes |
#### ServiceKeys Schema
List of cryptographic service keys for device enrollment.
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| ServiceKeys | [ { **"keyFun"**: string,
**Available values:** "AUTHENTICITY", "KEY_AGREEMENT", **"keyRef"**: { **"kid"**: string, **"use"**: string,
**Available values:** "sig", "enc" } } ] | List of cryptographic service keys for device enrollment. | |
#### AppDetailsResponse Schema
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| appProperties | { **"mode"**: string,
**Available values:** "Api", "Hybrid", **"accountClosePeriod"**: integer } | Application configuration properties and settings details. | No |
#### PanData Schema
Payment card account number and expiration information details.
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| panId | string | Client-provided PAN identifier.
*Example:* `"055a183f-5506-c09e-cc81-1cf039a50c01"` | Yes |
| accountNumber | string | Primary account number for payment processing (conditional field - provide vProvisionTokenId if missing).
*Example:* `"x444111122223333"` | Yes |
| expirationYear | string | Payment card expiration year. format - YYYY
*Example:* `"2025"` | Yes |
| expirationMonth | string | Payment card expiration month. format - MM
*Example:* `"01"` | Yes |
| vProvisionTokenId | string | Visa provisioning token identifier (conditional field - provide accountNumber if missing).
*Example:* `"8ba8e0a913f6bb2c809e1459cdefdd02"` | Yes |
#### SellerProfileForEnrollResponse Schema
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| status | string,
**Available values:** "ACTIVE", "PENDING", "SUSPENDED_FRAUD", "SUSPENDED_DISPUTE", "SUSPENDED_CLOSE", "CLOSED" | Seller account status. Possible values: .
*Enum:* `"ACTIVE"`, `"PENDING"`, `"SUSPENDED_FRAUD"`, `"SUSPENDED_DISPUTE"`, `"SUSPENDED_CLOSE"`, `"CLOSED"`
*Example:* `"ACTIVE"` | No |
| sellerId | string | Seller profile - seller identifier, a 15 char-long alphanumeric string.
*Example:* `"vD4bq7RcOaZhTaz"` | No |
| resetDate | dateTime | Reset date for transaction limits and counters in the billing cycle. ISO8601, Format - YYYY-MM-DDTHH:MM:SSZ
*Example:* `"2024-08-11T12:45:33Z"` | No |
| acceptTier | { **"id"**: string, **"name"**: string, **"region"**: string,
**Available values:** "US", "CA", "EURO", "AP", "LA", "CEMEA", **"country"**: string, **"mdrFees"**: [ { **"type"**: string,
**Available values:** "DOMESTIC", "CROSS_BORDER", **"feeConfigs"**: [ { **"fee"**: { **"type"**: string,
**Available values:** "DOMESTIC", "CROSS_BORDER", **"ceiling"**: integer, **"fixedFee"**: integer, **"maxFeeCap"**: number (BigDecimal), **"percentage"**: double, **"mdrMaxFeeCapEnabled"**: boolean }, **"card"**: string,
**Available values:** "VISA", "MASTERCARD", "AMEX", "DISCOVER", **"type"**: string,
**Available values:** "BASE_FEE", "APPLE_TAP_FEE", "BUYER_SIDE_FEE", **"threshold"**: number (int), **"thresholdFee"**: { **"type"**: string,
**Available values:** "DOMESTIC", "CROSS_BORDER", **"ceiling"**: integer, **"fixedFee"**: integer, **"maxFeeCap"**: number (BigDecimal), **"percentage"**: double, **"mdrMaxFeeCapEnabled"**: boolean }, **"walletProvider"**: string,
**Available values:** "APPLE_PAY", "GOOGLE_PAY", "SAMSUNG_PAY", "PAYPAL", **"refundFeeEnabled"**: boolean } ], **"buyerRegion"**: string,
**Available values:** "LAC", "APAC", "EMEA", "NA", "GLOBAL" or null, **"mdrMaxFeeCap"**: number (BigDecimal), **"mdrMaxFeeCapEnabled"**: boolean } ], **"currency"**: string, **"chargeCycle"**: string,
**Available values:** "Daily", "Weekly", "Monthly", "Yearly", "CalMonth", "CalYear", **"txnCountLimit"**: string, **"txnAmountLimit"**: string, **"refundExpiryDays"**: string, **"perTxnAmountLimit"**: string, **"fraudCountThreshold"**: string, **"fraudAmountThreshold"**: string, **"disputeCountThreshold"**: string, **"disputeAmountThreshold"**: string } | Seller acceptance tier configuration with fee structures and transaction limits details. | No |
| customerId | string | Customer identifier.
*Example:* `"ae5b5f7d-9188-2305-4720-1a835e8f4c01"` | No |
| salesAmount | string,
**Available values:** "0.00" | Total sales amount processed by the seller within the charge cycle.
*Enum:* `"0.00"` | No |
| issuerConfig | { **"kybUrl"**: string (uri), **"tncUrl"**: string (uri) } | Issuer-specific configuration settings and URLs details. | No |
| sellerNameTag | string | Merchant display name for customer-facing transactions.
*Example:* `"Mongo Store"` | No |
| isRefundEnabled | boolean | Indicates if refund flag enabled.
*Example:* `true` | No |
| txnCountRemaining | string | Remaining transaction count available in current billing cycle. | No |
| paymentInstruments | [ { **"panId"**: string, **"isPrimary"**: boolean, **"last4digits"**: string, **"axTokenStatus"**: string,
**Available values:** "ACTIVE", "INACTIVE", "SUSPENDED", "DELETED" } ] | List of enrolled payment cards and their status information. | No |
| txnAmountRemaining | string | Remaining transaction amount available in current billing cycle. | No |
| acceptTierStartDate | dateTime | Effective start date for the seller acceptance tier configuration. ISO8601, Format - YYYY-MM-DDTHH:MM:SSZ
*Example:* `"2023-10-04T14:48:00Z"` | No |
#### Fee Schema
Seller discount rate configuration fee details.
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| type | string,
**Available values:** "DOMESTIC", "CROSS_BORDER" | Seller discount rate classification. Possible values: DOMESTIC - CROSS_BORDER.
*Enum:* `"DOMESTIC"`, `"CROSS_BORDER"`
*Example:* `"DOMESTIC"` | No |
| ceiling | integer | Maximum fee amount cap for transaction processing.
*Example:* `10` | No |
| fixedFee | integer | Fixed fee amount for cross-border transaction processing.
*Example:* `10` | No |
| maxFeeCap | number (BigDecimal) | Maximum fee percentage cap for transaction processing.
*Example:* `1.1` | No |
| percentage | double | Fee percentage rate for transaction processing.
*Example:* `0.025` | No |
| mdrMaxFeeCapEnabled | boolean | Indicates if seller discount rate fee cap is enabled.
*Example:* `true` | No |
#### Amount Schema
Transaction monetary value with currency specification details.
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| value | long | Transaction amount in minor currency units (e.g. cents for USD).
*Example:* `2599` | Yes |
| currency | string | Three-digit ISO 4217 currency code.
*Example:* `"840"` | Yes |
#### TransactionDetails Schema
Transaction metadata and reference information details.
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| description | string | Item or transaction description for customer reference.
*Example:* `"fruits "` | No |
| referenceId | string | Seller-provided transaction reference identifier.
*Example:* `"WEB-3007"` | Yes |
| originalTransactionId | string | Original transaction identifier (required for refund processing).
*Example:* `""` | No |
#### ErrorResponse Schema
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| reason | string | Error code.
*Example:* `"VABSVC_00002"` | No |
| message | string | Error message description.
*Example:* `"Please contact technical support team."` | No |
| requestId | string | Request identifier for the specific API call.
*Example:* `"1765866195358"` | No |
| httpStatus | string | HTTP status code for the error response.
*Example:* `"500"` | No |
| correlationId | string | Correlation identifier for tracking the error instance.
*Example:* `"1_1765866195_358_72_L9Q57X5V7_VABS-OBS-SERVICES"` | No |
#### CombinedDevice Schema
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| vacDeviceId | string | vac deviceId, only for hybrid mode
*Example:* `"ae5b5f7d-9188-2305-4720-1a835e8f4c01"` | No |
#### TransactionProcessRequest Schema
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| amount | { **"value"**: long, **"currency"**: string } | Transaction monetary value with currency specification details. | Yes |
| device | { **"deviceId"**: string, **"platform"**: string,
**Available values:** "Android", "iOS", "Other" } | Seller device information and platform details. | Yes |
| paymentMethod | { **"type"**: string,
**Available values:** "card", "token", **"brand"**: string,
**Available values:** "VISA", "MASTERCARD", **"emvTags"**: object, **"cardData"**: { **"pan"**: string, **"seqNum"**: string, **"cryptogram"**: string, **"expiryYear"**: string, **"expiryMonth"**: string, **"securityCode"**: string }, **"entryMode"**: string,
**Available values:** "contactless", "contact", "magstripe", **"tokenData"**: { **"token"**: string, **"tokenType"**: string,
**Available values:** "network", "device", **"cryptogram"**: string, **"expiryYear"**: string, **"expiryMonth"**: string }, **"cardPresent"**: boolean, **"track2Equivalent"**: string } | Payment method configuration object. Provide either cardData (PAN flow) or tokenData (tokenized flow). For card-not-present transactions with tokens: include tokenData with cryptogram and omit entryMode/emvTags/track2Equivalent. For card-present contact/contactless: include emvTags object and do not send CVV in cardData. For card-present magstripe: include track2Equivalent and expiry in cardData. | Yes |
| transactionType | string,
**Available values:** "payment", "refund" | Transaction operation type.
*Enum:* `"payment"`, `"refund"` | Yes |
| transactionDetails | { **"description"**: string, **"referenceId"**: string, **"originalTransactionId"**: string } | Transaction metadata and reference information details. | Yes |
#### TransactionLinkRequest Schema
Request to create a hosted payment link. Similar to TransactionRequest but excludes paymentMethod. The payer will provide credentials at the hosted page.
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| amount | { **"value"**: long, **"currency"**: string } | Transaction monetary value with currency specification details. | Yes |
| device | { **"deviceId"**: string, **"platform"**: string,
**Available values:** "Android", "iOS", "Other" } | Seller device information and platform details. | Yes |
| transactionType | string,
**Available values:** "payment", "refund" | Transaction type for payment link processing.
*Enum:* `"payment"`, `"refund"` | Yes |
| transactionDetails | { **"description"**: string, **"referenceId"**: string, **"originalTransactionId"**: string } | Transaction metadata and reference information details. | Yes |
#### CryptographicKeys Schema
(Hybrid mode only) Cryptographic keys and certificates provided by KiC SDK.
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| deviceCerts | [ string ] | List of device certificate strings for cryptographic validation. | Yes |
| serviceKeys | [ { **"keyFun"**: string,
**Available values:** "AUTHENTICITY", "KEY_AGREEMENT", **"keyRef"**: { **"kid"**: string, **"use"**: string,
**Available values:** "sig", "enc" } } ] | List of cryptographic service keys for device enrollment. | Yes |
#### TokenData Schema
Tokenized payment credential details for secure transaction processing.
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| token | string | Network or device token identifier (may be masked for security).
*Example:* `"489537******1234"` | Yes |
| tokenType | string,
**Available values:** "network", "device" | Type of payment token used for transaction processing.
*Enum:* `"network"`, `"device"` | Yes |
| cryptogram | string | Wallet or 3DS cryptogram for tokenized payments.
*Example:* `"AgAAAAAABk4DWZ4C28rQAAAAAAA="` | Yes |
| expiryYear | string | Payment card expiration year in YYYY format.
*Example:* `"2030"` | Yes |
| expiryMonth | string | Payment card expiration month in MM format.
*Example:* `"12"` | Yes |
#### WalletPaymentStatusRequest Schema
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| sellerId | string | Seller profile - seller identifier, a 15 char-long alphanumeric string.
*Example:* `"vD4bq7RcOaZhTaz"` | Yes |
| customerId | string | Customer identifier.
*Example:* `"a123456-t12345-67890-abcde"` | Yes |
| transactionId | string | Unique transaction identifier.
*Example:* `"txn23456-t12345-67890-abcde"` | Yes |
| transactionStatus | string,
**Available values:** "SUCCESS", "FAIL" | Transaction processing status.
*Enum:* `"SUCCESS"`, `"FAIL"`
*Example:* `"SUCCESS"` | Yes |
#### DeviceKey Schema
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| key | { **"kid"**: string } | Cryptographic key information and metadata details. | No |
| keyFun | string,
**Available values:** "AUTHENTICITY" | Cryptographic key function type for device security.
*Enum:* `"AUTHENTICITY"` | No |
#### SellerSearchSIDRequest Schema
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| sellerId | string | Seller profile - seller identifier, a 15 char-long alphanumeric string.
*Example:* `"vD4bq7RcOaZhTaz"` | Yes |
#### CardEligibilityResponse Schema
| Name | Type | Description | Required |
| ---- | ---- | ----------- | -------- |
| validCards | [ { **"id"**: string, **"cardNumber"**: string, **"vProvisionTokenId"**: string } ] | List of valid payment cards (empty if no valid cards found). | No |