openapi: 3.0.1
info:
title: Foreign Exchange Rates Buyer Management Service API
description: The Buyer Service provides self-service capabilities that simplify and reduce the implementation process for new VPA buyers (and other downstream systems). Buyers can be created from scratch or from a pre-defined Buyer Template. Either way, these APIs help streamline the process and increase the speed of buyer deployments, as well as provide third parties with insight into the buyers configurations for troubleshooting. For more details about the requirements for creating a buyer, please reference the Buyer Setup Details page.
version: '1'
servers:
- url: https://sandbox.api.visa.com
description: Sandbox server
security: []
tags:
- name: Buyer Management Service
description: The Buyer Service provides self-service capabilities that simplify and reduce the implementation process for new VPA buyers (and other downstream systems). Buyers can be created from scratch or from a pre-defined Buyer Template. Either way, these APIs help streamline the process and increase the speed of buyer deployments, as well as provide third parties with insight into the buyers configurations for troubleshooting. For more details about the requirements for creating a buyer, please reference the Buyer Setup Details page.
paths:
/vpa/v2/buyerManagement/buyerTemplate/get:
post:
tags:
- Buyer Management Service
summary: Get Buyer Template
description: Obtain all current parameters for an existing buyer template. Optional and default values will be provided as well as the ability to obtain a full picture of the buyer configurations. This is helpful for troubleshooting or to see the details of a template before many any changes to it.
operationId: Get Buyer Template V2
requestBody:
description: Request Details for getting the details of a Buyer template.
content:
application/json:
schema:
$ref: '#/components/schemas/GetBuyerTemplateRequest'
examples:
Default:
summary: Default
value:
clientId: B2BWS_1_Region_Bank_9999
messageId: '107970185555'
templateId: '1_3_9999_811'
required: true
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/GetBuyerTemplateSuccessResponseV2'
examples:
Default:
summary: Default
value:
responseObject:
responseFileConfig: null
proxyConfig:
holdDays: '30'
bucketedProxyEnabled: false
autoRefreshEnabled: true
boostPaymentConfig:
boostPaymentEnabled: false
contactInfo:
implementationType: 2
emailAddress: nigandhe@visa.com
phone1: '99999977'
buyerFeatureConfig:
fullAccountViewEnabled: true
cardMaskingDigitsOnline: '12'
vcfDataFeedIndicator: Y
onlinePaymentInstructionEnabled: true
onlinePaymentRequisitionEnabled: true
cardMaskingDigits: '7'
pseudoAccountsEnabled: false
rvaReconciliationFileConfig: null
billingConfig:
billingType: I
billingBID: '10048816840'
stripePaymentConfig:
remittanceNotificationEnabled: true
stripePaymentEnabled: true
vanConfig:
fcsBankId: F286
vanEnabled: true
stpPaymentConfig:
remittanceNotificationEnabled: true
stpPaymentEnabled: true
webServicesConfig:
apiCodes: null
webServicesEnabled: false
clientId: null
suppressSupplierNotification: null
vbdsClientId: null
templateId: '1_3_9999_811'
paymentConfig:
securityCodeRequired: true
allowableCurrencies:
- USD
expirationDays: '30'
billingCurrency: USD
expirationBufferDays: '5'
paymentAdviceOption: C
paymentFileCommConfig: null
paymentSecurityConfig:
defaultSecurityFieldCode: '1'
defaultSecurityQuestion: Credential Text
customSecurityQuestions:
- What is Security answer?
- What is SSN Number?
customSecurityQuestionsEnabled: true
approvalWorkflowConfig:
workflowFunctionCodes:
- AUCL
- PYIN
workflowConfigEnabled: true
authorizationControlConfig:
issuerHoldingBID: '10000290'
authControlEnabled: true
alertsEnabled: true
paymentNotificationConfig:
defaultBuyerLanguageCode: en_US
supplierReminderNotificationDays: '12'
dateFormat: MMDDYYYY
supplierReminderNotificationEnabled: true
attachRemittanceFileDetails: true
templateName: VPP-APITemplate-vcfInd-Null23
templateDescription: VPP-APITemplate-vcfInd-Null23_Updated
reconciliationFileConfig:
adhocReconciliationReportEnabled: false
commFileId: null
templateName: null
onlinePaymentReconciliationEnabled: false
processorConfig:
closeAccount: true
responseStatus:
statusDesc: Buyer template details retrieved successfully.
messageId: '107970185555'
status: success
statusCode: BSGT0000
'400':
description: Refer to the Error Codes page for the list of error codes for this API.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
x-samplePayload: ''
x-codegen-request-body-name: templateRequest
x-operationVersions:
- label: v1
operationPointer: '#/paths/~1vpa~1v1~1buyerManagement~1buyerTemplate~1get/post'
default: false
- label: v2 - Latest
operationPointer: '#/paths/~1vpa~1v2~1buyerManagement~1buyerTemplate~1get/post'
default: false
x-hideTryIt: true
/vpa/v1/buyerManagement/buyer/get:
post:
tags:
- Buyer Management Service
summary: Get Buyer Details
description: ''
operationId: Get Buyer Details
requestBody:
description: Parameters required to retrieve a Buyer
content:
application/json:
schema:
$ref: '#/components/schemas/GetBuyerRequest'
examples:
Default:
summary: Default
value:
clientId: B2BWS_1_1_1111
messageId: '107970184447'
buyerId: '200031032'
required: true
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/GetBuyerSuccessResponse'
examples:
Default:
summary: Default
value:
responseObject:
responseFileConfig:
fileLevel: null
recipientLoginIds: null
commFileId: null
fileFormat: null
proxyConfig:
holdDays: '180'
bucketedProxyEnabled: false
autoRefreshEnabled: false
boostPaymentConfig:
boostPaymentEnabled: false
contactInfo:
zipCode: '78750'
phone1Ext: null
city: Austin
contactName: VisaCompany
phone2Ext: null
phone3Ext: null
phone2: null
phone3: null
buyerId: '200031032'
buyerName: '2000131032'
templateId: null
phone1: '1234567890'
implementationType: 2
companyId: '2000131032'
emailAddress: visab2bvpaqa1@visa.com
countryCode: USA
addressLine1: addr1
addressLine2: null
state: TX
addressLine3: null
buyerFeatureConfig:
fullAccountViewEnabled: false
cardMaskingDigitsOnline: '12'
vcfDataFeedIndicator: Y
onlinePaymentInstructionEnabled: true
onlinePaymentRequisitionEnabled: true
cardMaskingDigits: '4'
pseudoAccountsEnabled: false
rvaReconciliationFileConfig:
fileLevel: ''
recipientLoginIds: []
commFileId: ''
deliveryTime: ''
deliveryFrequency: null
templateId: ''
fileFormat: null
paymentFileConfig:
edi824FileId: null
edi997FileId: null
inboundFileId: null
billingConfig:
billingType: I
billingBID: '10048816840'
stripePaymentConfig:
remittanceNotificationEnabled: false
stripePaymentEnabled: false
vanConfig:
fcsBankId: null
processingType: null
aceClientId: null
admClientId: null
visaADMOptionId: null
mcADMOptionId: null
vanEnabled: false
settlementExpirationDays: null
stpPaymentConfig:
accountHolderFirstName: null
remittanceNotificationEnabled: false
stpPaymentEnabled: false
accountHolderLastName: null
webServicesConfig:
apiCodes: null
webServicesEnabled: false
clientId: null
suppressSupplierNotification: false
vbdsClientId: ''
paymentConfig:
securityCodeRequired: true
allowableCurrencies:
- INR
- USD
expirationDays: '25'
billingCurrency: USD
expirationBufferDays: '5'
defaultSecurityCode: true
paymentAdviceOption: C
paymentSecurityConfig:
defaultSecurityFieldCode: '1'
defaultSecurityQuestion: Credential Text
customSecurityQuestions: []
customSecurityQuestionsEnabled: false
approvalWorkflowConfig:
workflowFunctionCodes: []
workflowConfigEnabled: false
authorizationControlConfig:
authControlPaymentTemplate: Custom_Standard
issuerHoldingBID: ''
authControlEnabled: false
defaultAuthControlEnabled: false
alertsEnabled: false
paymentNotificationConfig:
defaultBuyerLanguageCode: en_US
supplierReminderNotificationDays: '7'
paymentAdviceTemplate: Custom_Standard
settlementSource: '1'
dateFormat: DDMMYYYY
defaultSupplierReminderNotificationEnabled: true
defaultAttachRemittanceDetailsFile: true
supplierReminderNotificationEnabled: true
attachRemittanceDetailsFile: true
reconciliationFileConfig:
fileLevel: ''
recipientLoginIds: []
adhocReconciliationReportEnabled: false
commFileId: ''
deliveryTime: ''
templateName: null
deliveryFrequency: null
onlinePaymentReconciliationEnabled: false
fileFormat: null
processorConfig:
embossedLine2: '<> '
closeAccountEnabled: true
processorFields:
aceOptionSet: '1111'
accountIdOptionSet: '1111'
mailerIdOptionSet: '1111'
companyNumber: '1111111'
cycleFrequencyCode: '15'
cmidDefaultValue: ''
unitId: '1000000'
agentNumber: '0000'
cycleFrequencyType: Monthly
suaEmbossedLine1: <>~1
lodgedEmbossedLine1: <>~1
responseStatus:
statusDesc: Successfully retrieved the buyer
messageId: '1686861552'
status: success
statusCode: BSGB0000
'400':
description: Refer to the Error Codes page for the list of error codes for this API.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
x-samplePayload: ''
x-codegen-request-body-name: body
x-operationVersions:
- label: v1
operationPointer: '#/paths/~1vpa~1v1~1buyerManagement~1buyer~1get/post'
default: false
- label: v2 - Latest
operationPointer: '#/paths/~1vpa~1v2~1buyerManagement~1buyer~1get/post'
default: false
x-hideTryIt: true
/vpa/v1/buyerManagement/buyerTemplate/create:
post:
tags:
- Buyer Management Service
summary: Create Buyer Template
description: ''
operationId: Create Buyer Template
requestBody:
description: Details of the Template
content:
application/json:
schema:
$ref: '#/components/schemas/CreateBuyerTemplateRequest'
examples:
Default:
summary: Default
value:
responseFileConfig: null
proxyConfig:
holdDays: 2
bucketedProxyEnabled: false
autoRefreshEnabled: false
clientId: B2BWS_1_2_3029
boostPaymentConfig:
boostPaymentEnabled: false
contactInfo: null
buyerFeatureConfig: null
rvaReconciliationFileConfig: null
stripePaymentConfig:
remittanceNotificationEnabled: null
stripePaymentEnabled: false
messageId: '1579603814600'
vanConfig: null
stpPaymentConfig:
remittanceNotificationEnabled: false
stpPaymentEnabled: false
webServicesConfig: null
paymentConfig:
securityCodeRequired: false
allowableCurrencies:
- USD
expirationDays: 30
billingCurrency: USD
expirationBufferDays: 5
paymentAdviceOption: C
paymentFileCommConfig: null
paymentSecurityConfig:
defaultSecurityFieldCode: 1
defaultSecurityQuestion: Credential Text
customSecurityQuestions: null
customSecurityQuestionsEnabled: false
approvalWorkflowConfig:
workflowFunctionCodes:
- AUCL
- LCRC
- PYIN
- PYRN
workflowConfigEnabled: true
authorizationControlConfig:
issuerHoldingBID: '10029012'
authControlEnabled: true
alertsEnabled: false
paymentNotificationConfig:
defaultBuyerLanguageCode: en_US
supplierReminderNotificationDays: 7
dateFormat: DDMMYYYY
supplierReminderNotificationEnabled: true
attachRemittanceFileDetails: false
templateName: '1579603814600'
templateDescription: VPP Template
reconciliationFileConfig: null
processorConfig:
closeAccount: null
required: true
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/CreateBuyerTemplateSuccessResponse'
examples:
Default:
summary: Default
value:
templateId: '1_2_3029_50'
'400':
description: Refer to the Error Codes page for the list of error codes for this API.
content:
application/json:
schema:
$ref: '#/components/schemas/BErrorResponse'
x-samplePayload: ''
x-codegen-request-body-name: template
x-operationVersions:
- label: v1
operationPointer: '#/paths/~1vpa~1v1~1buyerManagement~1buyerTemplate~1create/post'
default: false
x-hideTryIt: true
/vpa/v1/buyerManagement/buyerTemplate/update:
patch:
tags:
- Buyer Management Service
summary: Update Buyer Template
description: ''
operationId: Update Buyer Template
requestBody:
description: Details of the values in the Template to be updated
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateBuyerTemplateRequest'
examples:
Default:
summary: Default
value:
proxyConfig: ''
clientId: B2BWS_1_Region_Bank_19401
boostPaymentConfig: ''
contactInfo: ''
buyerFeatureConfig: ''
stripePaymentConfig: ''
messageId: '1579804800637'
vanConfig: ''
stpPaymentConfig: ''
webServicesConfig: ''
templateId: '1_1_1940_81'
syncBuyerProfiles: true
paymentConfig: ''
paymentSecurityConfig: ''
approvalWorkflowConfig: ''
authorizationControlConfig:
issuerHoldingBID: '12345678'
authControlEnabled: true
alertsEnabled: ''
paymentNotificationConfig: ''
templateName: '1579804800637'
templateDescription: This ise first test template
reconciliationFileConfig: ''
processorConfig: ''
required: true
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateBuyerTemplateSuccessResponse'
examples:
Default:
summary: Default
value:
templateId: '1_1_1940_81'
'400':
description: Refer to the Error Codes page for the list of error codes for this API.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
x-samplePayload: ''
x-codegen-request-body-name: template
x-operationVersions:
- label: v1
operationPointer: '#/paths/~1vpa~1v1~1buyerManagement~1buyerTemplate~1update/patch'
default: false
x-hideTryIt: true
/vpa/v1/buyerManagement/buyer/update:
patch:
tags:
- Buyer Management Service
summary: Update Buyer
description: ''
operationId: Update Buyer
requestBody:
description: Profile Details of the buyer that needs to be updated.
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateBuyerRequest-1'
examples:
Default:
summary: Default
value:
proxyConfig:
holdDays: 3
bucketedProxyEnabled: false
autoRefreshEnabled: false
clientId: B2BWS_1_1_1111
boostPaymentConfig:
boostPaymentEnabled: false
contactInfo:
zipCode: '78759'
phoneExt3: ''
city: Austin
contactName: VisaCompany
phone2: ''
phone3: ''
defaultCurrencyCode: USD
buyerId: '151785'
buyerName: TestPaymentFile
templateId: '1988'
phone1: '8888888888'
companyId: '151785'
emailAddress: visab2bvpaqa1@visa.com
countryCode: USA
addressLine1: 12301ResearchBlvd23
phoneExt1: ''
addressLine2: Build#33
state: TX
phoneExt2: ''
addressLine3: 4thfloor
buyerFeatureConfig:
fullAccountViewEnabled: false
cardMaskingDigitsOnline: 12
onlinePaymentInstructionEnabled: false
onlinePaymentRequisitionEnabled: false
cardMaskingDigits: 12
pseudoAccountsEnabled: false
stripePaymentConfig:
remittanceNotificationEnabled: false
stripePaymentEnabled: false
messageId: '1579589087445'
vanConfig:
processingType: '1'
admClientId: '1234'
mcADMOptionId: '12345'
vanEnabled: false
stpPaymentConfig:
accountHolderFirstName: Visa
remittanceNotificationEnabled: false
stpPaymentEnabled: false
accountHolderLastName: Card
webServicesConfig:
apiCodes:
- SMGS
webServicesEnabled: true
clientId: B2BWS_1_1_1111
vbdsDataSubscription:
- dataSubscriptionType: 5001
dataSubscriptionAccountType:
- subscribed: true
accountType: MEMO
- subscribed: true
accountType: NVPA
suppressSupplierNotification: false
vbdsClientId: '12345'
paymentConfig:
securityCodeRequired: false
allowableCurrencies:
- USD
expirationDays: 30
billingCurrency: USD
expirationBufferDays: 5
paymentAdviceOption: C
paymentSecurityConfig:
defaultSecurityFieldCode: 1
defaultSecurityQuestion: ''
customSecurityQuestions:
- birthday
customSecurityQuestionsEnabled: true
approvalWorkflowConfig:
workflowFunctionCodes:
- AUCL
- PYRN
- LCRC
- PYIN
workflowConfigEnabled: true
authorizationControlConfig:
authControlEnabled: true
alertsEnabled: false
paymentNotificationConfig:
supplierReminderNotificationDays: 2
dateFormat: DDMMYYYY
attachRemittanceDetails: false
supplierReminderNotificationEnabled: true
defaultLanguageCode: en_us
processorConfig:
processorFields:
aceOptionSet: 34d2
corporationId: 2r
bin: sd2
cmidDefaultValue: 245d3534
agentNumber: '3453'
principalNumber: '66'
accountIDOptionSet: '3482'
companyNumber: '12344'
authorizationStrategyCode: hh66
pricingStrategy: 66hh
unitId: prop1
mapId: 66hh
processType: 09
productCodes: sdjssd
user4Code: 345u
hierarchyNode: s3
plasticCode: '9866'
required: true
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateBuyerSuccessResponse'
examples:
Default:
summary: Default
value:
responseStatus:
statusDesc: Successfully updated the buyer
messageId: '1686772964'
status: success
statusCode: BSUB0000
'400':
description: Refer to the Error Codes page for the list of error codes for this API.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
x-samplePayload: ''
x-codegen-request-body-name: body
x-operationVersions:
- label: v1
operationPointer: '#/paths/~1vpa~1v1~1buyerManagement~1buyer~1update/patch'
default: false
x-hideTryIt: true
/vpa/v1/buyerManagement/buyer/create:
post:
tags:
- Buyer Management Service
summary: Create Buyer
description: ''
operationId: Create Buyer
requestBody:
description: Buyer object that needs to be created
content:
application/json:
schema:
$ref: '#/components/schemas/CreateBuyerRequest-3'
examples:
Default:
summary: Default
value:
proxyConfig:
holdDays: 3
bucketedProxyEnabled: false
autoRefreshEnabled: false
clientId: B2BWS_1_1_1111
boostPaymentConfig:
boostPaymentEnabled: false
contactInfo:
zipCode: '78759'
phoneExt3: ''
city: Austin
contactName: VisaCompany
phone2: ''
phone3: ''
defaultCurrencyCode: USD
buyerId: '8887773'
buyerName: TestPaymentFileLijie14
phone1: '8888888888'
companyId: '8887773'
emailAddress: visab2bvpaqa1@visa.com
countryCode: USA
addressLine1: 12301 ResearchBlvd23
phoneExt1: ''
addressLine2: Build#33
state: TX
phoneExt2: ''
addressLine3: 4th floor
buyerFeatureConfig:
fullAccountViewEnabled: false
cardMaskingDigitsOnline: 12
onlinePaymentInstructionEnabled: false
onlinePaymentRequisitionEnabled: false
cardMaskingDigits: 12
pseudoAccountsEnabled: false
paymentFileConfig:
inboundFileId: '700147'
stripePaymentConfig:
remittanceNotificationEnabled: false
stripePaymentEnabled: false
messageId: '1579589087445'
stpPaymentConfig:
accountHolderFirstName: Visa
remittanceNotificationEnabled: false
stpPaymentEnabled: false
accountHolderLastName: Card
webServicesConfig:
apiCodes:
- SMGS
webServicesEnabled: true
clientId: B2BWS_1_1_1111
vbdsDataSubscription:
- dataSubscriptionType: 5001
dataSubscriptionAccountType:
- subscribed: true
accountType: MEMO
- subscribed: true
accountType: NVPA
suppressSupplierNotification: false
vbdsClientId: '12345'
paymentConfig:
securityCodeRequired: false
allowableCurrencies:
- USD
expirationDays: 30
billingCurrency: USD
expirationBufferDays: 5
paymentAdviceOption: C
paymentSecurityConfig:
defaultSecurityFieldCode: 1
customSecurityQuestions:
- birthday
customSecurityQuestionsEnabled: true
approvalWorkflowConfig:
workflowFunctionCodes:
- AUCL
workflowConfigEnabled: true
authorizationControlConfig:
issuerHoldingBID: '12345678'
authControlEnabled: true
alertsEnabled: false
paymentNotificationConfig:
supplierReminderNotificationDays: 2
dateFormat: DDMMYYYY
attachRemittanceDetails: false
supplierReminderNotificationEnabled: true
defaultLanguageCode: en_us
reconciliationFileConfig:
fileLevel: B
commFileId: '700144'
processorConfig:
processorFields:
aceOptionSet: 34d2
subProductCode: REG
corporationId: 2r
cycleFrequencyCode: '5'
bin: sd2
hierarchyLevel: '2'
cmidDefaultValue: 245d3534
agentNumber: '3453'
principalNumber: '66'
productCode: VPU
accountIDOptionSet: '3482'
companyNumber: '12344'
cycleFrequency: Bi-weekly
authorizationStrategyCode: hh66
pricingStrategy: 66hh
unitId: prop1
mapId: 66hh
processType: 09
user4Code: 345u
hierarchyNode: s3
plasticCode: '9866'
required: true
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/CreateBuyerSuccessResponse'
examples:
Default:
summary: Default
value:
responseStatus:
statusDesc: Successfully created the buyer
messageId: '1686772964'
status: success
statusCode: BSUB0000
'400':
description: Refer to the Error Codes page for the list of error codes for this API.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
x-samplePayload: ''
x-codegen-request-body-name: body
x-operationVersions:
- label: v1
operationPointer: '#/paths/~1vpa~1v1~1buyerManagement~1buyer~1create/post'
default: false
x-hideTryIt: true
/vpa/v2/buyerManagement/buyer/get:
post:
tags:
- Buyer Management Service
summary: Get Buyer Details
description: Retrieve all of the current parameters of an existing buyers’ profile. Use this for troubleshooting or to get the full buyer profile details before updating a buyer. Enables the addition, update or deletion of new company template and profiles.
operationId: Get Buyer Details v2
requestBody:
description: Parameters required to retrieve a Buyer
content:
application/json:
schema:
$ref: '#/components/schemas/GetBuyerRequest'
examples:
Default:
summary: Default
value:
clientId: B2BWS_1_1_1111
messageId: '107970184447'
buyerId: '200031032'
required: true
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/GetBuyerSuccessResponseV2-3'
examples:
Default:
summary: Default
value:
responseObject:
responseFileConfig:
fileLevel: null
recipientLoginIds: null
commFileId: null
fileFormat: null
proxyConfig:
holdDays: '180'
bucketedProxyEnabled: false
autoRefreshEnabled: false
boostPaymentConfig:
boostPaymentEnabled: false
contactInfo:
zipCode: '78750'
phone1Ext: null
city: Austin
contactName: VisaCompany
phone2Ext: null
phone3Ext: null
phone2: null
phone3: null
buyerId: '200031032'
buyerName: '2000131032'
templateId: null
phone1: '1234567890'
implementationType: 2
companyId: '2000131032'
emailAddress: visab2bvpaqa1@visa.com
countryCode: USA
addressLine1: addr1
addressLine2: null
state: TX
addressLine3: null
buyerFeatureConfig:
fullAccountViewEnabled: false
cardMaskingDigitsOnline: '12'
vcfDataFeedIndicator: Y
onlinePaymentInstructionEnabled: true
onlinePaymentRequisitionEnabled: true
cardMaskingDigits: '4'
pseudoAccountsEnabled: false
rvaReconciliationFileConfig:
fileLevel: ''
recipientLoginIds: []
commFileId: ''
deliveryTime: ''
deliveryFrequency: null
templateId: ''
fileFormat: null
paymentFileConfig:
edi824FileId: null
edi997FileId: null
inboundFileId: null
billingConfig:
billingType: I
billingBID: '10048816840'
stripePaymentConfig:
remittanceNotificationEnabled: false
stripePaymentEnabled: false
vanConfig:
fcsBankId: null
processingType: null
aceClientId: null
admClientId: null
visaADMOptionId: null
mcADMOptionId: null
vanEnabled: false
settlementExpirationDays: null
stpPaymentConfig:
accountHolderFirstName: null
remittanceNotificationEnabled: false
stpPaymentEnabled: false
accountHolderLastName: null
webServicesConfig:
apiCodes: null
webServicesEnabled: false
clientId: null
vbdsDataSubscription:
- dataSubscriptionType: 5001
dataSubscriptionAccountType:
- subscribed: true
accountType: MEMO
- subscribed: true
accountType: NVPA
suppressSupplierNotification: false
vbdsClientId: '12345'
paymentConfig:
securityCodeRequired: true
allowableCurrencies:
- INR
- USD
expirationDays: '25'
billingCurrency: USD
expirationBufferDays: '5'
defaultSecurityCode: true
paymentAdviceOption: C
paymentSecurityConfig:
defaultSecurityFieldCode: '1'
defaultSecurityQuestion: Credential Text
customSecurityQuestions: []
customSecurityQuestionsEnabled: false
approvalWorkflowConfig:
workflowFunctionCodes: []
workflowConfigEnabled: false
authorizationControlConfig:
authControlPaymentTemplate: Custom_Standard
issuerHoldingBID: ''
authControlEnabled: false
defaultAuthControlEnabled: false
alertsEnabled: false
paymentNotificationConfig:
defaultBuyerLanguageCode: en_US
supplierReminderNotificationDays: '7'
paymentAdviceTemplate: Custom_Standard
settlementSource: '1'
dateFormat: DDMMYYYY
defaultSupplierReminderNotificationEnabled: true
defaultAttachRemittanceDetailsFile: true
supplierReminderNotificationEnabled: true
attachRemittanceDetailsFile: true
reconciliationFileConfig:
fileLevel: ''
recipientLoginIds: []
adhocReconciliationReportEnabled: false
commFileId: ''
deliveryTime: ''
templateName: null
deliveryFrequency: null
onlinePaymentReconciliationEnabled: false
fileFormat: null
processorConfig:
embossedLine2: '<> '
closeAccountEnabled: true
processorFields:
aceOptionSet: '1111'
accountIdOptionSet: '1111'
mailerIdOptionSet: '1111'
companyNumber: '1111111'
cycleFrequencyCode: '15'
cmidDefaultValue: ''
unitId: '1000000'
agentNumber: '0000'
cycleFrequencyType: Monthly
suaEmbossedLine1: <>~1
lodgedEmbossedLine1: <>~1
responseStatus:
statusDesc: Successfully retrieved the buyer
messageId: '1686861552'
status: success
statusCode: BSGB0000
'400':
description: Refer to the Error Codes page for the list of error codes for this API.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
x-samplePayload: ''
x-codegen-request-body-name: body
x-hideTryIt: true
/vpa/v1/buyerManagement/buyerTemplate/get:
post:
tags:
- Buyer Management Service
summary: Get Buyer Template
description: ''
operationId: Get Buyer Template
requestBody:
description: Request Details for getting the details of a Buyer template.
content:
application/json:
schema:
$ref: '#/components/schemas/GetBuyerTemplateRequest'
examples:
Default:
summary: Default
value:
clientId: B2BWS_1_Region_Bank_9999
messageId: '1579791844475'
templateId: '1_3_9999_110'
required: true
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/GetBuyerTemplateSuccessResponse'
examples:
Default:
summary: Default
value:
responseFileConfig: null
proxyConfig:
holdDays: '2'
bucketedProxyEnabled: false
autoRefreshEnabled: true
boostPaymentConfig:
boostPaymentEnabled: true
contactInfo:
emailAddress: visab2bvpaqa1@visa.com
phone1: '8888888888'
buyerFeatureConfig:
fullAccountViewEnabled: true
cardMaskingDigitsOnline: '12'
onlinePaymentInstructionEnabled: true
onlinePaymentRequisitionEnabled: true
cardMaskingDigits: '12'
pseudoAccountsEnabled: false
rvaReconciliationFileConfig: null
stripePaymentConfig:
remittanceNotificationEnabled: true
stripePaymentEnabled: true
vanConfig:
fcsBankId: F285
vanEnabled: true
stpPaymentConfig:
remittanceNotificationEnabled: true
stpPaymentEnabled: true
webServicesConfig:
apiCodes:
- ALL
webServicesEnabled: true
clientId: B2BWS_1_Region_Bank_9999
suppressSupplierNotification: false
vbdsClientId: '6677'
templateId: '1_3_9999_110'
paymentConfig:
securityCodeRequired: true
allowableCurrencies:
- USD
expirationDays: '30'
billingCurrency: USD
expirationBufferDays: '5'
paymentAdviceOption: C
paymentFileCommConfig: null
paymentSecurityConfig:
defaultSecurityFieldCode: '1'
defaultSecurityQuestion: Credential Text
customSecurityQuestions: null
customSecurityQuestionsEnabled: false
approvalWorkflowConfig:
workflowFunctionCodes:
- AUCL
- LCRC
- PYIN
- PYRN
workflowConfigEnabled: true
authorizationControlConfig:
issuerHoldingBID: null
authControlEnabled: true
alertsEnabled: false
paymentNotificationConfig:
defaultBuyerLanguageCode: en_US
supplierReminderNotificationDays: '7'
dateFormat: DDMMYYYY
supplierReminderNotificationEnabled: true
attachRemittanceFileDetails: false
templateName: '1579774641311'
templateDescription: VPP Template
reconciliationFileConfig:
adhocReconciliationReportEnabled: false
commFileId: null
templateName: null
onlinePaymentReconciliationEnabled: false
processorConfig:
closeAccount: true
'400':
description: Refer to the Error Codes page for the list of error codes for this API.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
x-samplePayload: ''
x-codegen-request-body-name: templateRequest
x-hideTryIt: true
components:
schemas:
PaymentFileCommConfig:
type: object
properties:
edi824FileId:
maxLength: 40
type: string
description: Denotes the Comm File ID associated with the EDI 824 outbound response file
edi997FileId:
maxLength: 40
type: string
description: Denotes the Comm File ID associated with the EDI 997 outbound ack file
inboundFileId:
maxLength: 40
type: string
description: Denotes the Comm file ID associated with the EDI 820 inbound payment file
description: PaymentFileCommConfig contains the comm file configuration for inbound EDI 820, and outbound EDI 997 and EDI 824.
CreateBuyerTemplateSuccessResponse:
type: object
properties:
responseObject:
$ref: '#/components/schemas/CreateBuyerTemplateResponse'
responseStatus:
$ref: '#/components/schemas/Response'
description: Create Buyer Template Success Response
GetVanConfig:
type: object
properties:
fcsBankId:
maxLength: 4
type: string
description: Denotes the Bank Identifier in the TSYS VPP FCS system.
vanEnabled:
type: boolean
description: Denotes if "VANs" (VPP Tokens) are enabled for the template (buyers).
GetBuyerSuccessResponseV2-3:
type: object
properties:
responseObject:
$ref: '#/components/schemas/GetBuyerResponseV2-3'
responseStatus:
$ref: '#/components/schemas/Response'
description: Response for a successful fetch of a Buyer
VanConfigForCreate:
type: object
properties:
fcsBankId:
maxLength: 4
type: string
description: Denotes the Bank Identifier in the TSYS VPP FCS system. This value will be provided by the Visa implementation team. If the value for this field (the tag is not sent) is not provided, the system defaults it to the bank FCS ID if there is only one setup at the bank level. Supports alphanumeric values. Required if the buyer is enabled for VANs.
vanEnabled:
type: boolean
description: Denotes if "VANs" (VPP Tokens) are enabled for the buyer. Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for this Option.
admClientId:
maxLength: 4
type: string
description: Denotes the number the TSYS VPP system uses to identify the company on the ACE Decision Max system for account assignment. This value will be provided by the Visa implementation team.
mcADMOptionId:
maxLength: 5
type: string
description: Denotes the option that will be used to assign the virtual account number in the TSYS VPP platform. For the TS1 platform only, the option must be set up to assign a virtual account number from the same BIN as the primary account number. This value will be provided by the Visa implementation team. If it is a Mastercard bank, then this field is required.
processingType:
maxLength: 4
type: string
description: Denotes the Processing type for the virtual account number (VAN). This value will be provided by the Visa implementation team.
visaADMOptionId:
maxLength: 5
type: string
description: Denotes the option that will be used to assign the virtual account number in the TSYS VPP platform. For the TS1 platform only, the option must be set up to assign a virtual account number from the same BIN as the primary account number. If it is a Visa bank, then this field is required. This value will be provided by the Visa implementation team.
GetPaymentSecurityConfig:
type: object
properties:
customSecurityQuestions:
maxItems: 3
uniqueItems: true
type: array
description: The questions (text) which will be used at random (Only one of the questions will be displayed) to authenticate the supplier when they click on the URL sent in the payment advice notification for viewing the full card details. The system sends the security questions and answers to the supplier when the supplier is setup for the buyer. At least one question needs to be sent if custom security question is enabled for the template.
items:
maxLength: 100
type: string
description: Upto 3 custom security questions could be used.
defaultSecurityQuestion:
maxLength: 256
type: string
description: Denotes the text for the default security question which will be displayed to the supplier when they click on the URL sent in the payment advice notification for viewing the full card details.
defaultSecurityFieldCode:
maxLength: 1
pattern: ^[\d]+$
type: string
description: Denotes the field system uses to authenticate the supplier when they click on the URL sent in the payment advice notification for viewing the full card details.
customSecurityQuestionsEnabled:
type: boolean
description: Denotes if the buyer wants to use custom security questions to authenticate the supplier when they click on the URL sent in the payment advice notification for viewing the full card details.
BoostPaymentConfigForUpdate:
type: object
properties:
boostPaymentEnabled:
type: boolean
description: Denotes if Boost payments is enabled for the buyer. Valid values are 'True' or 'False'. This field can be set to true only if the bank Boost Payment option is set to 'True'. You can enable Boost payments for a buyer at any time. But you cannot disable it (update it to false) if there are Boost suppliers present for the buyer
BResponse:
type: object
properties:
status:
type: string
description: Response status `success` or `error`
enum:
- success
- error
messageId:
maxLength: 36
type: string
description: Unique identifier which was sent in the request.
statusCode:
maxLength: 6
type: string
description: Status code of the response. It is alphanumeric. The values are specific to each method. For the details of the various error codes returned for this method refer to the "Error Codes" table below.
statusDesc:
maxLength: 255
type: string
description: Status description of the response.
description: Default API Response
UpdateBillingConfig:
type: object
properties:
billingBID:
type: string
description: The 11 digit Visa Billing BID that will be billed for the service. This is in the format of 8 digit Visa BID plus 3 digit country code. E.g. 12345678840 where 840 is country code for United States.
billingType:
type: string
description: Identifies who will be billed for use of the service. Valid Values are I, T or M. Select I if the issuer will be billed (standard). Select T if Third party / fintech will be billed. Select M if billing needs to be manually billed (not common).
ProxyConfigForUpdate:
type: object
properties:
holdDays:
maxLength: 3
pattern: ^[\d]+$
type: string
description: Denotes the number of days an account picked up for a payment in a proxy will be kept on hold before being used for another payment. For payments, the hold days start from the day the payment was processed and for Request Virtual Account, the hold days start from the day the end date of the RVA has reached. Should be a numeric value between 1 to 999. This field can be updated at any time.
autoRefreshEnabled:
type: boolean
description: Denotes if auto replenishment is enabled for proxies associated with the buyer. The value of this field should be set to true for VIP and VPP enabled buyers. Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for auto replenishment. This field can be updated at any time.
bucketedProxyEnabled:
type: boolean
description: Denotes if bucketed proxy is enabled for proxies associated with the buyer. Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for bucketed proxy. This field can be updated only if all the proxy pools are empty.
ContactInfoForCreate-1:
required:
- addressLine1
- buyerName
- city
- companyId
- contactName
- countryCode
- state
- zipCode
type: object
properties:
city:
maxLength: 20
type: string
description: Contains the City Name of the buyer's contact address.
state:
maxLength: 27
type: string
description: Contains the state of the buyer's contact address.
phone1:
maxLength: 20
type: string
description: Contains the buyer contact phone number 1. Field is alphanuemeric. Special characters allowed are - (dash), ( (Open braces),) (close braces).
phone2:
maxLength: 20
type: string
description: Contains the buyer contact phone number 2. Field is alphanumeric. Special characters allowed are - (dash), ( (Open braces),) (close braces).
phone3:
maxLength: 20
type: string
description: Contains the buyer contact phone number 3. Field is alphanumeric. Special characters allowed are - (dash), ( (Open braces),) (close braces).
buyerId:
maxLength: 25
pattern: ^[\d]+$
type: string
description: Contains the buyer identifier as defined in Visa Payables Automation. This is often the ID defined at the processor. Value format is 0–9. It is a mandatory field.
zipCode:
maxLength: 9
type: string
description: Contains the Postal Code of the buyer's contact address. Do not include special characters, e.g. hyphen, in the zipcode. If a special character is provided it will be removed and processed with only nine digits. Null is allowed.
buyerName:
maxLength: 100
type: string
description: Contains the name of the buyer. It is a mandatory field.
companyId:
maxLength: 10
pattern: ^[\d]+$
type: string
description: Contains the buyer identifier as defined at the issuer processor. Value format is 0–9. It is a mandatory field.
phone1Ext:
maxLength: 20
type: string
description: Contains the extension of the buyer contact phone number 1. Field is alphanumeric. Special characters allowed are - (dash), ( (Open braces),) (close braces).
phone2Ext:
maxLength: 20
type: string
description: Contains the extension of the buyer contact phone number 2. Field is alphanumeric. Special characters allowed are - (dash), ( (Open braces),) (close braces).
phone3Ext:
maxLength: 20
type: string
description: Contains the extension of the buyer contact phone number 3. Field is alphanumeric. Special characters allowed are - (dash), ( (Open braces),) (close braces).
templateId:
maxLength: 30
pattern: ^[\w-]+$
type: string
description: Contains the unique identifier for a Template asscoiated with the bank. Template id of the template which was sent in the response when you created a new template. This field should be blank if the buyer is created without a template.
contactName:
maxLength: 100
type: string
description: Contains the name of the primary contact person in the buyer. The input should be alphabets.
countryCode:
maxLength: 3
pattern: ^[a-zA-Z]{3}$
type: string
description: Contains the ISO alpha country code of the buyer's contact address. For example- USA.
addressLine1:
maxLength: 40
type: string
description: Contains the line 1 of the buyer's contact address.
addressLine2:
maxLength: 40
type: string
description: Contains the line 2 of the buyer's contact address.
addressLine3:
maxLength: 80
type: string
description: Contains the line 3 of the buyer's contact address.
emailAddress:
maxLength: 100
type: string
description: Contains the buyer's contact Email Address. Should be an valid email address.
implementationType:
type: integer
description: Valid Values are:1 – VPA UI, 2 – VPA API and 3 – Visa Commercial Pay. Select 1 if buyer will use VPA user interface (issuer direct use of VPA). Select 2 if buyer is created by a third party fintech and will use the VPA APIs. Select 3 if buyer is created in VPA for Visa Commercial Pay service.
CreateBuyerSuccessResponse:
type: object
properties:
responseStatus:
$ref: '#/components/schemas/Response'
description: Response for successful creation of a Buyer
UpdateApprovalWorkflowConfig:
type: object
properties:
workflowConfigEnabled:
type: boolean
description: Denotes if the Approval Workflow is enabled for the template (Buyer). Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for this Option. This field can be edited only if the sync Buyer Profiles is set to false.
workflowFunctionCodes:
maxItems: 10
uniqueItems: true
type: array
items:
maxLength: 4
type: string
description: Denotes the codes for the functionalities for which Approval Workflow needs to be enabled. Valid Values are AUCL – Card Limit Update, LCRC – Lodge/New Card, PYIN – Payment Instruction, PYRN – Payment Requisition At least one function should be passed in this field if workflowconfigenabled field is set to true for the template. This field can be edited only if the sync Buyer Profiles is set to false.
description: Parent tag which contains the approval workflow configurations.
PaymentSecurityConfig:
type: object
properties:
customSecurityQuestions:
maxItems: 3
uniqueItems: true
type: array
description: The questions (text) which will be used at random (Only one of the questions will be displayed) to authenticate the supplier when they click on the URL sent in the payment advice notification for viewing the full card details. The system sends the security questions and answers to the supplier when the supplier is setup for the buyer. At least one question needs to be sent if custom security question is enabled for the template.
items:
maxLength: 100
type: string
description: The size of the field should not exceed 100
defaultSecurityQuestion:
maxLength: 256
type: string
description: Denotes the text for the default security question which will be displayed to the supplier when they click on the URL sent in the payment advice notification for viewing the full card details. If the value for this field (the tag is not sent) is not provided, the system defaults it to "Credential Text".
defaultSecurityFieldCode:
maxLength: 1
type: string
description: Denotes the field system uses to authenticate the supplier when they click on the URL sent in the payment advice notification for viewing the full card details. Valid values are '1' - Postal code and '2' - Supplier ID. If the value for this field (the tag is not sent) is not provided, the system defaults it to '1'. The default security is used only when the system creates new suppliers while processing payment files (EDI 820) or if custom security question is not enabled.
customSecurityQuestionsEnabled:
type: boolean
description: Denotes if the buyer wants to use custom security questions to authenticate the supplier when they click on the URL sent in the payment advice notification for viewing the full card details. Valid values are 'True' and 'False'. Optional field. This field can be set to True only if the bank custom security questions option is set to True.
UpdatePaymentConfig:
type: object
properties:
expirationDays:
maxLength: 3
pattern: ^[\d]+$
type: string
description: Default payment expiration days which will be used if the buyer did not provide the payment expiration date either in the payment or has not configured for the supplier. The payment expiration days will be used to calculate the payment expiration date (payment process date + the payment expiration days) which is the last day by which the supplier should collect the payment. Only numbers are allowed. This fiel can be updated at any time.
billingCurrency:
maxLength: 3
pattern: ^[a-zA-Z]{3}$
type: string
description: Denotes the ISO alpha currency code associated with the billing Currency of the card accounts belonging to the buyer. For example- USD for US Dollar. It should be one of the supported active currencies in VPA. VPA system uses the billing currency as the payment currency for adjustable limit card accounts. This field cannot be updated if sync Buyer Profiles field is set to true.
allowableCurrencies:
maxItems: 200
uniqueItems: true
type: array
description: Contains the list of ISO alpha currency codes allowed for the buyer. The buyer can process payments only in one of these currencies. Payments made in any other currency will be rejected. All ISO alpha currency codes will be supported. For example- USD for US Dollar. It should be one of the supported active currencies in VPA. Can setup up to a max of 200 currencies. Billing currency should be present in the list else the system will automatically add it to the list. Defaults to the billing currency if not provided. This field cannot be updated if the sync Buyer Profiles is set to true.
items:
maxLength: 3
pattern: ^[a-zA-Z]{3}$
type: string
paymentAdviceOption:
maxLength: 1
type: string
description: Denotes if the payment advice should be sent at the consolidated payment level (Consolidated) or for each payment (split). Valid values are 'C' for consolidated or 'S' for split. If consolidated option is chosen, all payments to the same supplier will be consolidated and sent in one payment advice notification. This field can be updated at any time.
expirationBufferDays:
maxLength: 2
pattern: ^[\d]+$
type: string
description: expirationBufferDays is the number of days after the payment expiration date by which the supplier needs to complete the collection of the payment (settlement of the card transaction should be completed). Only 2 digit integer numbers are allowed. Can be updated at any time.
securityCodeRequired:
type: boolean
description: Denotes if security code is needed for the supplier to collect the payment. Valid values are 'True' or 'False'. This field can be set to true only if the bank security code (CVV2) option is set to 'True'. This field can be updated at any time.
ProcessorConfigForUpdate:
type: object
properties:
processorFields:
type: object
additionalProperties:
type: object
properties: {}
closeAccountEnabled:
type: boolean
description: Default to Yes if processor integration is enabled for the bank. Default to N if Processor integration is not enabled for the bank. Default to Y if the buyer is enabled for VIP/VPP tokens.
description: 'This section is used if the issuer has processor integration enabled. When using processor PANs, the following processors can be enabled for processor integration: FIS, FDR, TS1, TS2, and TSUK. When using Visa Pseudo accounts or TSYS VANs, processor integration is not required but if it is enabled the system goes to the processor to retrieve the latest values (such as expiry date, current balance and available balance for the funding accounts). The fields vary for each processor so refer to the details Buyer Setup Details page for more information on which fields are required for each processor. If using TSYS VPP VANs or Visa VIP Pseudo Accounts, defaults values can be used. Please refer to the Buyer Setup Details page for the defaults'
WebServicesConfigForGetV2-1:
type: object
properties:
apiCodes:
maxItems: 200
uniqueItems: true
type: array
description: Denotes the codes associated with APIs which needs to be enabled for the buyer. The APIs should be a subset of what is enabled for the bank. The API codes and the corresponding APIs can be found below ....
items:
maxLength: 10
type: string
clientId:
maxLength: 40
type: string
description: Denotes the client id associated with the bank under which the buyer is being created. The Visa implementation team will be providing this.
vbdsClientId:
maxLength: 50
type: string
description: vbdsClientId is the unique id generated for third parties wanting to subscribe for auth/settlement data in VBDS system.
webServicesEnabled:
type: boolean
description: Denotes if the web services is enabled for the Buyer. Valid Values are 'True' and 'False'.
vbdsDataSubscription:
type: array
description: This complex element captures information about the subscription to Data APIs. This is optional and if this object is not provided, the subscription defaults to bank configuration for the given vbdsClientId.
items:
type: object
properties:
dataSubscriptionType:
type: number
description: 'This field is mandatory if vbdsDataSubcription object is provided. This field accepts the following subscription types. Provide the numeric code associated with the API(s) you want to subscribe to: 5001(Transaction Data API), 5003(Starter Data API), 5004(Authorization Data API (Pull)), 5005(Authorization Data API (Push))'
dataSubscriptionAccountType:
type: array
description: This is optional. If no value is provided, all the account types enabled at the bank level for the client are subscribed to the APIs specified in dataSubscriptionType. Subscribe/unsubscribe is allowed only for the account types enabled at the bank level for the provided client.
items:
type: object
properties:
subscribed:
type: boolean
description: 'This field indicates if the accountType should be subscribed to the specified Data API(s). E.g. if you want to subscribe the account type to the API provide ''true'' here. To unsubscribe an account type to an API, provide ''false''. Valid Values are ''True'' and ''False''.The valid value must be provided for the account type. '
accountType:
type: string
description: 'This field accepts following values. Please use the 4-character alpha code: VIPT:VIP/Pseudo Account-Pseudo Account generated by Visa, NVPA:Non virtual account-Physical cards, MEMO:Processor account-Virtual accounts generated at the Processor, FUNA:Funding Account-Parent Account for Visa Pseudo Accounts or TSYS VPP VAN tokens, VPPT:VPP Token-TSYS generated tokens (Also referred to as TSYS VPP VANs)'
suppressSupplierNotification:
type: boolean
description: Denotes if all supplier notifications needs to be suppressed. If this field is set to true, then the web service consumers should handle the supplier communication themselves. Valid Values are 'True' or 'False'.
BuyerFeatureConfigForGetV2:
type: object
properties:
cardMaskingDigits:
maxLength: 2
pattern: ^[\d]+$
type: string
description: Denotes the number of digits that will be masked for the card number when displayed in all places other than UI like the recon file, response file, etc.
vcfDataFeedIndicator:
type: string
description: 'The vcfDataFeedIndicator is used for indicating the source of transactions/settlement data for this company. This value should be “Yes” if the FI/Processor is going to send settled transactions for the company [e.g. inbound Visa Commercial Format (VCF)]. It should be “No” if the company requires Visa to pull the settlement data over the Visa Network. '
pseudoAccountsEnabled:
type: boolean
description: Denotes if "Pseudo Accounts" (VIP Tokens) option is enabled for the buyer.
fullAccountViewEnabled:
type: boolean
description: Denotes if "Full Account View" functionality is enabled for the buyer.
cardMaskingDigitsOnline:
maxLength: 2
pattern: ^[\d]+$
type: string
description: Denotes the number of digits that will be masked for the card number when displayed in the UI.
onlinePaymentInstructionEnabled:
type: boolean
description: Denotes if Online payment instruction (Pay Now) functionality is enabled for the buyer.
onlinePaymentRequisitionEnabled:
type: boolean
description: Denotes if Online payment Requisition functionality is enabled for the buyer.
GetPaymentFileCommConfig:
type: object
properties:
edi824FileId:
maxLength: 40
type: string
description: Denotes the Comm File ID associated with the EDI 824 outbound response file.
edi997FileId:
maxLength: 40
type: string
description: Denotes the Comm File ID associated with the EDI 997 outbound ack file.
inboundFileId:
maxLength: 40
type: string
description: Denotes the Comm file ID associated with the EDI 820 inbound payment file.
description: PaymentFileCommConfig contains the comm file configuration for inbound EDI 820, and outbound EDI 997 and EDI 824.
BuyerFeatureConfigForUpdate:
type: object
properties:
cardMaskingDigits:
maxLength: 2
pattern: ^[\d]+$
type: string
description: Denotes the number of digits that will be masked for the card number when displayed in all places other than UI like the recon file, response file, etc. Should be Numeric. Should be between 4 and 12. This field can be updated at any time.
pseudoAccountsEnabled:
type: boolean
description: Denotes if "Pseudo Accounts" (VIP Tokens) option is enabled for the buyer. Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for this Option. This field can be enabled (set to true) but can not be disabled (set to false).
fullAccountViewEnabled:
type: boolean
description: Denotes if "Full Account View" functionality is enabled for the buyer. Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for this functionality. This field can be updated at any time.
cardMaskingDigitsOnline:
maxLength: 2
pattern: ^[\d]+$
type: string
description: Denotes the number of digits that will be masked for the card number when displayed in the UI. Should be Numeric. Should be between 4 and 12. This field can be updated at any time.
onlinePaymentInstructionEnabled:
type: boolean
description: Denotes if Online payment instruction (Pay Now) functionality is enabled for the buyer. Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for Online Payment Instructions. This field can be updated at any time.
onlinePaymentRequisitionEnabled:
type: boolean
description: Denotes if Online payment Requisition functionality is enabled for the buyer. If the value for this field (the tag is not sent) is not provided, the system defaults it to False. Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for Online Payment Requisitions. This field can be updated at any time.
BillingConfigForUpdate:
type: object
properties:
billingBID:
type: string
description: The 11 digit Visa Billing BID that will be billed for the service. This is in the format of 8 digit Visa BID plus 3 digit country code. E.g. 12345678840 where 840 is country code for United States.
billingType:
type: string
description: Identifies who will be billed for use of the service. I indicates issuer will be billed (standard). T indicates Third party / fintech will be billed. M indicates manual billing is set up.
ResponseFileConfigForUpdate-1:
type: object
properties:
fileLevel:
maxLength: 1
type: string
description: Denotes if the response COMM File configuration is defined to be delivered to the bank(B) or Company (C). Valid values are B and C. This can be updated at any time.
commFileId:
maxLength: 40
type: string
description: Denotes the Comm File ID associated with the Response file outbound. The COMM file definition should exist in the system. The Visa implementation team provides this value after the outbound response file configuration has been completed. This can be updated at any time.
fileFormat:
type: integer
description: Denotes the format in which the response file needs to be generated. Needs to be numeric. Valid values are 1 – XLS V0, 2 – CSV V0, 3 - XLS V1, 4 – CSV V1. This field can be updated at any time.
recipientLoginIds:
maxItems: 80
uniqueItems: true
type: array
description: Contains the list of user ids of bank/buyer users who will be receiving the response file in their VOL mailbox. You can setup upto 80 user ids to receive the response file. The user ids should have the VOL mailbox service entitled to them. This can be updated at any time.
items:
type: string
UpdateBuyerSuccessResponse:
type: object
properties:
responseStatus:
$ref: '#/components/schemas/Response'
description: Response for a successful update of a Buyer
PaymentFileCommConfigForUpdate:
type: object
properties:
edi824FileId:
maxLength: 40
type: string
description: Denotes the Comm File ID associated with the EDI 824 outbound response file. The COMM file definition should exist in the system. The Visa implementation team provides this value after the outbound edi 824 file configuration has been completed. This field can be updated at anytime.
edi997FileId:
maxLength: 40
type: string
description: Denotes the Comm File ID associated with the EDI 997 outbound ack file. The COMM file definition should exist in the system. The Visa implementation team provides this value after the the outbound edi 997 file configuration has been completed. This field can be updated at anytime.
inboundFileId:
maxLength: 40
type: string
description: Denotes the Comm file ID associated with the inbound payment file (EDI 820 or SFF). The COMM file definition should exist in the system. The Visa implementation team provides this value after the inbound file configuration has been completed. This field can be updated at anytime
UpdateReconciliationFileConfig:
type: object
properties:
adhocReconciliationReportEnabled:
type: boolean
description: Denotes if Adhoc Reconciliation functionality is enabled for the template (buyers). Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for Adhoc Reconciliation. This field Can be edited at any time.
onlinePaymentReconciliationEnabled:
type: boolean
description: Denotes if Online payment Reconciliation functionality is enabled for the template (buyers). Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for Online Payment Reconciliation. This field Can be edited at any time.
UpdateBuyerFeatureConfig:
type: object
properties:
cardMaskingDigits:
maxLength: 2
pattern: ^[\d]+$
type: string
description: Denotes the number of digits that will be masked for the card number when displayed in all places other than UI like the recon file, response file, etc. Should be Numeric. Should be between 4 and 12. This field can be edited at any time.
vcfDataFeedIndicator:
type: string
description: The vcfDataFeedIndicator is used for indicating the source of transactions/settlement data for this company. This value should be “Yes” if the FI/Processor is going to send settled transactions for the company [e.g. inbound Visa Commercial Format (VCF)]. It should be “No” if the company requires Visa to pull the settlement data over the Visa Network.hello
pseudoAccountsEnabled:
type: boolean
description: Denotes if "Pseudo Accounts" (VIP Tokens) option is enabled for the template (buyers). Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for this Option. This field can be edited only if the sync Buyer Profiles is set to false.
fullAccountViewEnabled:
type: boolean
description: Denotes if "Full Account View" functionality is enabled for the template (buyers). Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for this functionality. This field can be edited at any time.
cardMaskingDigitsOnline:
maxLength: 2
pattern: ^[\d]+$
type: string
description: Denotes the number of digits that will be masked for the card number when displayed in the UI. Should be Numeric. Should be between 4 and 12. This field can be edited at any time.
onlinePaymentInstructionEnabled:
type: boolean
description: Denotes if Online payment instruction (Pay Now) functionality is enabled for the template (buyers). Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for Online Payment Instructions. This field can be edited at any time.
onlinePaymentRequisitionEnabled:
type: boolean
description: Denotes if Online payment Requisition functionality is enabled for the template (buyers). Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for Online Payment Requisitions. This field can be edited at any time.
ReconciliationFileConfig:
type: object
properties:
commFileId:
maxLength: 40
type: string
description: Comm file Id refers to Comm File info associated with the recon file outbound delivery.Required if ReconFileDelivery is set to Comms.
templateName:
maxLength: 100
type: string
description: Denotes the name of the custom Reconciliation template to be used for generating the reconciliation file for all buyers using the template.
adhocReconciliationReportEnabled:
type: boolean
description: Denotes if Adhoc Reconciliation functionality is enabled for the template (buyers). Valid Values are 'True' and 'False'. If the value for this field (the tag is not sent) is not provided, the system defaults it to False. The value can be set to true only if the bank is enabled for Adhoc Reconciliation.
onlinePaymentReconciliationEnabled:
type: boolean
description: Denotes if Online payment Reconciliation functionality is enabled for the template (buyers). Valid Values are 'True' and 'False'. If the value for this field (the tag is not sent) is not provided, the system defaults it to False. The value can be set to true only if the bank is enabled for Online Payment Reconciliation.
StripePaymentConfig:
type: object
properties:
stripePaymentEnabled:
type: boolean
description: Denotes if Stripe payments is enabled for the template (buyer). Valid values are 'True' or 'False'. Optional field. If the value for this field (the tag is not sent) is not provided, the system defaults it to 'False'. This field can be set to true only if the bank Stripe Payment option is set to 'True'.
remittanceNotificationEnabled:
type: boolean
description: Denotes if the Stripe Payment Remittance notification is enabled for a template (buyer). Valid values are 'True' or 'False'. Optional field. If the value for this field (the tag is not sent) is not provided, the system defaults it to 'False'. This field can be set to true only if the bank Stripe Payment Remittance Notification option is set to 'True'. Only if this field is enabled, the Stripe supplier will be getting the payment remittance notification.
StpPaymentConfigForUpdate:
type: object
properties:
stpPaymentEnabled:
type: boolean
description: Denotes if STP payments is enabled for the buyer. Valid values are 'True' or 'False'. This field can be set to true only if the bank STP Payment option is set to 'True'. You can enable STP payments for a buyer at any time. But you cannot disable it (update it to false) if there are STP suppliers present for the buyer.
accountHolderLastName:
maxLength: 100
type: string
description: Denotes the Account Holder's last Name which will be used while processing the STP payment. This field can be edited at any time.
accountHolderFirstName:
maxLength: 100
type: string
description: Denotes the Account Holder's first Name which will be used while processing the STP payment. This field can be edited at any time.
remittanceNotificationEnabled:
type: boolean
description: Denotes if the STP Payment Remittance notification is enabled for a buyer. Optional field. Valid values are 'True' or 'False'. This field can be set to true only if the bank STP Payment Remittance Notification option is set to 'True'. The STP supplier will be getting the payment remittance notification only if this field is enabled. This field can be edited at any time.
ProcessorConfigForCreate:
type: object
properties:
processorFields:
type: object
additionalProperties:
type: object
properties: {}
closeAccountEnabled:
type: boolean
description: Default to Yes if processor integration is enabled for the bank. Default to N if Processor integration is not enabled for the bank. Default to Y if the buyer is enabled for VIP/VPP tokens.
description: 'This section is used if the issuer has processor integration enabled. When using processor PANs, the following processors can be enabled for processor integration: FIS, FDR, TS1, TS2, and TSUK. When using Visa Pseudo accounts or TSYS VANs, processor integration is not required but if it is enabled the system goes to the processor to retrieve the latest values (such as expiry date, current balance and available balance for the funding accounts). The fields vary for each processor so refer to the details Buyer Setup Details page for more information on which fields are required for each processor. If using TSYS VPP VANs or Visa VIP Pseudo Accounts, defaults values can be used. Please refer to the Buyer Setup Details page for the defaults'
ApprovalWorkflowConfigForCreate:
type: object
properties:
workflowConfigEnabled:
type: boolean
description: Denotes if the Approval Workflow is enabled for the Buyer. If the value for this field (the tag is not sent) is not provided, the system defaults it false. Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for this Option.
workflowFunctionCodes:
uniqueItems: true
type: array
description: Denotes the codes for the functionalities for which Approval Workflow needs to be enabled. Valid Values are AUCL - Card Limit Update, LCRC - Lodge/New Card, PYIN - Payment Instruction, PYRN - Payment Requisition At least one function should be passed in this field if workflowconfigenabled field is set to true for the buyer.
items:
pattern: ^[a-zA-Z]{4}$
type: string
enum:
- AUCL
- LCRC
- PYIN
- PYRN
GetBuyerTemplateRequest:
required:
- clientId
- messageId
- templateId
type: object
properties:
clientId:
maxLength: 25
type: string
description: ClientID associated with the bank. This will be provided by Visa at the time of setup.
messageId:
maxLength: 36
type: string
description: Unique Identifier to identify the request.
templateId:
maxLength: 30
type: string
description: Template ID is a unique identifier for a Template. It is system generated and will provided in the response of the CreateTEmplate API.
description: Get Buyer Template Request
BillingConfig:
type: object
properties:
billingBID:
type: string
description: The 11 digit Visa Billing BID that will be billed for the service. This is in the format of 8 digit Visa BID plus 3 digit country code. E.g. 12345678840 where 840 is country code for United States.
billingType:
type: string
description: Identifies who will be billed for use of the service. I indicates issuer will be billed (standard). T indicates Third party / fintech will be billed. M indicates manual billing is set up.
GetBoostPaymentConfig:
type: object
properties:
boostPaymentEnabled:
type: boolean
description: Denotes if the Boost Payments is enabled for a template (buyer).
ResponseFileConfigForGet:
type: object
properties:
fileLevel:
maxLength: 1
type: string
description: Denotes if the response COMM File configuration is defined to be delivered to the bank(B) or Company (C).
commFileId:
maxLength: 40
type: string
description: Denotes the Comm File ID associated with the Response file outbound. The Visa implementation team provides this value after the outbound response file configuration has been completed.
fileFormat:
type: integer
description: Denotes the format in which the response file needs to be generated. Valid values are 1 – XLS V0, 2 – CSV V0, 3 - XLS V1, 4 – CSV V1
recipientLoginIds:
maxItems: 50
uniqueItems: true
type: array
description: Contains the list of user ids of bank/buyer users who will be receiving the response file in their VOL mailbox.
items:
type: string
RvaReconciliationFileConfigForGet-1:
type: object
properties:
fileLevel:
maxLength: 1
type: string
description: Denotes if the RVA recon COMM File configuration is defined to be delivered to the bank(B) or Company (C). Valid values are B - Bank and C - Company.
commFileId:
type: string
description: Denotes the Comm File ID associated with the RVA recon file outbound. The COMM file definition should exist in the system. The Visa implementation team provides this value after the outbound RVA recon file configuration has been completed.
fileFormat:
type: integer
description: Denotes the format in which the RVA recon file needs to be generated. Valid values are 1 – XLS V0, 2 – CSV V0, 3 - XLS V1, 4 – CSV V1
templateId:
maxLength: 5
type: string
description: Denotes the id of the recon template to be used for generating the RVA reconciliation file. Valid values are 1 - RVA Recon standard template Version 1.0
deliveryTime:
maxLength: 6
type: string
description: Denotes the delivery type or day when the RVA recon file needs to be generated and delivered. Valid format for the time for the daily frequency is 'HH:MM' in 24 hours format. Valid values for the Weekly frequency 1 to 7 denoting the days. 1 being Sunday and 7 being Saturday and Monthly Frequency 1 to 31
deliveryFrequency:
type: integer
description: Denotes the frequency in which the RVA recon file needs to be delivered. Valid values are 1 – Daily 2 – Weekly 3 - Monthly
recipientLoginIds:
maxItems: 80
uniqueItems: true
type: array
description: Contains the list of user ids of bank/buyer users who will be receiving the RVA recon file in their VOL mailbox.
items:
type: string
GetBillingConfig:
type: object
properties:
billingBID:
type: string
description: The 11 digit Visa Billing BID that will be billed for the service. This is in the format of 8 digit Visa BID plus 3 digit country code. E.g. 12345678840 where 840 is country code for United States.
billingType:
type: string
description: Identifies who will be billed for use of the service. I indicates issuer will be billed (standard). T indicates Third party / fintech will be billed. M indicates manual billing is set up.
PaymentSecurityConfigForGet:
type: object
properties:
customSecurityQuestions:
maxItems: 3
uniqueItems: true
type: array
description: The questions (text) which will be used at random (Only one of the questions will be displayed) to authenticate the supplier when they click on the URL sent in the payment advice notification for viewing the full card details. The system sends the security questions and answers to the supplier when the supplier is setup for the buyer.
items:
maxLength: 100
type: string
defaultSecurityQuestion:
maxLength: 256
type: string
description: Denotes the text for the default security question which will be displayed to the supplier when they click on the URL sent in the payment advice notification for viewing the full card details.
defaultSecurityFieldCode:
maxLength: 1
type: string
description: Denotes the field system uses to authenticate the supplier when they click on the URL sent in the payment advice notification for viewing the full card details. Valid values are '1' - Postal code and '2' - Supplier ID. I The default security is used only when the system creates new suppliers while processing payment files (EDI 820) or if custom security question is not enabled.
customSecurityQuestionsEnabled:
type: boolean
description: Denotes if the buyer wants to use custom security questions to authenticate the supplier when they click on the URL sent in the payment advice notification for viewing the full card details. .
ApprovalWorkflowConfigForGet:
type: object
properties:
workflowConfigEnabled:
type: boolean
description: Denotes if the Approval Workflow is enabled for the Buyer.
workflowFunctionCodes:
uniqueItems: true
type: array
description: Denotes the codes for the functionalities for which Approval Workflow needs to be enabled. Valid Values are AUCL - Card Limit Update, LCRC - Lodge/New Card, PYIN - Payment Instruction, PYRN - Payment Requisition
items:
pattern: ^[a-zA-Z]{4}$
type: string
enum:
- AUCL
- LCRC
- PYIN
- PYRN
WebServicesConfigForCreate-2:
type: object
properties:
apiCodes:
maxItems: 200
uniqueItems: true
type: array
description: Reserved for Future use. The system will default the apiCodes to what is set for the bank.
items:
maxLength: 10
type: string
clientId:
maxLength: 40
type: string
description: Reserved for Future use. The system will default the client ID to what is set for the bank.
vbdsClientId:
maxLength: 50
type: string
description: vbdsClientId is the unique id generated for third parties wanting to subscribe for auth/settlement data in VBDS system. Should be numeric.
webServicesEnabled:
type: boolean
description: Denotes if the web services is enabled for the Buyer. If the value for this field (the tag is not sent) is not provided, the system defaults it false. Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for this Option.
vbdsDataSubscription:
type: array
description: This complex element captures information about the subscription to Data APIs. This is optional and if this object is not provided, the subscription defaults to bank configuration for the given vbdsClientId.
items:
type: object
properties:
dataSubscriptionType:
type: number
description: 'This field is mandatory if vbdsDataSubcription object is provided. This field accepts the following subscription types. Provide the numeric code associated with the API(s) you want to subscribe to: 5001(Transaction Data API), 5003(Starter Data API), 5004(Authorization Data API (Pull)), 5005(Authorization Data API (Push))'
dataSubscriptionAccountType:
type: array
description: This is optional. If no value is provided, all the account types enabled at the bank level for the client are subscribed to the APIs specified in dataSubscriptionType. Subscribe/unsubscribe is allowed only for the account types enabled at the bank level for the provided client.
items:
type: object
properties:
subscribed:
type: boolean
description: 'This field indicates if the accountType should be subscribed to the specified Data API(s). E.g. if you want to subscribe the account type to the API provide ''true'' here. To unsubscribe an account type to an API, provide ''false''. Valid Values are ''True'' and ''False''.The valid value must be provided for the account type. '
accountType:
type: string
description: 'This field accepts following values. Please use the 4-character alpha code: VIPT:VIP/Pseudo Account-Pseudo Account generated by Visa, NVPA:Non virtual account-Physical cards, MEMO:Processor account-Virtual accounts generated at the Processor, FUNA:Funding Account-Parent Account for Visa Pseudo Accounts or TSYS VPP VAN tokens, VPPT:VPP Token-TSYS generated tokens (Also referred to as TSYS VPP VANs)'
suppressSupplierNotification:
type: boolean
description: Denotes if all supplier notifications needs to be suppressed. If this field is set to true, then the web service consumers should handle the supplier communication themselves. If the value for this field (the tag is not sent) is not provided, the system defaults it to False. Valid Values are 'True' or 'False'.
GetApprovalWorkflowConfig:
type: object
properties:
workflowConfigEnabled:
type: boolean
description: Denotes if the Approval Workflow is enabled for the template (Buyer).
workflowFunctionCodes:
maxItems: 10
uniqueItems: true
type: array
items:
maxLength: 4
type: string
description: Denotes the codes for the functionalities for which Approval Workflow needs to be enabled. Valid Values are AUCL – Card Limit Update, LCRC – Lodge/New Card, PYIN – Payment Instruction, PYRN – Payment Requisition
description: Parent tag which contains the approval workflow configurations.
GetWebServicesConfig:
type: object
properties:
apiCodes:
maxItems: 200
uniqueItems: true
type: array
items:
maxLength: 10
type: string
description: Denotes the codes associated with APIs which needs to be enabled for the template. The APIs should be a subset of what is enabled for the bank. The API codes and the corresponding APIs can be found below ....
clientId:
maxLength: 40
pattern: ^[\d]+$
type: string
description: Denotes the client ID associated with the bank for which the template is being defined. Visa will provide this during implementation.
vbdsClientId:
maxLength: 50
pattern: ^[\d]+$
type: string
description: vbdsClientId is the unique id generated for third parties wanting to subscribe for auth/settlement data in VBDS system.
webServicesEnabled:
type: boolean
description: Denotes if the web services is enabled for the template (Buyer).
suppressSupplierNotification:
type: boolean
description: Denotes if all supplier notifications needs to be suppressed. If this field is set to true, then the web service consumers should handle the supplier communication themselves.
GetSTPPaymentConfig:
type: object
properties:
stpPaymentEnabled:
type: boolean
description: Denotes if the STP Payments is enabled for a template (buyer).
remittanceNotificationEnabled:
type: boolean
description: Denotes if the STP Payment Remittance notification is enabled for a template (buyer).
StpPaymentConfigForCreate:
type: object
properties:
stpPaymentEnabled:
type: boolean
description: Denotes if STP payments is enabled for the buyer. Optional field. If the value for this field (the tag is not sent) is not provided, the system defaults it to 'False'. Valid values are 'True' or 'False'. This field can be set to true only if the bank STP Payment option is set to 'True'.
accountHolderLastName:
maxLength: 100
type: string
description: Denotes the Account Holder Last Name which will be used while processing the STP payment. If the value for this field (the tag is not sent) is not provided, system defaults to the buyer primary contact person's name (The value from the first space character until the end of the field will be used as the last name).
accountHolderFirstName:
maxLength: 100
type: string
description: Denotes the Account Holder First Name which will be used while processing the STP payment. If the value for this field (the tag is not sent) is not provided, system defaults to the buyer primary contact person's name (The value upto the first space character will be used as the first name)
remittanceNotificationEnabled:
type: boolean
description: Denotes if the STP Payment Remittance notification is enabled for a buyer. Optional field. If the value for this field (the tag is not sent) is not provided, the system defaults it to 'False'. Valid values are 'True' or 'False'. This field can be set to true only if the bank STP Payment Remittance Notification option is set to 'True'. The STP supplier will be getting the payment remittance notification only if this field is enabled.
ErrorItem:
type: object
properties:
errorCode:
type: string
errorDescription:
type: string
description: Error Item
GetBuyerTemplateResponseV2:
type: object
properties:
vanConfig:
$ref: '#/components/schemas/GetVanConfig'
templateId:
maxLength: 30
type: string
description: Unique Identifier for a Template. It should be alphanumeric. Should be an existing template id associated with the bank (associated to the client id). The template id is returned in the response of the GetTemplate API.
contactInfo:
$ref: '#/components/schemas/GetContactInfo'
proxyConfig:
$ref: '#/components/schemas/GetProxyConfig'
templateName:
maxLength: 50
type: string
description: Name of the template
billingConfig:
$ref: '#/components/schemas/GetBillingConfig'
paymentConfig:
$ref: '#/components/schemas/GetPaymentConfig'
processorConfig:
$ref: '#/components/schemas/GetProcessorConfig'
stpPaymentConfig:
$ref: '#/components/schemas/GetSTPPaymentConfig'
webServicesConfig:
$ref: '#/components/schemas/GetWebServicesConfig'
boostPaymentConfig:
$ref: '#/components/schemas/GetBoostPaymentConfig'
buyerFeatureConfig:
$ref: '#/components/schemas/GetBuyerFeatureConfigV2'
responseFileConfig:
$ref: '#/components/schemas/GetResponseFileConfig'
stripePaymentConfig:
$ref: '#/components/schemas/GetStripePaymentConfig'
templateDescription:
maxLength: 256
type: string
description: Description of the template.
paymentFileCommConfig:
$ref: '#/components/schemas/GetPaymentFileCommConfig'
paymentSecurityConfig:
$ref: '#/components/schemas/GetPaymentSecurityConfig'
approvalWorkflowConfig:
$ref: '#/components/schemas/GetApprovalWorkflowConfig'
reconciliationFileConfig:
$ref: '#/components/schemas/GetReconciliationFileConfig'
paymentNotificationConfig:
$ref: '#/components/schemas/GetPaymentNotificationConfig'
authorizationControlConfig:
$ref: '#/components/schemas/GetAuthorizationControlConfig'
rvaReconciliationFileConfig:
$ref: '#/components/schemas/GetRVAReconciliationFileConfig'
description: Get Buyer Template Response V2
StripePaymentConfigForUpdate:
type: object
properties:
stripePaymentEnabled:
type: boolean
description: Denotes if Stripe payments is enabled for the buyer. Valid values are 'True' or 'False'. This field can be set to true only if the bank Stripe Payment option is set to 'True'. You can enable Stripe payments for a buyer at any time. But you cannot disable it (update it to false) if there are Stripe suppliers present for the buyer
remittanceNotificationEnabled:
type: boolean
description: Denotes if the Stripe Payment Remittance notification is enabled for a buyer. Optional field. Valid values are 'True' or 'False'. This field can be set to true only if the bank Stripe Payment Remittance Notification option is set to 'True'. The Stripe supplier will be getting the payment remittance notification only if this field is enabled. This field can be updated at any time.
ErrorResponse:
type: object
properties:
errorObject:
$ref: '#/components/schemas/Error'
responseStatus:
$ref: '#/components/schemas/Response'
description: Create Buyer Template Error Response
BuyerFeatureConfigForCreate:
type: object
properties:
cardMaskingDigits:
maxLength: 2
pattern: ^[\d]+$
type: string
description: Denotes the number of digits that will be masked for the card number when displayed in all places other than UI like the recon file, response file, etc. Should be Numeric. Should be between 4 and 12
vcfDataFeedIndicator:
type: string
description: 'The vcfDataFeedIndicator is used for indicating the source of transactions/settlement data for this company. This value should be “Yes” if the FI/Processor is going to send settled transactions for the company [e.g. inbound Visa Commercial Format (VCF)]. It should be “No” if the company requires Visa to pull the settlement data over the Visa Network. '
pseudoAccountsEnabled:
type: boolean
description: Denotes if "Pseudo Accounts" (VIP Tokens) option is enabled for the buyer. If the value for this field (the tag is not sent) is not provided, the system defaults it false. Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for this Option.
fullAccountViewEnabled:
type: boolean
description: Denotes if "Full Account View" functionality is enabled for the buyer. If the value for this field (the tag is not sent) is not provided, the system defaults it to the bank setting for this field. Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for this functionality.
cardMaskingDigitsOnline:
maxLength: 2
pattern: ^[\d]+$
type: string
description: Denotes the number of digits that will be masked for the card number when displayed in the UI. Should be Numeric. Should be between 4 and 12
onlinePaymentInstructionEnabled:
type: boolean
description: Denotes if Online payment instruction (Pay Now) functionality is enabled for the buyer. If the value for this field (the tag is not sent) is not provided, the system defaults it to False. Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for Online Payment Instructions.
onlinePaymentRequisitionEnabled:
type: boolean
description: Denotes if Online payment Requisition functionality is enabled for the buyer. If the value for this field (the tag is not sent) is not provided, the system defaults it to False. Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for Online Payment Requisitions.
BillingConfigForGet:
type: object
properties:
billingBID:
type: string
description: The 11 digit Visa Billing BID that will be billed for the service. This is in the format of 8 digit Visa BID plus 3 digit country code. E.g. 12345678840 where 840 is country code for United States.
billingType:
type: string
description: Identifies who will be billed for use of the service. I indicates issuer will be billed (standard). T indicates Third party / fintech will be billed. M indicates manual billing is set up.
PaymentConfigForUpdate:
type: object
properties:
expirationDays:
maxLength: 3
pattern: ^[\d]+$
type: string
description: Default payment expiration days which will be used if the buyer did not provide the payment expiration date either in the payment or has not configured for the supplier. The payment expiration days will be used to calculate the payment expiration date (payment process date + the payment expiration days) which is the last day by which the supplier should collect the payment. Only numbers are allowed. This field can be updated at any time. But the updates will affect only the future payments.
billingCurrency:
maxLength: 3
pattern: ^[a-zA-Z]{3}$
type: string
description: Denotes the ISO alpha currency code associated with the billing Currency of the card accounts belonging to the buyer. All ISO alpha currency codes will be supported. For example- USD for US Dollar. It should be one of the supported active currencies in VPA. VPA system uses the billing currency as the payment currency for adjustable limit card accounts. This field can not be updated.
allowableCurrencies:
maxItems: 200
uniqueItems: true
type: array
description: The list of currencies allowed for the buyer. The buyer can process payments in any of these currencies. Any payments made usin other currencies will be rejected. All ISO alpha currency codes will be supported. For example- USD for US Dollar. It should be one of the supported active currencies in VPA. Can setup up to a max of 200 currencies. Billing currency should be present in the list else the system will automatically add it to the list. This field can be updated at any time. But the updates will affect only the future payments.
items:
pattern: ^[a-zA-Z]{3}$
type: string
paymentAdviceOption:
maxLength: 1
type: string
description: This option is used by the system decide if all payments to the same supplier should be consolidated or sent separately in the payment advice notificaion. Valid values are 'C' for consolidated or 'S' for split. This field can be updated at any time. But the updates will affect only the future payments.
expirationBufferDays:
maxLength: 2
pattern: ^[\d]+$
type: string
description: expirationBufferDays is the number of days after the payment expiration date by which the supplier needs to complete the collection of the payment (settlement of the card transaction should be completed). Only numbers are allowed. This field can be updated at any time. But the updates will affect only the future payments.
securityCodeRequired:
type: boolean
description: Denotes if security code is needed for the supplier to collect the payment. Optional field. Valid values are 'True' or 'False'. This field can be set to true only if the bank security code (CVV2) option is set to 'True'. This field can be updated at any time. But the updates will affect only the future payments.
BError:
type: object
properties:
errorList:
type: array
items:
$ref: '#/components/schemas/BErrorItem'
description: Error object
BoostPaymentConfig:
type: object
properties:
boostPaymentEnabled:
type: boolean
description: Denotes if the Boost Payments is enabled for a template (buyer). Valid values are 'True' or 'False'. Optional field. If the value for this field (the tag is not sent) is not provided, the system defaults it to 'False'. This field can be set to true only if the bank Boost Payments option is set to 'True'.
BErrorResponse:
type: object
properties:
errorObject:
$ref: '#/components/schemas/BError'
responseStatus:
$ref: '#/components/schemas/BResponse'
description: Create Buyer Template Error Response
AuthorizationControlConfigForCreate:
type: object
properties:
alertsEnabled:
type: boolean
description: Denotes if the system needs to send an alert when an authorization on a VPC enabled card is approved or declined. Valid values are 'True' and 'False'. This field can be set to True only if the authControlEnabled is set to true for the buyer.
issuerHoldingBID:
pattern: ^[\d]{8}$
type: string
description: Denotes the Holding BID (business id) for the issuer. Should be numeric. Should be set only if authControlEnabled is set to true for the buyer.
authControlEnabled:
type: boolean
description: Denotes if the authorization controls needs to be enabled for the buyer. Auth controls is mandated for VPP and VIP buyers. If the value for this field (the tag is not sent) is not provided, the system defaults it to True if mandate auth controls is set to 'True' for the bank otherwise the system defaults it to False.
GetBuyerResponse:
required:
- messageId
- statusCode
- statusDesc
type: object
properties:
messageId:
maxLength: 36
type: string
description: Unique identifier which was sent in the request.
vanConfig:
$ref: '#/components/schemas/VanConfigForGet'
statusCode:
maxLength: 6
type: string
description: Status code of the response. It is alphanumeric. The values are specific to each method. For the details of the various error codes returned for this method refer to the "Error Codes" table below.
statusDesc:
maxLength: 255
type: string
description: Status description of the response.
contactInfo:
$ref: '#/components/schemas/ContactInfoForGet'
proxyConfig:
$ref: '#/components/schemas/ProxyConfigForGet'
billingConfig:
$ref: '#/components/schemas/BillingConfigForGet'
paymentConfig:
$ref: '#/components/schemas/PaymentConfigForGet'
processorConfig:
$ref: '#/components/schemas/ProcessorConfigForGet'
stpPaymentConfig:
$ref: '#/components/schemas/StpPaymentConfigForGet'
paymentFileConfig:
$ref: '#/components/schemas/PaymentFileCommConfigForGet'
webServicesConfig:
$ref: '#/components/schemas/WebServicesConfigForGet'
boostPaymentConfig:
$ref: '#/components/schemas/BoostPaymentConfigForGet'
buyerFeatureConfig:
$ref: '#/components/schemas/BuyerFeatureConfigForGet'
responseFileConfig:
$ref: '#/components/schemas/ResponseFileConfigForGet'
stripePaymentConfig:
$ref: '#/components/schemas/StripePaymentConfigForGet'
paymentSecurityConfig:
$ref: '#/components/schemas/PaymentSecurityConfigForGet'
approvalWorkflowConfig:
$ref: '#/components/schemas/ApprovalWorkflowConfigForGet'
reconciliationFileConfig:
$ref: '#/components/schemas/ReconciliationFileConfigForGet'
paymentNotificationConfig:
$ref: '#/components/schemas/PaymentNotificationConfigForGet'
authorizationControlConfig:
$ref: '#/components/schemas/AuthorizationControlConfigForGet'
rvaReconciliationFileConfig:
$ref: '#/components/schemas/RvaReconciliationFileConfigForGet'
description: Get Buyer Response Class
GetContactInfo:
type: object
properties:
phone1:
maxLength: 20
type: string
description: Buyer contact phone number. Will be alphanumeric.
emailAddress:
maxLength: 100
type: string
description: Denotes the buyer's contact Email Address. Will be a valid email address.
implementationType:
type: integer
description: Valid Values are:1 – VPA UI, 2 – VPA API and 3 – Visa Commercial Pay. 1 denotes buyer uses VPA UI (issuer direct use of VPA). 2 denotes buyer uses a third party fintech's user interface and third party is using VPA APIs. 3 denotes buyer uses Visa Commercial Pay service.
PaymentSecurityConfigForCreate:
type: object
properties:
customSecurityQuestions:
maxItems: 3
uniqueItems: true
type: array
description: The questions (text) which will be used at random (Only one of the questions will be displayed) to authenticate the supplier when they click on the URL sent in the payment advice notification for viewing the full card details. The system sends the security questions and answers to the supplier when the supplier is setup for the buyer. At least one question needs to be sent if custom security question is enabled for the buyer.
items:
maxLength: 100
type: string
defaultSecurityQuestion:
maxLength: 256
type: string
description: Denotes the text for the default security question which will be displayed to the supplier when they click on the URL sent in the payment advice notification for viewing the full card details. If the value for this field (the tag is not sent) is not provided, the system defaults it to "Credential Text".
defaultSecurityFieldCode:
maxLength: 1
type: string
description: Denotes the field system uses to authenticate the supplier when they click on the URL sent in the payment advice notification for viewing the full card details. Valid values are '1' - Postal code and '2' - Supplier ID. If the value for this field (the tag is not sent) is not provided, the system defaults it to '1'. The default security is used only when the system creates new suppliers while processing payment files (EDI 820) or if custom security question is not enabled.
customSecurityQuestionsEnabled:
type: boolean
description: Denotes if the buyer wants to use custom security questions to authenticate the supplier when they click on the URL sent in the payment advice notification for viewing the full card details. Valid values are 'True' and 'False'. Optional field. This field can be set to True only if the bank custom security questions option is set to True.
ContactInfo:
type: object
properties:
phone1:
maxLength: 20
type: string
description: Buyer contact phone number. Should be alphanumeric. Special characters allowed are - (dash), ( (Open braces),) (close braces).
emailAddress:
maxLength: 100
type: string
description: Denotes the buyer's contact Email Address. Should be an valid email address.
implementationType:
type: integer
description: Valid Values are:1 – VPA UI, 2 – VPA API and 3 – Visa Commercial Pay.1 denotes buyer uses VPA UI (issuer direct use of VPA). 2 denotes buyer uses a third party fintech's user interface and third party is using VPA APIs. 3 denotes buyer uses Visa Commercial Pay service.
BoostPaymentConfigForCreate:
type: object
properties:
boostPaymentEnabled:
type: boolean
description: Denotes if Boost payments is enabled for the buyer. Optional field. If the value for this field (the tag is not sent) is not provided, the system defaults it to 'False'. Valid values are 'True' or 'False'. This field can be set to true only if the bank Boost Payment option is set to 'True'.
RVAReconciliationFileConfig:
type: object
properties:
commFileId:
maxLength: 40
type: string
description: Comm file Id refers to Comm File info associated with the Request Virtual Account recon file outbound delivery. Required if RVAReconFileDelivery is set to Comms
templateId:
maxLength: 2
type: string
description: Denotes the template identifier associated with the RVA recon template to be used for generating the RVA recon file.
GetBuyerResponseV2-3:
required:
- messageId
- statusCode
- statusDesc
type: object
properties:
messageId:
maxLength: 36
type: string
description: Unique identifier which was sent in the request.
vanConfig:
$ref: '#/components/schemas/VanConfigForGet'
statusCode:
maxLength: 6
type: string
description: Status code of the response. It is alphanumeric. The values are specific to each method. For the details of the various error codes returned for this method refer to the "Error Codes" table below.
statusDesc:
maxLength: 255
type: string
description: Status description of the response.
contactInfo:
$ref: '#/components/schemas/ContactInfoForGet'
proxyConfig:
$ref: '#/components/schemas/ProxyConfigForGet'
billingConfig:
$ref: '#/components/schemas/BillingConfigForGet'
paymentConfig:
$ref: '#/components/schemas/PaymentConfigForGet'
processorConfig:
$ref: '#/components/schemas/ProcessorConfigForGet'
stpPaymentConfig:
$ref: '#/components/schemas/StpPaymentConfigForGet'
paymentFileConfig:
$ref: '#/components/schemas/PaymentFileCommConfigForGet'
webServicesConfig:
$ref: '#/components/schemas/WebServicesConfigForGetV2-1'
boostPaymentConfig:
$ref: '#/components/schemas/BoostPaymentConfigForGet'
buyerFeatureConfig:
$ref: '#/components/schemas/BuyerFeatureConfigForGetV2'
responseFileConfig:
$ref: '#/components/schemas/ResponseFileConfigForGet-1'
stripePaymentConfig:
$ref: '#/components/schemas/StripePaymentConfigForGet'
paymentSecurityConfig:
$ref: '#/components/schemas/PaymentSecurityConfigForGet'
approvalWorkflowConfig:
$ref: '#/components/schemas/ApprovalWorkflowConfigForGet'
reconciliationFileConfig:
$ref: '#/components/schemas/ReconciliationFileConfigForGet-1'
paymentNotificationConfig:
$ref: '#/components/schemas/PaymentNotificationConfigForGet'
authorizationControlConfig:
$ref: '#/components/schemas/AuthorizationControlConfigForGet'
rvaReconciliationFileConfig:
$ref: '#/components/schemas/RvaReconciliationFileConfigForGet-1'
description: Get Buyer Response Class
ProcessorConfig:
type: object
properties:
closeAccount:
type: boolean
description: Denotes if the account needs to be closed at the processor. For VIP Pseudo accounts, if this field is set to true, the pseudo account will be closed at the Visa Token System. Valid Values are True or False.
BuyerFeatureConfig:
type: object
properties:
cardMaskingDigits:
maxLength: 2
pattern: ^[\d]+$
type: string
description: Denotes the number of digits that will be masked for the card number when displayed in all places other than UI like the recon file, response file, etc. Should be Numeric. Should be between 4 and 12
vcfDataFeedIndicator:
type: string
description: 'The vcfDataFeedIndicator is used for indicating the source of transactions/settlement data for this company. This value should be “Yes” if the FI/Processor is going to send settled transactions for the company [e.g. inbound Visa Commercial Format (VCF)]. It should be “No” if the company requires Visa to pull the settlement data over the Visa Network. '
pseudoAccountsEnabled:
type: boolean
description: Denotes if "Pseudo Accounts" (VIP Tokens) option is enabled for the template (buyers). Valid Values are 'True' and 'False'. If the value for this field (the tag is not sent) is not provided, the system defaults it false. The value can be set to true only if the bank is enabled for this Option.
fullAccountViewEnabled:
type: boolean
description: Denotes if "Full Account View" functionality is enabled for the template (buyers). Valid Values are 'True' and 'False'. If the value for this field (the tag is not sent) is not provided, the system defaults it to the bank setting for this field. The value can be set to true only if the bank is enabled for this functionality.
cardMaskingDigitsOnline:
maxLength: 2
pattern: ^[\d]+$
type: string
description: Denotes the number of digits that will be masked for the card number when displayed in the UI. Should be Numeric. Should be between 4 and 12
onlinePaymentInstructionEnabled:
type: boolean
description: Denotes if Online payment instruction (Pay Now) functionality is enabled for the template (buyers). Valid Values are 'True' and 'False'. If the value for this field (the tag is not sent) is not provided, the system defaults it to False. The value can be set to true only if the bank is enabled for Online Payment Instructions.
onlinePaymentRequisitionEnabled:
type: boolean
description: Denotes if Online payment Requisition functionality is enabled for the template (buyers). Valid Values are 'True' and 'False'. If the value for this field (the tag is not sent) is not provided, the system defaults it to False. The value can be set to true only if the bank is enabled for Online Payment Requisitions.
ContactInfoForUpdate:
required:
- buyerId
type: object
properties:
city:
maxLength: 20
type: string
description: Contains the City Name of the buyer's contact address. This field can be updated at any time.
state:
maxLength: 27
type: string
description: Contains the state of the buyer's contact address. This field can be updated at any time.
phone1:
maxLength: 20
type: string
description: Contains the buyer contact phone number 1. Field is alphanumeric. Special characters allowed are - (dash), ( (Open braces),) (close braces). This field can be updated at any time.
phone2:
maxLength: 20
type: string
description: Contains the buyer contact phone number 2. Field is alphanumeric. Special characters allowed are - (dash), ( (Open braces),) (close braces). This field can be updated at any time.
phone3:
maxLength: 20
type: string
description: Contains the buyer contact phone number 3. Field is alphanumeric. Special characters allowed are - (dash), ( (Open braces),) (close braces). This field can be updated at any time.
buyerId:
maxLength: 25
pattern: ^[\d]+$
type: string
description: Contains the buyer identifier as defined in Visa Payables Automation. This is often the ID defined at the processor. Value format is 0–9. This field is mandatory and needs to be sent to identify the buyer. This field cannot be updated.
zipCode:
maxLength: 9
type: string
description: Optional. Contains the Postal Code of the buyer's contact address. Do not include special characters, e.g. hyphen, in the zipcode. If a special character is provided it will be removed and processed with only nine digits. Null is allowed.
phone1Ext:
maxLength: 20
type: string
description: Contains the extension of the buyer contact phone number 1. Field is alphanumeric. Special characters allowed are - (dash), ( (Open braces),) (close braces). This field can be updated at any time.
phone2Ext:
maxLength: 20
type: string
description: Contains the extension of the buyer contact phone number 2. Field is alphanumeric. Special characters allowed are - (dash), ( (Open braces),) (close braces). This field can be updated at any time.
phone3Ext:
maxLength: 20
type: string
description: Contains the extension of the buyer contact phone number 3. Field is alphanumeric. Special characters allowed are - (dash), ( (Open braces),) (close braces). This field can be updated at any time.
contactName:
maxLength: 100
type: string
description: Contains the name of the primary contact person in the buyer. Field is alphanumeric. This field can be updated at any time.
countryCode:
maxLength: 3
pattern: ^[a-zA-Z]{3}$
type: string
description: Contains the ISO alpha country code of the buyer's contact address. For example- USA. This field can be updated at any time.
addressLine1:
maxLength: 40
type: string
description: Contains the line 1 of the buyer's contact address. This field can be updated at any time.
addressLine2:
maxLength: 40
type: string
description: Contains the line 2 of the buyer's contact address. This field can be updated at any time.
addressLine3:
maxLength: 80
type: string
description: Contains the line 3 of the buyer's contact address. This field can be updated at any time.
emailAddress:
maxLength: 100
type: string
description: Contains the buyer's contact Email Address. Should be a valid email address. This field will be updated only if VPC is not enabled. If VPC is enabled, this field can be updated only if there are no accounts setup for the buyer.
implementationType:
type: integer
description: Valid Values are:1 – VPA UI, 2 – VPA API and 3 – Visa Commercial Pay. Select 1 if buyer will use VPA user interface (issuer direct use of VPA). Select 2 if buyer is created by a third party fintech and will use the VPA APIs. Select 3 if buyer is created in VPA for Visa Commercial Pay service.
UpdatePaymentNotificationConfig:
type: object
properties:
dateFormat:
maxLength: 10
type: string
description: Denotes the date format which will be used for parsing date fields in the payment files in EDI or CVV tab format. Should be one of the VPA system supported date formats. This field can be updated at any time. Refer to Date Formats table.
defaultBuyerLanguageCode:
maxLength: 10
type: string
description: Denotes the language which will be used in notifications sent to the buyer. A valid locale (language code) should be provided. For example "en_US" for US english. Refer to the Language Code table for langauge codes. This field can be updated at any time.
attachRemittanceFileDetails:
type: boolean
description: Denotes if the remittance details file (containing the invoice details) will be attached to the payment advice notification while processig a payment. Valid values are 'True' or 'False'. This field can be set to true only if the bank attach remittance details file option is set to 'True'. This field can be edited at any time.
supplierReminderNotificationDays:
maxLength: 2
pattern: ^[\d]*$
type: string
description: Denotes the number of days before the payment expiration date when the system sends a reminder notification to the supplier. Should be between 0 and 100. This value should be specified only when suppress supplier notification is disabled and supplier reminder notification is enabled for the template. This field can be edited at any time.
supplierReminderNotificationEnabled:
type: boolean
description: Denotes if the system will send the payment reminder notification to the supplier (before the configured number of days (supplier reminder notification days) from the payment expiration date) to remind them to collect the payment. This field can be set to true only if the bank supplier reminder notification option is set to 'True' and suppress supplier notification option for the template is set to false. This field can be edited at any time.
UpdateProcessorConfig:
type: object
properties:
closeAccount:
type: boolean
description: Used to close an account
ProcessorConfigForGet:
type: object
properties:
embossedLine2:
type: string
description: Denotes the default embossedLine2 for cards. This usually is the buyer name prefixed by a running number for FIS and buyer name followed by a running number for other processors
readOnly: true
processorFields:
type: object
additionalProperties:
type: object
properties: {}
suaEmbossedLine1:
type: string
description: Denotes the default embossedLine1 for SUA cards. This usually is the buyer name prefixed by a running number for FIS and buyer name followed by a running number for other processors
readOnly: true
closeAccountEnabled:
type: boolean
description: Default to Yes if processor integration is enabled for the bank. Default to N if Processor integration is not enabled for the bank. Default to Y if the buyer is enabled for VIP/VPP tokens.
lodgedEmbossedLine1:
type: string
description: Denotes the default embossedLine1 for lodged cards. This usually is the Supplier name prefixed by a running number for FIS and Supplier name followed by a running number for other processors
readOnly: true
description: 'This section is used if the issuer has processor integration enabled. When using processor PANs, the following processors can be enabled for processor integration: FIS, FDR, TS1, TS2, and TSUK. When using Visa Pseudo accounts or TSYS VANs, processor integration is not required but if it is enabled the system goes to the processor to retrieve the latest values (such as expiry date, current balance and available balance for the funding accounts). The fields vary for each processor so refer to the details Buyer Setup Details page for more information on which fields are required for each processor. If using TSYS VPP VANs or Visa VIP Pseudo Accounts, defaults values can be used. Please refer to the Buyer Setup Details page for the defaults'
GetPaymentNotificationConfig:
type: object
properties:
dateFormat:
maxLength: 10
type: string
description: Denotes the date format which will be used for parsing date fields in the payment files in EDI or CVV tab format.
defaultBuyerLanguageCode:
maxLength: 10
type: string
description: Denotes the language (Locale like for e.g. en_US for US english ) which will be used in notifications sent to the buyer.
attachRemittanceFileDetails:
type: boolean
description: Denotes if the remittance details file (containing the invoice details) will be attached to the payment advice notification while processig a payment.
supplierReminderNotificationDays:
maxLength: 2
pattern: ^[\d]+$
type: string
description: Denotes the number of days before the payment expiration date when the system sends a reminder notification to the supplier.
supplierReminderNotificationEnabled:
type: boolean
description: Denotes if the system will send the payment reminder notification to the supplier (before the configured number of days (supplier reminder notification days) from the payment expiration date) to remind them to collect the payment.
StripePaymentConfigForCreate:
type: object
properties:
stripePaymentEnabled:
type: boolean
description: Denotes if Stripe payments is enabled for the buyer. Optional field. If the value for this field (the tag is not sent) is not provided, the system defaults it to 'False'. Valid values are 'True' or 'False'. This field can be set to true only if the bank Stripe Payment option is set to 'True'.
remittanceNotificationEnabled:
type: boolean
description: Denotes if the Stripe Payment Remittance notification is enabled for a buyer. Optional field. If the value for this field (the tag is not present) is not provided, the system defaults it to 'False'. Valid values are 'True' or 'False'. This field can be set to true only if the bank Stripe Payment Remittance Notification option is set to 'True'. The Stripe supplier will be getting the payment remittance notification only if this field is enabled.
VanConfig:
type: object
properties:
fcsBankId:
maxLength: 4
type: string
description: Denotes the Bank Identifier in the TSYS VPP FCS system. If the value for this field (the tag is not sent) is not provided, the system defaults it to the bank FCS ID if there is only one setup at the bank level. Supports alphanumeric values. Required if the template is enabled for VANs.
vanEnabled:
type: boolean
description: Denotes if "VANs" (VPP Tokens) are enabled for the template (buyers). Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for this Option.
PaymentFileCommConfigForGet:
type: object
properties:
edi824FileId:
maxLength: 40
type: string
description: Denotes the Comm File ID associated with the EDI 824 outbound response file.
edi997FileId:
maxLength: 40
type: string
description: Denotes the Comm File ID associated with the EDI 997 outbound ack file.
inboundFileId:
maxLength: 40
type: string
description: Denotes the Comm file ID associated with the inbound payment file (EDI 820 or SFF).
UpdateVanConfig:
type: object
properties:
fcsBankId:
maxLength: 4
type: string
description: Denotes the Bank Identifier in the TSYS VPP FCS system. Supports alphanumeric values. Required if the template is enabled for VANs. Can be set at any time if it is blank. But cannot be changed if it is already set if the sync Buyer Profiles field is set to true.
vanEnabled:
type: boolean
description: Denotes if "VANs" (VPP Tokens) are enabled for the template (buyers). Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for this Option. Can be set to true any time. But cannot be disabled if the sync Buyer Profiles field is set to true.
WebServicesConfig:
type: object
properties:
apiCodes:
maxItems: 200
uniqueItems: true
type: array
items:
maxLength: 10
type: string
description: Reserved for Future use. The system will default the apiCodes to what is set for the bank.
clientId:
maxLength: 40
type: string
description: Reserved for Future use. The system will default the client ID to what is set for the bank.
vbdsClientId:
maxLength: 50
type: string
description: vbdsClientId is the unique id generated for third parties wanting to subscribe for auth/settlement data in VBDS system. Should be alphanumeric.
webServicesEnabled:
type: boolean
description: Denotes if the web services is enabled for the template (Buyer). Valid Values are 'True' and 'False'. If the value for this field (the tag is not sent) is not provided, the system defaults it false. The value can be set to true only if the bank is enabled for this Option.
suppressSupplierNotification:
type: boolean
description: Denotes if all supplier notifications needs to be suppressed. Valid Values are 'True' or 'False'. If this field is set to true, then the web service consumers should handle the supplier communication themselves. If the value for this field (the tag is not sent) is not provided, the system defaults it to False.
UpdatePaymentSecurityConfig:
type: object
properties:
customSecurityQuestions:
maxItems: 3
uniqueItems: true
type: array
description: The questions (text) which will be used at random (Only one of the questions will be displayed) to authenticate the supplier when they click on the URL sent in the payment advice notification for viewing the full card details. The system sends the security questions and answers to the supplier when the supplier is setup for the buyer. At least one question needs to be sent if custom security question is enabled for the template. This can be edited at any time and will take into effect only for future payments.
items:
maxLength: 100
type: string
description: SThe size of the field should not exceed 100
defaultSecurityQuestion:
maxLength: 256
type: string
description: Denotes the text for the default security question which will be displayed to the supplier when they click on the URL sent in the payment advice notification for viewing the full card details. This field can be edited at any time.
defaultSecurityFieldCode:
maxLength: 1
pattern: ^[\d]+$
type: string
description: Denotes the field system uses to authenticate the supplier when they click on the URL sent in the payment advice notification for viewing the full card details. Valid values are '1' - Postal code and '2' - Supplier ID. If the value for this field (the tag is not sent) is not provided, the system defaults it to '1'. The default security is used only when the system creates new suppliers while processing payment files (EDI 820) or if custom security question is not enabled. This field can be edited at any time.
customSecurityQuestionsEnabled:
type: boolean
description: Denotes if the buyer wants to use custom security questions to authenticate the supplier when they click on the URL sent in the payment advice notification for viewing the full card details. Valid values are 'True' and 'False'. This field can be set to True only if the bank custom security questions option is set to True. This field can be edited at any time.
BuyerFeatureConfigForGet:
type: object
properties:
cardMaskingDigits:
maxLength: 2
pattern: ^[\d]+$
type: string
description: Denotes the number of digits that will be masked for the card number when displayed in all places other than UI like the recon file, response file, etc.
pseudoAccountsEnabled:
type: boolean
description: Denotes if "Pseudo Accounts" (VIP Tokens) option is enabled for the buyer.
fullAccountViewEnabled:
type: boolean
description: Denotes if "Full Account View" functionality is enabled for the buyer.
cardMaskingDigitsOnline:
maxLength: 2
pattern: ^[\d]+$
type: string
description: Denotes the number of digits that will be masked for the card number when displayed in the UI.
onlinePaymentInstructionEnabled:
type: boolean
description: Denotes if Online payment instruction (Pay Now) functionality is enabled for the buyer.
onlinePaymentRequisitionEnabled:
type: boolean
description: Denotes if Online payment Requisition functionality is enabled for the buyer.
CreateBuyerRequest-3:
required:
- clientId
- contactInfo
- messageId
type: object
properties:
clientId:
maxLength: 25
type: string
description: ClientID uniquely identifies a financial institution. This will be provided by Visa implementation team.
messageId:
maxLength: 36
type: string
description: Unique identifier for identifying the request.
vanConfig:
$ref: '#/components/schemas/VanConfigForCreate'
contactInfo:
$ref: '#/components/schemas/ContactInfoForCreate-1'
proxyConfig:
$ref: '#/components/schemas/ProxyConfigForCreate'
billingConfig:
$ref: '#/components/schemas/BillingConfigForCreate'
paymentConfig:
$ref: '#/components/schemas/PaymentConfigForCreate'
processorConfig:
$ref: '#/components/schemas/ProcessorConfigForCreate'
stpPaymentConfig:
$ref: '#/components/schemas/StpPaymentConfigForCreate'
paymentFileConfig:
$ref: '#/components/schemas/PaymentFileCommConfigForCreate'
webServicesConfig:
$ref: '#/components/schemas/WebServicesConfigForCreate-2'
boostPaymentConfig:
$ref: '#/components/schemas/BoostPaymentConfigForCreate'
buyerFeatureConfig:
$ref: '#/components/schemas/BuyerFeatureConfigForCreate'
responseFileConfig:
$ref: '#/components/schemas/ResponseFileConfigForCreate-1'
stripePaymentConfig:
$ref: '#/components/schemas/StripePaymentConfigForCreate'
paymentSecurityConfig:
$ref: '#/components/schemas/PaymentSecurityConfigForCreate'
approvalWorkflowConfig:
$ref: '#/components/schemas/ApprovalWorkflowConfigForCreate'
reconciliationFileConfig:
$ref: '#/components/schemas/ReconciliationFileConfigForCreate-1'
paymentNotificationConfig:
$ref: '#/components/schemas/PaymentNotificationConfigForCreate'
authorizationControlConfig:
$ref: '#/components/schemas/AuthorizationControlConfigForCreate'
rvaReconciliationFileConfig:
$ref: '#/components/schemas/RvaReconciliationFileConfigForCreate-1'
description: Buyer Profile Details for creating a new buyer.
GetAuthorizationControlConfig:
type: object
properties:
alertsEnabled:
type: boolean
description: Denotes if the system needs to send an alert when an authorization on a VPC enabled card is approved or declined.
issuerHoldingBID:
maxLength: 8
pattern: ^[\d]+$
type: string
description: Denotes the Holding BID (business id) for the issuer.
authControlEnabled:
type: boolean
description: Denotes if the authorization controls needs to be enabled for the template (in turn the buyer). Auth controls is mandated for VPP and VIP buyers.
UpdateWebServicesConfig:
type: object
properties:
apiCodes:
maxItems: 200
uniqueItems: true
type: array
items:
maxLength: 10
type: string
description: Reserved for Future use. The system will default the apiCodes to what is set for the bank.
clientId:
maxLength: 40
type: string
description: Reserved for Future use. The system will default the client ID to what is set for the bank.
vbdsClientId:
maxLength: 50
type: string
description: vbdsClientId is the unique id generated for third parties wanting to subscribe for auth/settlement data in VBDS system. Should be alphanumeric. Can be set at any time if it is blank. But cannot be changed if it is already set if the sync Buyer Profiles field is set to true.
webServicesEnabled:
type: boolean
description: Denotes if the web services is enabled for the template (Buyer). Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for this Option. Can be enabled (set to true) at any time. But cannot be disabled if sync Buyer Profiles field is set to true.
suppressSupplierNotification:
type: boolean
description: Denotes if all supplier notifications needs to be suppressed. If this field is set to true, then the web service consumers should handle the supplier communication themselves. Valid Values are 'True' or 'False'. This field can be edited at any time.
UpdateSTPPaymentConfig:
type: object
properties:
stpPaymentEnabled:
type: boolean
description: Denotes if the STP Payments is enabled for a template (buyer).Optional field. Valid values are 'True' or 'False'. This field can be set to true only if the bank STP Payments option is set to 'True'. This field can be enabled (set to true) at any time but cannot be disabled if the sync Buyer Profiles is set to true.
remittanceNotificationEnabled:
type: boolean
description: Denotes if the STP Payment Remittance notification is enabled for a template (buyer). Valid values are 'True' or 'False'. This field can be set to true only if the bank STP Payment Remittance Notification option is set to 'True'. Only if this field is enabled, the STP supplier will be getting the payment remittance notification. This field can be edited at any time.
BillingConfigForCreate:
type: object
properties:
billingBID:
type: string
description: The 11 digit Visa Billing BID that will be billed for the service. This is in the format of 8 digit Visa BID plus 3 digit country code. E.g. 12345678840 where 840 is country code for United States.
billingType:
type: string
description: Identifies who will be billed for use of the service. I indicates issuer will be billed (standard). T indicates Third party / fintech will be billed. M indicates manual billing is set up.
GetProcessorConfig:
type: object
properties:
closeAccount:
type: boolean
description: Used to close an account
ApprovalWorkflowConfigForUpdate:
type: object
properties:
workflowConfigEnabled:
type: boolean
description: Denotes if the Approval Workflow is enabled for the Buyer. Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for this Option. This field can be updated to true at any time. But cannot be updated to false.
workflowFunctionCodes:
uniqueItems: true
type: array
description: Denotes the codes for the functionalities for which Approval Workflow needs to be enabled. Valid Values are AUCL - Card Limit Update, LCRC - Lodge/New Card, PYIN - Payment Instruction, PYRN - Payment Requisition At least one function should be passed in this field if workflowconfigenabled field is set to true for the buyer. This field can be updated at any time.
items:
pattern: ^[a-zA-Z]{4}$
type: string
enum:
- AUCL
- LCRC
- PYIN
- PYRN
GetBuyerTemplateSuccessResponseV2:
type: object
properties:
responseObject:
$ref: '#/components/schemas/GetBuyerTemplateResponseV2'
responseStatus:
$ref: '#/components/schemas/Response'
description: Get Buyer Template Success Response V2
CreateBuyerTemplateResponse:
required:
- templateId
type: object
properties:
templateId:
maxLength: 30
type: string
description: Unique Identifier for a Template. It should be alphanumeric. Should be an existing template id associated with the bank (associated to the client id). The template id is returned in the response of the CreateTemplate API.
description: Create Buyer Template Response
UpdateBuyerTemplateResponse:
required:
- templateId
type: object
properties:
templateId:
maxLength: 30
type: string
description: Unique Identifier for a Template. It should be alphanumeric. Should be an existing template id associated with the bank (associated to the client id). The template id is returned in the response of the CreateTemplate API.
description: Update Buyer Template Response
PaymentNotificationConfigForCreate:
type: object
properties:
dateFormat:
type: string
description: Denotes the date format which will be used for parsing date fields in the payment files in EDI or CSV or tab format. Should be one of the VPA system supported date formats. This field is required. Refer to Date Formats table.
format: date
defaultBuyerLanguageCode:
maxLength: 10
type: string
description: Denotes the language which will be used in notifications sent to the buyer. A valid locale (language code) should be provided. For example "en_US" for US english. If the value for this field is not provided, the system defaults it to 'en_US'. Refer to the Language Code table for langauge codes.
example: en_us
attachRemittanceDetailsFile:
type: boolean
description: Denotes if the remittance details file (containing the invoice details) will be attached to the payment advice notification while processig a payment. Optional field. If the value for this field (the tag is not sent) is not provided, the system defaults it to value set for this option for the bank. Valid values are 'True' or 'False'. This field can be set to true only if the bank attach remittance details file option is set to 'True'.
supplierReminderNotificationDays:
maxLength: 2
pattern: ^[\d]+$
type: string
description: Denotes the number of days before the payment expiration date when the system sends a reminder notification to the supplier. Optional Field. If the value for this field (the tag is not sent) is not provided, the system defaults it to 7 days. Should be between 0 and 100. This value should be specified only when suppress supplier notification is disabled and supplier reminder notification is enabled for the buyer.
supplierReminderNotificationEnabled:
type: boolean
description: Denotes if the system will send the payment reminder notification to the supplier (before the configured number of days (supplier reminder notification days) from the payment expiration date) to remind them to collect the payment. If the value for this field (the tag is not sent) is not provided, the system defaults it to 'False' if the suppress supplier notification is enabled and to 'True' if the suppress supplier notifiation is disabled. This field can be set to true only if the bank supplier reminder notification option is set to 'True' and suppress supplier notification option for the buyer is set to false.
PaymentConfigForGet:
type: object
properties:
expirationDays:
maxLength: 3
pattern: ^[\d]+$
type: string
description: Default payment expiration days which will be used if the buyer did not provide the payment expiration date either in the payment or has not configured for the supplier. The payment expiration days will be used to calculate the payment expiration date (payment process date + the payment expiration days) which is the last day by which the supplier should collect the payment.
billingCurrency:
maxLength: 3
pattern: ^[a-zA-Z]{3}$
type: string
description: Denotes the ISO alpha currency code associated with the billing Currency of the card accounts belonging to the buyer. All ISO alpha currency codes will be supported. For example- USD for US Dollar. VPA system uses the billing currency as the payment currency for adjustable limit card accounts.
allowableCurrencies:
maxItems: 200
uniqueItems: true
type: array
description: The list of currencies allowed for the buyer. The buyer can process payments in any of these currencies. Any payments made using any other currencies will be rejected. All ISO alpha currency codes will be supported. For example- USD for US Dollar.
items:
pattern: ^[a-zA-Z]{3}$
type: string
defaultSecurityCode:
type: boolean
description: Denotes if the security code needs to be enabled by default for all the new suppliers created.
readOnly: true
paymentAdviceOption:
maxLength: 1
type: string
description: This option is used by the system to decide if all payments to the same supplier should be consolidated or sent separately in the payment advice notificaion.
expirationBufferDays:
maxLength: 2
pattern: ^[\d]+$
type: string
description: expirationBufferDays is the number of days after the payment expiration date by which the supplier needs to complete the collection of the payment (settlement of the card transaction should be completed).
securityCodeRequired:
type: boolean
description: Denotes if security code is needed for the supplier to collect the payment.
GetBuyerFeatureConfigV2:
type: object
properties:
cardMaskingDigits:
maxLength: 2
pattern: ^[\d]+$
type: string
description: Denotes the number of digits that will be masked for the card number when displayed in all places other than UI like the recon file, response file, etc.
vcfDataFeedIndicator:
type: string
description: 'The vcfDataFeedIndicator is used for indicating the source of transactions/settlement data for this company. This value should be “Yes” if the FI/Processor is going to send settled transactions for the company [e.g. inbound Visa Commercial Format (VCF)]. It should be “No” if the company requires Visa to pull the settlement data over the Visa Network. '
pseudoAccountsEnabled:
type: boolean
description: Denotes if "Pseudo Accounts" (VIP Tokens) option is enabled for the template (buyers).
fullAccountViewEnabled:
type: boolean
description: Denotes if "Full Account View" functionality is enabled for the template (buyers).
cardMaskingDigitsOnline:
maxLength: 2
pattern: ^[\d]+$
type: string
description: Denotes the number of digits that will be masked for the card number when displayed in the UI.
onlinePaymentInstructionEnabled:
type: boolean
description: Denotes if Online payment instruction (Pay Now) functionality is enabled for the template (buyers).
onlinePaymentRequisitionEnabled:
type: boolean
description: Denotes if Online payment Requisition functionality is enabled for the template (buyer).
ReconciliationFileConfigForCreate-1:
type: object
properties:
fileLevel:
maxLength: 1
type: string
description: Denotes if the recon COMM File configuration is defined to be delivered to the bank(B) or Company (C). Valid values are B - Bank and C - Company.
commFileId:
maxLength: 40
type: string
description: Denotes the Comm File ID associated with the recon file outbound. Required if the file level is B. The Visa implementation team provides this value after the outbound recon file configuration has been completed.
fileFormat:
type: integer
description: Denotes the format in which the recon file needs to be generated. Needs to be numeric. Valid values are 1 – XLS V0, 2 – CSV V0, 3 - XLS V1, 4 – CSV V1
deliveryTime:
maxLength: 6
type: string
description: Denotes the delivery type or day when the recon file needs to be generated and delivered. If the value for this field (the tag is not sent) is not provided, the system defaults it to'1:00' AM for the daily frequency and 2 for weekly and 1 for monthly frequency. Valid format for the time for the daily frequency is 'HH:MM' in 24 hours format. Valid values for the Weekly frequency 1 to 7 denoting the days. 1 being Sunday and 7 being Saturday and Monthly Frequency 1 to 31
templateName:
maxLength: 100
type: string
description: Denotes the name of the recon template to be used for generating the reconciliation file. If the value for this field (the tag is not sent) is not provided, the system defaults it to the latest recon standard template.
deliveryFrequency:
type: integer
description: Denotes the frequency in which the recon file needs to be delivered. Needs to be numeric. Valid values are 1 – Daily 2 – Weekly 3 - Monthly
recipientLoginIds:
maxItems: 80
uniqueItems: true
type: array
description: Contains the list of user ids of bank/buyer users who will be receiving the recon file in their VOL mailbox. You can setup upto 80 user ids to receive the recon file. The user ids should have the VOL mailbox service entitled to them.
items:
type: string
adhocReconciliationReportEnabled:
type: boolean
description: Denotes if Adhoc Reconciliation functionality is enabled for the buyer. If the value for this field (the tag is not sent) is not provided, the system defaults it to False. Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for Adhoc Reconciliation.
onlinePaymentReconciliationEnabled:
type: boolean
description: Denotes if Online payment Reconciliation functionality is enabled for the buyers. If the value for this field (the tag is not sent) is not provided, the system defaults it to False. Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for Online Payment Reconciliation.
GetReconciliationFileConfig:
type: object
properties:
commFileId:
maxLength: 40
type: string
description: Comm file Id refers to Comm File info associated with the recon file outbound delivery.Required if ReconFileDelivery is set to Comms.
templateName:
maxLength: 100
type: string
description: Denotes the name of the custom Reconciliation template to be used for generating the reconciliation file for all buyers using the template.
adhocReconciliationReportEnabled:
type: boolean
description: Denotes if Adhoc Reconciliation functionality is enabled for the template (buyers).
onlinePaymentReconciliationEnabled:
type: boolean
description: Denotes if Online payment Reconciliation functionality is enabled for the template (buyers).
UpdateBoostPaymentConfig:
type: object
properties:
boostPaymentEnabled:
type: boolean
description: Denotes if the Boost Payments is enabled for a template (buyer).Optional field. Valid values are 'True' or 'False'. This field can be set to true only if the bank Boost Payments option is set to 'True'. This field can be enabled (set to true) at any time but cannot be disabled if the sync Buyer Profiles is set to true.
ProxyConfigForGet:
type: object
properties:
holdDays:
maxLength: 3
pattern: ^[\d]+$
type: string
description: Denotes the number of days an account picked up for a payment in a proxy will be kept on hold before being used for another payment. For payments, the hold days start from the day the payment was processed and for Request Virtual Account, the hold days start from the day the end date of the RVA has reached.
autoRefreshEnabled:
type: boolean
description: Denotes if auto replenishment is enabled for proxies associated with the buyer.
bucketedProxyEnabled:
type: boolean
description: Denotes if bucketed proxy is enabled for proxies associated with the buyer. Valid Values are 'True' and 'False'.
WebServicesConfigForGet:
type: object
properties:
apiCodes:
maxItems: 200
uniqueItems: true
type: array
description: Denotes the codes associated with APIs which needs to be enabled for the buyer. The APIs should be a subset of what is enabled for the bank. The API codes and the corresponding APIs can be found below ....
items:
maxLength: 10
type: string
clientId:
maxLength: 40
type: string
description: Denotes the client id associated with the bank under which the buyer is being created. The Visa implementation team will be providing this.
vbdsClientId:
maxLength: 50
type: string
description: vbdsClientId is the unique id generated for third parties wanting to subscribe for auth/settlement data in VBDS system.
webServicesEnabled:
type: boolean
description: Denotes if the web services is enabled for the Buyer. Valid Values are 'True' and 'False'.
suppressSupplierNotification:
type: boolean
description: Denotes if all supplier notifications needs to be suppressed. If this field is set to true, then the web service consumers should handle the supplier communication themselves. Valid Values are 'True' or 'False'.
PaymentNotificationConfigForGet:
type: object
properties:
dateFormat:
type: string
description: Denotes the date format which will be used for parsing date fields in the payment files in EDI or CSV or tab format.
format: date
settlementSource:
type: string
description: Denotes if the settlement is sourced from VIDS (1) or from VCF (2).
readOnly: true
paymentAdviceTemplate:
type: string
description: Denotes the name of the email template which will be used for generating the email notifications.
readOnly: true
defaultBuyerLanguageCode:
maxLength: 10
type: string
description: Denotes the language which will be used in notifications sent to the buyer.
example: en_us
attachRemittanceDetailsFile:
type: boolean
description: Denotes if the remittance details file (containing the invoice details) will be attached to the payment advice notification while processig a payment.
supplierReminderNotificationDays:
maxLength: 2
pattern: ^[\d]+$
type: string
description: Denotes the number of days before the payment expiration date when the system sends a reminder notification to the supplier.
defaultAttachRemittanceDetailsFile:
type: boolean
description: Denotes if the “Attach Remittance Details” option needs to be enabled by default for all the new suppliers created.
readOnly: true
supplierReminderNotificationEnabled:
type: boolean
description: Denotes if the system will send the payment reminder notification to the supplier (before the configured number of days (supplier reminder notification days) from the payment expiration date) to remind them to collect the payment.
defaultSupplierReminderNotificationEnabled:
type: boolean
description: Denotes if the “Reminder Notification” option needs to be enabled by default for all the new suppliers created.
readOnly: true
UpdateAuthorizationControlConfig:
type: object
properties:
alertsEnabled:
type: boolean
description: Denotes if the system needs to send an alert when an authorization on a VPC enabled card is approved or declined. Valid values are 'True' and 'False'. This field can be set to True only if the authControlEnabled is set to true for the template. This field can be edited only if the sync Buyer Profiles is set to false.
issuerHoldingBID:
maxLength: 8
pattern: ^[\d]*$
type: string
description: Denotes the Holding BID (business id) for the issuer. Should be numeric. Should be set only if authControlEnabled is set to true for the template. This field can be edited only if the sync Buyer Profiles is set to false.
authControlEnabled:
type: boolean
description: Denotes if the authorization controls needs to be enabled for the template (in turn the buyer). Auth controls is mandated for VPP and VIP buyers. Valid values are true or false. This field can be edited only if the sync Buyer Profiles is set to false.
UpdateContactInfo:
type: object
properties:
phone1:
maxLength: 20
type: string
description: Denotes the buyer contact phone number. Should be alphanumeric Can be updated at any time. Special characters allowed are - (dash), ( (Open braces),) (close braces).
emailAddress:
maxLength: 100
type: string
description: Denotes the buyer's contact Email Address. Should be an valid email address.
implementationType:
type: integer
description: Valid Values are:1 – VPA UI, 2 – VPA API and 3 – Visa Commercial Pay. Select 1 if buyer will use VPA user interface (issuer direct use of VPA). Select 2 if buyer is created by a third party fintech and will use the VPA APIs. Select 3 if buyer is created in VPA for Visa Commercial Pay service.
BoostPaymentConfigForGet:
type: object
properties:
boostPaymentEnabled:
type: boolean
description: Denotes if Boost payments is enabled for the buyer.
PaymentConfigForCreate:
type: object
properties:
expirationDays:
maxLength: 3
pattern: ^[\d]+$
type: string
description: Default payment expiration days which will be used if the buyer did not provide the payment expiration date either in the payment or has not configured for the supplier. The payment expiration days will be used to calculate the payment expiration date (payment process date + the payment expiration days) which is the last day by which the supplier should collect the payment. Only numbers are allowed. If the parameter is not provided, system default this value to 30.
billingCurrency:
maxLength: 3
pattern: ^[a-zA-Z]{3}$
type: string
description: Denotes the ISO alpha currency code associated with the billing Currency of the card accounts belonging to the buyer. All ISO alpha currency codes will be supported. For example- USD for US Dollar. It should be one of the supported active currencies in VPA. VPA system uses the billing currency as the payment currency for adjustable limit card accounts.
allowableCurrencies:
maxItems: 200
uniqueItems: true
type: array
description: The list of currencies allowed for the buyer. The buyer can process payments in any of these currencies. Any payments made other than these currencies will be rejected. All ISO alpha currency codes will be supported. For example- USD for US Dollar. It should be one of the supported active currencies in VPA. Can setup up to a max of 200 currencies. Billing currency should be present in the list else the system will automatically add it to the list. Defaults to the billing currency if not provided.
items:
pattern: ^[a-zA-Z]{3}$
type: string
paymentAdviceOption:
maxLength: 1
type: string
description: This option is used by the system to decide if all payments to the same supplier should be consolidated or sent separately in the payment advice notificaion. Optional field. If the value for this field (the tag is not sent) is not provided, the system defaults it to 'C'. Valid values are 'C' for consolidated or 'S' for split.
expirationBufferDays:
maxLength: 2
pattern: ^[\d]+$
type: string
description: expirationBufferDays is the number of days after the payment expiration date by which the supplier needs to complete the collection of the payment (settlement of the card transaction should be completed). Only numbers are allowed. If the parameter is not provided, system default this value to 5.
securityCodeRequired:
type: boolean
description: Denotes if security code is needed for the supplier to collect the payment. Optional field. If the value for this field (the tag is not sent) is not provided, the system defaults it to the value set for the bank for this field. Valid values are 'True' or 'False'. This field can be set to true only if the bank security code (CVV2) option is set to 'True'.
PaymentSecurityConfigForUpdate:
type: object
properties:
customSecurityQuestions:
maxItems: 3
uniqueItems: true
type: array
description: The questions (text) which will be used at random (Only one of the questions will be displayed) to authenticate the supplier when they click on the URL sent in the payment advice notification for viewing the full card details. The system sends the security questions and answers to the supplier when the supplier is setup for the buyer. At least one question needs to be sent if custom security question is enabled for the buyer. This field can be updated at any time and will be used only for future payments.
items:
maxLength: 100
type: string
defaultSecurityQuestion:
maxLength: 256
type: string
description: Denotes the text for the default security question which will be displayed to the supplier when they click on the URL sent in the payment advice notification for viewing the full card details. This field can be updated at any time and will be used only for future payments.
defaultSecurityFieldCode:
maxLength: 1
type: string
description: Denotes the field system uses to authenticate the supplier when they click on the URL sent in the payment advice notification for viewing the full card details. Valid values are '1' - Postal code and '2' - Supplier ID. The default security is used only when the system creates new suppliers while processing payment files (EDI 820) or if custom security question is not enabled. This field can be updated at any time and will be used only for future payments.
customSecurityQuestionsEnabled:
type: boolean
description: Denotes if the buyer wants to use custom security questions to authenticate the supplier when they click on the URL sent in the payment advice notification for viewing the full card details. Valid values are 'True' and 'False'. This field can be set to True only if the bank custom security questions option is set to True. This field can be updated at any time and will be used only for future payments.
GetBuyerFeatureConfig:
type: object
properties:
cardMaskingDigits:
maxLength: 2
pattern: ^[\d]+$
type: string
description: Denotes the number of digits that will be masked for the card number when displayed in all places other than UI like the recon file, response file, etc.
pseudoAccountsEnabled:
type: boolean
description: Denotes if "Pseudo Accounts" (VIP Tokens) option is enabled for the template (buyers).
fullAccountViewEnabled:
type: boolean
description: Denotes if "Full Account View" functionality is enabled for the template (buyers).
cardMaskingDigitsOnline:
maxLength: 2
pattern: ^[\d]+$
type: string
description: Denotes the number of digits that will be masked for the card number when displayed in the UI.
onlinePaymentInstructionEnabled:
type: boolean
description: Denotes if Online payment instruction (Pay Now) functionality is enabled for the template (buyers).
onlinePaymentRequisitionEnabled:
type: boolean
description: Denotes if Online payment Requisition functionality is enabled for the template (buyer).
WebServicesConfigForUpdate-1:
type: object
properties:
apiCodes:
maxItems: 200
uniqueItems: true
type: array
description: Reserved for Future use. The system will default the apiCodes to what is set for the bank.
items:
maxLength: 10
type: string
clientId:
maxLength: 40
type: string
description: Reserved for Future use. The system will default the client ID to what is set for the bank.
vbdsClientId:
maxLength: 50
type: string
description: vbdsClientId is the unique id generated for third parties wanting to subscribe for auth/settlement data in VBDS system. Should be numeric. This field can be editedat any time.
webServicesEnabled:
type: boolean
description: Denotes if the web services is enabled for the Buyer. Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for this Option. This field can be enabled at any time but cannot be disabled.
vbdsDataSubscription:
type: array
description: This complex element captures information about the subscription to Data APIs. This is optional and if this object is not provided, the subscription defaults to bank configuration for the given vbdsClientId.
items:
type: object
properties:
dataSubscriptionType:
type: number
description: 'This field is mandatory if vbdsDataSubcription object is provided. This field accepts the following subscription types. Provide the numeric code associated with the API(s) you want to subscribe to: 5001(Transaction Data API), 5003(Starter Data API), 5004(Authorization Data API (Pull)), 5005(Authorization Data API (Push))'
dataSubscriptionAccountType:
type: array
description: This is optional. If no value is provided, all the account types enabled at the bank level for the client are subscribed to the APIs specified in dataSubscriptionType. Subscribe/unsubscribe is allowed only for the account types enabled at the bank level for the provided client.
items:
type: object
properties:
subscribed:
type: boolean
description: 'This field indicates if the accountType should be susbcribed to the specified Data API(s). E.g. if you want to subscribe the account type to the API provide ''true'' here. To unsubscribe an account type to an API, provide ''false''. Valid Values are ''True'' and ''False''.The valid value must be provided for the account type. '
accountType:
type: string
description: 'This field accepts following values. Please use the 4-character alpha code: VIPT:VIP / Pseudo Account:Pseudo Account generated by Visa, NVPA:Non virtual account:Physical cards, MEMO:Processor account:Virtual accounts generated at the Processor, FUNA:Funding Account:Parent Account for Visa Pseudo Accounts or TSYS VPP VAN tokens, VPPT:VPP Token:TSYS generated tokens (Also referred to as TSYS VPP VANs)'
suppressSupplierNotification:
type: boolean
description: Denotes if all supplier notifications needs to be suppressed. If this field is set to true, then the web service consumers should handle the supplier communication themselves. Valid Values are 'True' or 'False'. This field can be updated at any time.
StripePaymentConfigForGet:
type: object
properties:
stripePaymentEnabled:
type: boolean
description: Denotes if Stripe payments is enabled for the buyer.
remittanceNotificationEnabled:
type: boolean
description: Denotes if the Stripe Payment Remittance notification is enabled for a buyer. The Stripe supplier will be getting the payment remittance notification only if this field is enabled.
RvaReconciliationFileConfigForGet:
type: object
properties:
fileLevel:
maxLength: 1
type: string
description: Denotes if the RVA recon COMM File configuration is defined to be delivered to the bank(B) or Company (C). Valid values are B - Bank and C - Company.
commFileId:
type: string
description: Denotes the Comm File ID associated with the RVA recon file outbound. The COMM file definition should exist in the system. The Visa implementation team provides this value after the outbound RVA recon file configuration has been completed.
fileFormat:
type: integer
description: Denotes the format in which the RVA recon file needs to be generated. Valid values are 1 – XLS V0, 2 – CSV V0, 3 - XLS V1, 4 – CSV V1
templateId:
maxLength: 5
type: string
description: Denotes the id of the recon template to be used for generating the RVA reconciliation file. Valid values are 1 - RVA Recon standard template Version 1.0
deliveryTime:
maxLength: 6
type: string
description: Denotes the delivery type or day when the RVA recon file needs to be generated and delivered. Valid format for the time for the daily frequency is 'HH:MM' in 24 hours format. Valid values for the Weekly frequency 1 to 7 denoting the days. 1 being Sunday and 7 being Saturday and Monthly Frequency 1 to 31
deliveryFrequency:
type: integer
description: Denotes the frequency in which the RVA recon file needs to be delivered. Valid values are 1 – Daily 2 – Weekly 3 - Monthly
recipientLoginIds:
maxItems: 50
uniqueItems: true
type: array
description: Contains the list of user ids of bank/buyer users who will be receiving the RVA recon file in their VOL mailbox.
items:
type: string
PaymentConfig:
required:
- billingCurrency
type: object
properties:
expirationDays:
maxLength: 3
pattern: ^[\d]+$
type: string
description: Default payment expiration days which will be used if the buyer did not provide the payment expiration date either in the payment or has not configured for the supplier. The payment expiration days will be used to calculate the payment expiration date (payment process date + the payment expiration days) which is the last day by which the supplier should collect the payment. Only numbers are allowed. If the parameter is not provided, system default this value to 30.
billingCurrency:
maxLength: 3
pattern: ^[a-zA-Z]{3}$
type: string
description: Denotes the ISO alpha currency code associated with the billing Currency of the card accounts belonging to the buyer. All ISO alpha currency codes will be supported. For example- USD for US Dollar. It should be one of the supported active currencies in VPA. VPA system uses the billing currency as the payment currency for adjustable limit card accounts.
allowableCurrencies:
maxItems: 200
uniqueItems: true
type: array
description: The list of currencies allowed for the buyer. The buyer can process payments in any of these currencies. Any payments made other than these currencies will be rejected. All ISO alpha currency codes will be supported. For example- USD for US Dollar. It should be one of the supported active currencies in VPA. Can setup up to a max of 200 currencies. Billing currency should be present in the list else the system will automatically add it to the list. Defaults to the billing currency if not provided.
items:
maxLength: 3
pattern: ^[a-zA-Z]{3}$
type: string
paymentAdviceOption:
maxLength: 1
type: string
description: Denotes if all payments to the same supplier in the same payment file will be consolidated and sent in one payment advice notification. Valid values are 'C' for consolidated or 'S' for split. Optional field. If the value for this field (the tag is not sent) is not provided, the system defaults it to 'C'.
expirationBufferDays:
maxLength: 2
pattern: ^[\d]+$
type: string
description: expirationBufferDays is the number of days after the payment expiration date by which the supplier needs to complete the collection of the payment (settlement of the card transaction should be completed). Only numbers are allowed. If the parameter is not provided, system default this value to 5.
securityCodeRequired:
type: boolean
description: Denotes if security code is needed for the supplier to collect the payment. Valid values are 'True' or 'False'. Optional field. If the value for this field (the tag is not sent) is not provided, the system defaults it to the value set for the bank for this field. This field can be set to true only if the bank security code (CVV2) option is set to 'True'.
GetResponseFileConfig:
type: object
properties:
commFileId:
maxLength: 40
type: string
description: Denotes the Comm File ID associated with the Response file outbound.
UpdateProxyConfig:
type: object
properties:
holdDays:
maxLength: 3
pattern: ^[\d]+$
type: string
description: Denotes the number of days an account picked up for a payment in a proxy will be kept on hold before being used for another payment. For payments, the hold days start from the day the payment was processed and for Request Virtual Account, the hold days start from the day the end date of the RVA has reached. Should be a numeric value between 1 to 999. If the value for this field (the tag is not sent) is not provided, the system defaults it to 90 days. This field Can be edited at any time.
autoRefreshEnabled:
type: boolean
description: Denotes if auto replenishment is enabled for proxies associated with the template (buyers). The value of this field should be set to true for VIP and VPP enabled buyers. Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for auto replenishment. This field Can be edited at any time.
bucketedProxyEnabled:
type: boolean
description: Denotes if bucketed proxy is enabled for proxies associated with the template (buyers). Valid Values are 'True' and 'False'. If the value for this field (the tag is not sent) is not provided, the system defaults it to False. The value can be set to true only if the bank is enabled for bucketed proxy. This field Can be edited at any time.
AuthorizationControlConfigForUpdate:
type: object
properties:
alertsEnabled:
type: boolean
description: Denotes if the system needs to send an alert when an authorization on a VPC enabled card is approved or declined. Valid values are 'True' and 'False'. This field can be set to True only if the authControlEnabled is set to true for the buyer. The alerts will be sent to the buyer contact's email address. This field can be updated at any time.
issuerHoldingBID:
pattern: ^[\d]{8}$
type: string
description: Denotes the Holding BID (business id) for the issuer. Should be numeric. This field can be updated only if there are no accounts setup for the buyer.
authControlEnabled:
type: boolean
description: Denotes if the authorization controls needs to be enabled for the buyer. Auth controls is mandated for VPP and VIP buyers. You can enable auth controls for a buyer at any time. But you cannot disable it (update it to false) if there are accounts enabled for VPC present for the buyer
GetBuyerRequest:
required:
- buyerId
- clientId
- messageId
type: object
properties:
buyerId:
maxLength: 25
type: string
description: Buyer ID is the buyer identifier as defined in Visa Payables Automation. This is often the ID defined at the processor. This will be provided by the Visa implementation team. Value format is 0–9.
clientId:
maxLength: 25
type: string
description: ClientID uniquely identifies a financial institution. This will be provided by Visa implementation team.
messageId:
maxLength: 36
type: string
description: Unique identifier for identifying the request. Each request sent to VPA requires its own unique ID.
description: Get Buyer Request Class
AuthorizationControlConfig:
type: object
properties:
alertsEnabled:
type: boolean
description: Denotes if the system needs to send an alert when an authorization on a VPC enabled card is approved or declined. Valid values are 'True' and 'False'. This field can be set to True only if the authControlEnabled is set to true for the template.
issuerHoldingBID:
maxLength: 8
pattern: ^[\d]+$
type: string
description: Denotes the Holding BID (business id) for the issuer. Should be numeric. Should be set only if authControlEnabled is set to true for the template.
authControlEnabled:
type: boolean
description: Denotes if the authorization controls needs to be enabled for the template (in turn the buyer). Auth controls is mandated for VPP and VIP buyers. If the value for this field (the tag is not sent) is not provided, the system defaults it to True if mandate auth controls is set to 'True' for the bank otherwise the system defaults it to False.
VanConfigForGet:
type: object
properties:
fcsBankId:
maxLength: 4
type: string
description: Denotes the Bank Identifier in the TSYS VPP FCS system. If the value for this field (the tag is not sent) is not provided, the system defaults it to the bank FCS ID if there is only one setup at the bank level. Supports alphanumeric values. Required if the buyer is enabled for VANs.
vanEnabled:
type: boolean
description: Denotes if "VANs" (VPP Tokens) are enabled for the buyer. Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for this Option.
aceClientId:
type: string
description: Denotes the number used to identify the bank on the Tsys ACE Decision Max system for account assignment.
readOnly: true
admClientId:
maxLength: 4
type: string
description: Denotes the number the TSYS VPP system uses to identify the company on the ACE Decision Max system for account assignment.
mcADMOptionId:
maxLength: 5
type: string
description: Denotes the option that will be used to assign the virtual account number in the TSYS VPP platform. For the TS1 platform only, the option must be set up to assign a virtual account number from the same BIN as the primary account number. This field will be populated only if it is a Mastercard Bank.
processingType:
maxLength: 4
type: string
description: Denotes the Processing type for the virtual account number (VAN).
visaADMOptionId:
maxLength: 5
type: string
description: Denotes the option that will be used to assign the virtual account number in the TSYS VPP platform. For the TS1 platform only, the option must be set up to assign a virtual account number from the same BIN as the primary account number. This field will be populated only if it is a Visa Bank.
settlementExpirationDays:
type: integer
description: Denotes the number of days after which settlement will not be honored on the virtual account (VAN).
readOnly: true
ApprovalWorkflowConfig:
type: object
properties:
workflowConfigEnabled:
type: boolean
description: Denotes if the Approval Workflow is enabled for the template (Buyer). Valid Values are 'True' and 'False'. If the value for this field (the tag is not sent) is not provided, the system defaults it false. The value can be set to true only if the bank is enabled for this Option.
workflowFunctionCodes:
maxItems: 10
uniqueItems: true
type: array
items:
maxLength: 4
type: string
description: Denotes the codes for the functionalities for which Approval Workflow needs to be enabled. Valid Values are AUCL – Card Limit Update, LCRC – Lodge/New Card, PYIN – Payment Instruction, PYRN – Payment Requisition At least one function should be passed in this field if workflowconfigenabled field is set to true for the template.
description: Parent tag which contains the approval workflow configurations.
ContactInfoForGet:
type: object
properties:
city:
maxLength: 20
type: string
description: Contains the City Name of the buyer's contact address.
state:
maxLength: 27
type: string
description: Contains the state of the buyer's contact address.
phone1:
maxLength: 20
type: string
description: Contains the buyer contact phone number 1.
phone2:
maxLength: 20
type: string
description: Contains the buyer contact phone number 2.
phone3:
maxLength: 20
type: string
description: Contains the buyer contact phone number 3.
buyerId:
maxLength: 25
pattern: ^[\d]+$
type: string
description: Contains the buyer identifier as defined in Visa Payables Automation. This is often the ID defined at the processor.
zipCode:
maxLength: 10
type: string
description: Contains the Postal Code of the buyer's contact address.
buyerName:
maxLength: 100
type: string
description: Contains the name of the buyer.
companyId:
maxLength: 10
pattern: ^[\d]+$
type: string
description: Contains the company identifier as defined at the issuer processor.
phone1Ext:
maxLength: 20
type: string
description: Contains the extension of the buyer contact phone number 1.
phone2Ext:
maxLength: 20
type: string
description: Contains the extension of the buyer contact phone number 2.
phone3Ext:
maxLength: 20
type: string
description: Contains the extension of the buyer contact phone number 3.
templateId:
maxLength: 30
pattern: ^[\w-]+$
type: string
description: Contains the unique identifier for a Template asscoiated with the bank.
contactName:
maxLength: 100
type: string
description: Contains the name of the primary contact person in the buyer
countryCode:
maxLength: 3
pattern: ^[a-zA-Z]{3}$
type: string
description: Contains the ISO alpha country code of the buyer's contact address. For example- USA.
addressLine1:
maxLength: 40
type: string
description: Contains the line 1 of the buyer's contact address.
addressLine2:
maxLength: 40
type: string
description: Contains the line 2 of the buyer's contact address.
addressLine3:
maxLength: 80
type: string
description: Contains the line 3 of the buyer's contact address.
emailAddress:
maxLength: 100
type: string
description: Contains the buyer's contact Email Address.
implementationType:
type: integer
description: Valid Values are:1 – VPA UI, 2 – VPA API and 3 – Visa Commercial Pay. 1 denotes buyer uses VPA UI (issuer direct use of VPA). 2 denotes buyer using a third party fintech user interface and third party is using VPA APIs. 3 denotes buyer uses Visa Commercial Pay service.
ProxyConfig:
type: object
properties:
holdDays:
maxLength: 3
pattern: ^[\d]+$
type: string
description: Denotes the number of days an account picked up for a payment in a proxy will be kept on hold before being used for another payment. For payments, the hold days start from the day the payment was processed and for Request Virtual Account, the hold days start from the day the end date of the RVA has reached. Should be a numeric value between 1 to 999. If the value for this field (the tag is not sent) is not provided, the system defaults it to 90 days.
autoRefreshEnabled:
type: boolean
description: Denotes if auto replenishment is enabled for proxies associated with the template (buyers). Valid Values are 'True' and 'False'. If the value for this field (the tag is not sent) is not provided, the system defaults it to False for memo account buyers and to true for VIP and VPP enabled buyers. The value of this field should be set to true for VIP and VPP enabled buyers. The value can be set to true only if the bank is enabled for auto replenishment.
bucketedProxyEnabled:
type: boolean
description: Denotes if bucketed proxy is enabled for proxies associated with the template (buyers). Valid Values are 'True' and 'False'. If the value for this field (the tag is not sent) is not provided, the system defaults it to False. The value can be set to true only if the bank is enabled for bucketed proxy.
AuthorizationControlConfigForGet:
type: object
properties:
alertsEnabled:
type: boolean
description: Denotes if the system needs to send an alert when an authorization on a VPC enabled card is approved or declined.
issuerHoldingBID:
pattern: ^[\d]{8}$
type: string
description: Denotes the Holding BID (business id) for the issuer.
authControlEnabled:
type: boolean
description: Denotes if the authorization controls needs to be enabled for the buyer. Auth controls is mandated for VPP and VIP buyers.
defaultAuthControlEnabled:
type: boolean
description: Denotes if the “Auth Control” option needs to be enabled by default for all the new suppliers created.
readOnly: true
authControlPaymentTemplate:
type: string
description: Denotes the name of the email template which will be used for generating the email notifications if auth control is enabled.
readOnly: true
UpdateBuyerRequest-1:
required:
- clientId
- contactInfo
- messageId
type: object
properties:
clientId:
maxLength: 25
type: string
description: ClientID uniquely identifies a financial institution. This will be provided by Visa implementation team.
messageId:
maxLength: 36
type: string
description: Unique identifier for this request. Each request sent to VPA requires its own unique ID.
vanConfig:
$ref: '#/components/schemas/VanConfigForUpdate'
contactInfo:
$ref: '#/components/schemas/ContactInfoForUpdate'
proxyConfig:
$ref: '#/components/schemas/ProxyConfigForUpdate'
billingConfig:
$ref: '#/components/schemas/BillingConfigForUpdate'
paymentConfig:
$ref: '#/components/schemas/PaymentConfigForUpdate'
processorConfig:
$ref: '#/components/schemas/ProcessorConfigForUpdate'
stpPaymentConfig:
$ref: '#/components/schemas/StpPaymentConfigForUpdate'
paymentFileConfig:
$ref: '#/components/schemas/PaymentFileCommConfigForUpdate'
webServicesConfig:
$ref: '#/components/schemas/WebServicesConfigForUpdate-1'
boostPaymentConfig:
$ref: '#/components/schemas/BoostPaymentConfigForUpdate'
buyerFeatureConfig:
$ref: '#/components/schemas/BuyerFeatureConfigForUpdate'
responseFileConfig:
$ref: '#/components/schemas/ResponseFileConfigForUpdate-1'
stripePaymentConfig:
$ref: '#/components/schemas/StripePaymentConfigForUpdate'
paymentSecurityConfig:
$ref: '#/components/schemas/PaymentSecurityConfigForUpdate'
approvalWorkflowConfig:
$ref: '#/components/schemas/ApprovalWorkflowConfigForUpdate'
reconciliationFileConfig:
$ref: '#/components/schemas/ReconciliationFileConfigForUpdate-1'
paymentNotificationConfig:
$ref: '#/components/schemas/PaymentNotificationConfigForUpdate'
authorizationControlConfig:
$ref: '#/components/schemas/AuthorizationControlConfigForUpdate'
rvaReconciliationFileConfig:
$ref: '#/components/schemas/RvaReconciliationFileConfigForUpdate-1'
description: Profile details of the buyer being updated.
CreateBuyerTemplateRequest:
required:
- clientId
- messageId
- paymentConfig
- paymentNotificationConfig
- templateName
type: object
properties:
clientId:
maxLength: 25
type: string
description: ClientID associated with the bank. This will be provided by Visa implementation team.
messageId:
maxLength: 36
type: string
description: Unique identifier for identifying the request.
vanConfig:
$ref: '#/components/schemas/VanConfig'
contactInfo:
$ref: '#/components/schemas/ContactInfo'
proxyConfig:
$ref: '#/components/schemas/ProxyConfig'
templateName:
maxLength: 50
type: string
description: Client-provided name of the template. Alphanumeric. No special characters other than _ - * & ' ! , . '#' and – (Dash) are allowed. It has to be unique within a Bank.
billingConfig:
$ref: '#/components/schemas/BillingConfig'
paymentConfig:
$ref: '#/components/schemas/PaymentConfig'
processorConfig:
$ref: '#/components/schemas/ProcessorConfig'
stpPaymentConfig:
$ref: '#/components/schemas/STPPaymentConfig'
webServicesConfig:
$ref: '#/components/schemas/WebServicesConfig'
boostPaymentConfig:
$ref: '#/components/schemas/BoostPaymentConfig'
buyerFeatureConfig:
$ref: '#/components/schemas/BuyerFeatureConfig'
responseFileConfig:
$ref: '#/components/schemas/ResponseFileConfig'
stripePaymentConfig:
$ref: '#/components/schemas/StripePaymentConfig'
templateDescription:
maxLength: 256
type: string
description: Client-defined template description. Supports AlphaNumeric characters.
paymentFileCommConfig:
$ref: '#/components/schemas/PaymentFileCommConfig'
paymentSecurityConfig:
$ref: '#/components/schemas/PaymentSecurityConfig'
approvalWorkflowConfig:
$ref: '#/components/schemas/ApprovalWorkflowConfig'
reconciliationFileConfig:
$ref: '#/components/schemas/ReconciliationFileConfig'
paymentNotificationConfig:
$ref: '#/components/schemas/PaymentNotificationConfig'
authorizationControlConfig:
$ref: '#/components/schemas/AuthorizationControlConfig'
rvaReconciliationFileConfig:
$ref: '#/components/schemas/RVAReconciliationFileConfig'
description: Create Buyer Template Request
VanConfigForUpdate:
type: object
properties:
fcsBankId:
maxLength: 4
type: string
description: Denotes the Bank Identifier in the TSYS VPP FCS system. Supports alphanumeric values. Required if the buyer is enabled for VANs. This field can be updated only if there are no VANs in the system associated to the buyer. This field can be set at any time but cannot be over ridden (Changed). This value will be provided by the Visa implementation team.
vanEnabled:
type: boolean
description: Denotes if "VANs" (VPP Tokens) are enabled for the buyer. Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for this Option. This field can be enabled (Set to True) but cannot be disabled (Set to False).This value will be provided by the Visa implementation team.
admClientId:
maxLength: 4
type: string
description: Denotes the number the TSYS VPP system uses to identify the company on the ACE Decision Max system for account assignment. This field can be set at any time but cannot be over ridden (Changed).This value will be provided by the Visa implementation team.
mcADMOptionId:
maxLength: 5
type: string
description: Denotes the option that will be used to assign the virtual account number in the TSYS VPP platform. For the TS1 platform only, the option must be set up to assign a virtual account number from the same BIN as the primary account number. If it is a mastercard bank, then this field is required. This value will be provided by the Visa implementation team. This field can be set at any time but cannot be over ridden (Changed).
processingType:
maxLength: 4
type: string
description: Denotes the Processing type for the virtual account number (VAN). This field can be set at any time but cannot be over ridden (Changed). This value will be provided by the Visa implementation team.
visaADMOptionId:
maxLength: 5
type: string
description: Denotes the option that will be used to assign the virtual account number in the TSYS VPP platform. For the TS1 platform only, the option must be set up to assign a virtual account number from the same BIN as the primary account number. If it is a Visa bank, then this field is required. This field can be set at any time but cannot be over ridden (Changed). This value will be provided by the Visa implementation team.
ResponseFileConfigForCreate-1:
type: object
properties:
fileLevel:
maxLength: 1
type: string
description: Denotes if the response COMM File configuration is defined to be delivered to the bank(B) or Company (C). Valid values are B and C.
commFileId:
maxLength: 40
type: string
description: Denotes the Comm File ID associated with the Response file outbound. Required if the file level is B. The Visa implementation team provides this value after the outbound response file configuration has been completed.
fileFormat:
type: integer
description: Denotes the format in which the response file needs to be generated. Needs to be numeric. Valid values are 1 – XLS V0, 2 – CSV V0, 3 - XLS V1, 4 – CSV V1
recipientLoginIds:
maxItems: 80
uniqueItems: true
type: array
description: Contains the list of user ids of bank/buyer users who will be receiving the response file in their VOL mailbox. You can setup upto 80 user ids to receive the response file. The user ids should have the VOL mailbox service entitled to them.
items:
type: string
ReconciliationFileConfigForGet:
type: object
properties:
fileLevel:
maxLength: 1
type: string
description: Denotes if the recon COMM File configuration is defined to be delivered to the bank(B) or Company (C). Valid values are B - Bank and C - Company.
commFileId:
maxLength: 40
type: string
description: Denotes the Comm File ID associated with the recon file outbound.
fileFormat:
type: integer
description: Denotes the format in which the recon file needs to be generated. Valid values are 1 – XLS V0, 2 – CSV V0, 3 - XLS V1, 4 – CSV V1
deliveryTime:
maxLength: 6
type: string
description: Denotes the delivery type or day when the recon file needs to be generated and delivered. Valid format for the time for the daily frequency is 'HH:MM' in 24 hours format. Valid values for the Weekly frequency 1 to 7 denoting the days. 1 being Sunday and 7 being Saturday and Monthly Frequency 1 to 31
templateName:
maxLength: 100
type: string
description: Denotes the name of the recon template to be used for generating the reconciliation file.
deliveryFrequency:
type: integer
description: Denotes the frequency in which the recon file needs to be delivered. Valid values are 1 – Daily 2 – Weekly 3 - Monthly
recipientLoginIds:
maxItems: 50
uniqueItems: true
type: array
description: Contains the list of user ids of bank/buyer users who will be receiving the recon file in their VOL mailbox.
items:
type: string
adhocReconciliationReportEnabled:
type: boolean
description: Denotes if Adhoc Reconciliation functionality is enabled for the buyer. Valid Values are 'True' and 'False'.
onlinePaymentReconciliationEnabled:
type: boolean
description: Denotes if Online payment Reconciliation functionality is enabled for the buyers. Valid Values are 'True' and 'False'.
ReconciliationFileConfigForGet-1:
type: object
properties:
fileLevel:
maxLength: 1
type: string
description: Denotes if the recon COMM File configuration is defined to be delivered to the bank(B) or Company (C). Valid values are B - Bank and C - Company.
commFileId:
maxLength: 40
type: string
description: Denotes the Comm File ID associated with the recon file outbound.
fileFormat:
type: integer
description: Denotes the format in which the recon file needs to be generated. Valid values are 1 – XLS V0, 2 – CSV V0, 3 - XLS V1, 4 – CSV V1
deliveryTime:
maxLength: 6
type: string
description: Denotes the delivery type or day when the recon file needs to be generated and delivered. Valid format for the time for the daily frequency is 'HH:MM' in 24 hours format. Valid values for the Weekly frequency 1 to 7 denoting the days. 1 being Sunday and 7 being Saturday and Monthly Frequency 1 to 31
templateName:
maxLength: 100
type: string
description: Denotes the name of the recon template to be used for generating the reconciliation file.
deliveryFrequency:
type: integer
description: Denotes the frequency in which the recon file needs to be delivered. Valid values are 1 – Daily 2 – Weekly 3 - Monthly
recipientLoginIds:
maxItems: 80
uniqueItems: true
type: array
description: Contains the list of user ids of bank/buyer users who will be receiving the recon file in their VOL mailbox.
items:
type: string
adhocReconciliationReportEnabled:
type: boolean
description: Denotes if Adhoc Reconciliation functionality is enabled for the buyer. Valid Values are 'True' and 'False'.
onlinePaymentReconciliationEnabled:
type: boolean
description: Denotes if Online payment Reconciliation functionality is enabled for the buyers. Valid Values are 'True' and 'False'.
ResponseFileConfigForGet-1:
type: object
properties:
fileLevel:
maxLength: 1
type: string
description: Denotes if the response COMM File configuration is defined to be delivered to the bank(B) or Company (C).
commFileId:
maxLength: 40
type: string
description: Denotes the Comm File ID associated with the Response file outbound. The Visa implementation team provides this value after the outbound response file configuration has been completed.
fileFormat:
type: integer
description: Denotes the format in which the response file needs to be generated. Valid values are 1 – XLS V0, 2 – CSV V0, 3 - XLS V1, 4 – CSV V1
recipientLoginIds:
maxItems: 80
uniqueItems: true
type: array
description: Contains the list of user ids of bank/buyer users who will be receiving the response file in their VOL mailbox.
items:
type: string
ProxyConfigForCreate:
type: object
properties:
holdDays:
maxLength: 3
pattern: ^[\d]+$
type: string
description: Denotes the number of days an account picked up for a payment in a proxy will be kept on hold before being used for another payment. For payments, the hold days start from the day the payment was processed and for Request Virtual Account, the hold days start from the day the end date of the RVA has reached. Should be a numeric value between 1 to 999. If the value for this field (the tag is not sent) is not provided, the system defaults it to 90 days.
autoRefreshEnabled:
type: boolean
description: Denotes if auto replenishment is enabled for proxies associated with the buyer. If the value for this field (the tag is not sent) is not provided, the system defaults it to False for memo account buyers and to true for VIP and VPP enabled buyers. The value of this field should be set to true for VIP and VPP enabled buyers. Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for auto replenishment.
bucketedProxyEnabled:
type: boolean
description: Denotes if bucketed proxy is enabled for proxies associated with the buyer. If the value for this field (the tag is not sent) is not provided, the system defaults it to False. Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for bucketed proxy.
GetBuyerSuccessResponse:
type: object
properties:
responseObject:
$ref: '#/components/schemas/GetBuyerResponse'
responseStatus:
$ref: '#/components/schemas/Response'
description: Response for a successful fetch of a Buyer
ResponseFileConfig:
type: object
properties:
commFileId:
maxLength: 40
type: string
description: Denotes the Comm File ID associated with the Response file outbound.
ReconciliationFileConfigForUpdate-1:
type: object
properties:
fileLevel:
maxLength: 1
type: string
description: Denotes if the recon COMM File configuration is defined to be delivered to the bank(B) or Company (C). Valid values are B - Bank and C - Company. This field can be updated at any time.
commFileId:
maxLength: 40
type: string
description: Denotes the Comm File ID associated with the recon file outbound. The COMM file definition should exist in the system. The Visa implementation team provides this value after the outbound recon file configuration has been completed. This field can be updated at any time.
fileFormat:
type: integer
description: Denotes the format in which the recon file needs to be generated. Needs to be numeric. Valid values are 1 – XLS V0, 2 – CSV V0, 3 - XLS V1, 4 – CSV V1. This field can be updated at any time.
deliveryTime:
maxLength: 6
type: string
description: Denotes the delivery type or day when the recon file needs to be generated and delivered. If the value for this field (the tag is not sent) is not provided, the system defaults it to'1:00' AM for the daily frequency and 1 for weekly and monthly frequency. Valid format for the time for the daily frequency is 'HH:MM' in 24 hours format. Valid values for the Weekly frequency 1 to 7 denoting the days. 1 being Sunday and 7 being Saturday and Monthly Frequency 1 to 31. This field can be updated at any time.
templateName:
maxLength: 100
type: string
description: Denotes the name of the recon template to be used for generating the reconciliation file. This field can be updated at any time.
deliveryFrequency:
type: integer
description: Denotes the frequency in which the recon file needs to be delivered. Needs to be numeric. Valid values are 1 – Daily 2 – Weekly 3 - Monthly. This field can be updated at any time.
recipientLoginIds:
maxItems: 80
uniqueItems: true
type: array
description: Contains the list of user ids of bank/buyer users who will be receiving the recon file in their VOL mailbox. You can setup upto 80 user ids to receive the recon file. The user ids should have the VOL mailbox service entitled to them.This field can be updated at any time.
items:
type: string
adhocReconciliationReportEnabled:
type: boolean
description: Denotes if Adhoc Reconciliation functionality is enabled for the buyer. Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for Adhoc Reconciliation. This field can be updated at any time.
onlinePaymentReconciliationEnabled:
type: boolean
description: Denotes if Online payment Reconciliation functionality is enabled for the buyers. Valid Values are 'True' and 'False'. The value can be set to true only if the bank is enabled for Online Payment Reconciliation. This field can be updated at any time.
GetPaymentConfig:
type: object
properties:
expirationDays:
maxLength: 3
pattern: ^[\d]+$
type: string
description: Default payment expiration days which will be used if the buyer did not provide the payment expiration date either in the payment or has not configured for the supplier. The payment expiration days will be used to calculate the payment expiration date (payment process date + the payment expiration days) which is the last day by which the supplier should collect the payment.
billingCurrency:
maxLength: 3
pattern: ^[a-zA-Z]{3}$
type: string
description: Denotes the ISO alpha currency code associated with the billing Currency of the card accounts belonging to the buyer.
allowableCurrencies:
maxItems: 200
uniqueItems: true
type: array
description: The list of currencies (ISO alpha currency codes) allowed for the buyer. The buyer can process payments in any of these currencies. Any payments made other than these currencies will be rejected.
items:
maxLength: 3
pattern: ^[a-zA-Z]{3}$
type: string
paymentAdviceOption:
maxLength: 1
type: string
description: Denotes if all payments to the same supplier in a payment file will be consolidated (Consolidated option - C) or sent separately (Split Option - S) and sent in one payment advice notification.
expirationBufferDays:
maxLength: 2
pattern: ^[\d]+$
type: string
description: expirationBufferDays is the number of days after the payment expiration date by which the supplier needs to complete the collection of the payment (settlement of the card transaction should be completed).
securityCodeRequired:
type: boolean
description: Denotes if CVV2 is required for processing the payment.
GetBuyerTemplateSuccessResponse:
type: object
properties:
responseObject:
$ref: '#/components/schemas/GetBuyerTemplateResponse'
responseStatus:
$ref: '#/components/schemas/Response'
description: Get Buyer Template Success Response
GetProxyConfig:
type: object
properties:
holdDays:
maxLength: 3
pattern: ^[\d]+$
type: string
description: Denotes the number of days an account picked up for a payment in a proxy will be kept on hold before being used for another payment. For payments, the hold days start from the day the payment was processed and for Request Virtual Account, the hold days start from the day the end date of the RVA has reached.
autoRefreshEnabled:
type: boolean
description: Denotes if auto replenishment is enabled for proxies associated with the template (buyers).
bucketedProxyEnabled:
type: boolean
description: Denotes if bucketed proxy is enabled for proxies associated with the template (buyers).
UpdateBuyerTemplateSuccessResponse:
type: object
properties:
responseObject:
$ref: '#/components/schemas/UpdateBuyerTemplateResponse'
responseStatus:
$ref: '#/components/schemas/Response'
description: Update Buyer Template Success Response
Response:
type: object
properties:
status:
type: string
description: Response status `success` or `error`
enum:
- success
- error
messageId:
maxLength: 36
type: string
description: Unique identifier for identifying the request.
statusCode:
maxLength: 6
type: string
description: Status code of the response. It is alphanumeric. The values are specific to each method. For the details of the various error codes returned for this method refer to the "Error Codes" table below.
statusDesc:
maxLength: 255
type: string
description: Status description of the response.
description: Default API Response
UpdateStripePaymentConfig:
type: object
properties:
stripePaymentEnabled:
type: boolean
description: Denotes if Stripe payments is enabled for the template (buyer). Optional field. Valid values are 'True' or 'False'. This field can be set to true only if the bank Stripe Payment option is set to 'True'. This field can be enabled (set to true) at any time but cannot be disabled if the sync Buyer Profiles is set to true.
remittanceNotificationEnabled:
type: boolean
description: Denotes if the Stripe Payment Remittance notification is enabled for a template (buyer). Valid values are 'True' or 'False'. This field can be set to true only if the bank Stripe Payment Remittance Notification option is set to 'True'. Only if this field is enabled, the Stripe supplier will be getting the payment remittance notification. This field can be edited at any time.
PaymentFileCommConfigForCreate:
type: object
properties:
edi824FileId:
maxLength: 40
type: string
description: Denotes the Comm File ID associated with the EDI 824 outbound response file. The COMM file definition should exist in the system. The Visa implementation team provides this value after the inbound file configuration has been completed.
edi997FileId:
maxLength: 40
type: string
description: Denotes the Comm File ID associated with the EDI 997 outbound ack file. The COMM file definition should exist in the system. The Visa implementation team provides this value after the inbound file configuration has been completed.
inboundFileId:
maxLength: 40
type: string
description: Denotes the Comm file ID associated with the inbound payment file (EDI 820 or SFF). The COMM file definition should exist in the system. The Visa implementation team provides this value after the inbound file configuration has been completed.
GetBuyerTemplateResponse:
type: object
properties:
vanConfig:
$ref: '#/components/schemas/GetVanConfig'
templateId:
maxLength: 30
type: string
description: Unique Identifier for a Template. It should be alphanumeric. Should be an existing template id associated with the bank (associated to the client id). The template id is returned in the response of the GetTemplate API.
contactInfo:
$ref: '#/components/schemas/GetContactInfo'
proxyConfig:
$ref: '#/components/schemas/GetProxyConfig'
templateName:
maxLength: 50
type: string
description: Name of the template
billingConfig:
$ref: '#/components/schemas/GetBillingConfig'
paymentConfig:
$ref: '#/components/schemas/GetPaymentConfig'
processorConfig:
$ref: '#/components/schemas/GetProcessorConfig'
stpPaymentConfig:
$ref: '#/components/schemas/GetSTPPaymentConfig'
webServicesConfig:
$ref: '#/components/schemas/GetWebServicesConfig'
boostPaymentConfig:
$ref: '#/components/schemas/GetBoostPaymentConfig'
buyerFeatureConfig:
$ref: '#/components/schemas/GetBuyerFeatureConfig'
responseFileConfig:
$ref: '#/components/schemas/GetResponseFileConfig'
stripePaymentConfig:
$ref: '#/components/schemas/GetStripePaymentConfig'
templateDescription:
maxLength: 256
type: string
description: Description of the template.
paymentFileCommConfig:
$ref: '#/components/schemas/GetPaymentFileCommConfig'
paymentSecurityConfig:
$ref: '#/components/schemas/GetPaymentSecurityConfig'
approvalWorkflowConfig:
$ref: '#/components/schemas/GetApprovalWorkflowConfig'
reconciliationFileConfig:
$ref: '#/components/schemas/GetReconciliationFileConfig'
paymentNotificationConfig:
$ref: '#/components/schemas/GetPaymentNotificationConfig'
authorizationControlConfig:
$ref: '#/components/schemas/GetAuthorizationControlConfig'
rvaReconciliationFileConfig:
$ref: '#/components/schemas/GetRVAReconciliationFileConfig'
description: Get Buyer Template Response
PaymentNotificationConfig:
required:
- dateFormat
type: object
properties:
dateFormat:
maxLength: 10
type: string
description: Denotes the date format which will be used for parsing date fields in the payment files in EDI or CVV tab format. Should be one of the VPA system supported date formats. This field is required. Refer to Date Formats table.
defaultBuyerLanguageCode:
maxLength: 10
type: string
description: Denotes the language which will be used in notifications sent to the buyer. A valid locale (language code) should be provided. For example "en_US" for US english. If the value for this field is not provided, the system defaults it to 'en_US'. Refer to the Language Code table for langauge codes.
attachRemittanceFileDetails:
type: boolean
description: Denotes if the remittance details file (containing the invoice details) will be attached to the payment advice notification while processig a payment. Valid values are 'True' or 'False'. Optional field. If the value for this field (the tag is not sent) is not provided, the system defaults it to value set for this option for the bank. This field can be set to true only if the bank attach remittance details file option is set to 'True'.
supplierReminderNotificationDays:
maxLength: 2
pattern: ^[\d]+$
type: string
description: Denotes the number of days before the payment expiration date when the system sends a reminder notification to the supplier. Optional Field. If the value for this field (the tag is not sent) is not provided, the system defaults it to 7 days. Should be between 0 and 100. This value should be specified only when suppress supplier notification is disabled and supplier reminder notification is enabled for the template.
supplierReminderNotificationEnabled:
type: boolean
description: Denotes if the system will send the payment reminder notification to the supplier (before the configured number of days (supplier reminder notification days) from the payment expiration date) to remind them to collect the payment. If the value for this field (the tag is not sent) is not provided, the system defaults it to 'False' if the suppress supplier notification is enabled and to 'True' if the suppress supplier notifiation is disabled. This field can be set to true only if the bank supplier reminder notification option is set to 'True' and suppress supplier notification option for the template is set to false.
UpdateBuyerTemplateRequest:
required:
- clientId
- messageId
- templateId
type: object
properties:
clientId:
maxLength: 25
type: string
description: Denotes the client ID associated with the bank for which the template is being defined. Should be alphanumeric and should exist in the system. Visa will provide this during implementation. This field cannot be updated.
messageId:
maxLength: 36
type: string
description: Unique identifier for this request. Each request sent to VPA requires its own unique ID.
vanConfig:
$ref: '#/components/schemas/UpdateVanConfig'
templateId:
maxLength: 30
type: string
description: Unique Identifier for a Template. It should be alphanumeric. Should be an existing template id associated with the bank (associated to the client id). The template id is returned in the response of the CreateTemplate API.
contactInfo:
$ref: '#/components/schemas/UpdateContactInfo'
proxyConfig:
$ref: '#/components/schemas/UpdateProxyConfig'
templateName:
maxLength: 50
type: string
description: Name of the template. Can be updated at any time. Alphanumeric. No special characters other than _ - * & ' ! , . '#' and – (Dash) are allowed. It has to be unique within a Bank.
billingConfig:
$ref: '#/components/schemas/UpdateBillingConfig'
paymentConfig:
$ref: '#/components/schemas/UpdatePaymentConfig'
processorConfig:
$ref: '#/components/schemas/UpdateProcessorConfig'
stpPaymentConfig:
$ref: '#/components/schemas/UpdateSTPPaymentConfig'
syncBuyerProfiles:
type: boolean
description: '- Valid values are True or False - If set to Y, all existing buyers associated with this template will adopt these changes. Updating existing buyers could disrupt payments in progress so before syncing profiles, ensure there will be no negative impacts to existing buyers. If set to N, changes will only be applied to future buyers created after the update Template API is sent.'
webServicesConfig:
$ref: '#/components/schemas/UpdateWebServicesConfig'
boostPaymentConfig:
$ref: '#/components/schemas/UpdateBoostPaymentConfig'
buyerFeatureConfig:
$ref: '#/components/schemas/UpdateBuyerFeatureConfig'
stripePaymentConfig:
$ref: '#/components/schemas/UpdateStripePaymentConfig'
templateDescription:
maxLength: 256
type: string
description: Supports AlphaNumeric characters. Can be updated at any time.
paymentSecurityConfig:
$ref: '#/components/schemas/UpdatePaymentSecurityConfig'
approvalWorkflowConfig:
$ref: '#/components/schemas/UpdateApprovalWorkflowConfig'
reconciliationFileConfig:
$ref: '#/components/schemas/UpdateReconciliationFileConfig'
paymentNotificationConfig:
$ref: '#/components/schemas/UpdatePaymentNotificationConfig'
authorizationControlConfig:
$ref: '#/components/schemas/UpdateAuthorizationControlConfig'
description: Update Buyer Template Request
StpPaymentConfigForGet:
type: object
properties:
stpPaymentEnabled:
type: boolean
description: Denotes if STP payments is enabled for the buyer. Valid values are 'True' or 'False'.
accountHolderLastName:
maxLength: 100
type: string
description: Denotes the Account Holder's last Name which will be used while processing the STP payment.
accountHolderFirstName:
maxLength: 100
type: string
description: Denotes the Account Holder's first Name which will be used while processing the STP payment.
remittanceNotificationEnabled:
type: boolean
description: Denotes if the STP Payment Remittance notification is enabled for a buyer. Optional field. Valid values are 'True' or 'False'. The STP supplier will be getting the payment remittance notification only if this field is enabled.
GetRVAReconciliationFileConfig:
type: object
properties:
commFileId:
maxLength: 40
type: string
description: Comm file Id refers to Comm File info associated with the Request Virtua Account recon file outbound delivery.
templateId:
maxLength: 2
type: string
description: Denotes the template identifier associated with the RVA recon template to be used for generating the RVA recon file.
GetStripePaymentConfig:
type: object
properties:
stripePaymentEnabled:
type: boolean
description: Denotes if Stripe payments is enabled for the template (buyer).
remittanceNotificationEnabled:
type: boolean
description: Denotes if the Stripe Payment Remittance notification is enabled for a template (buyer).
RvaReconciliationFileConfigForCreate-1:
type: object
properties:
fileLevel:
maxLength: 1
type: string
description: Denotes if the RVA recon COMM File configuration is defined to be delivered to the bank(B) or Company (C). Valid values are B - Bank and C - Company.
commFileId:
maxLength: 40
type: string
description: Denotes the Comm File ID associated with the RVA recon file outbound. Required if the file level is B. The Visa implementation team provides this value after the outbound RVA recon file configuration has been completed.
fileFormat:
type: integer
description: Denotes the format in which the RVA recon file needs to be generated. Needs to be numeric. Valid values are 1 – XLS V0, 2 – CSV V0, 3 - XLS V1, 4 – CSV V1
templateId:
maxLength: 5
type: string
description: Denotes the id of the recon template to be used for generating the RVA reconciliation file. The template id is returned in the response when you create a new template. If the value for this field (the tag is not sent) is not provided, the system defaults it to the latest RVA recon standard template (currentyly 1). Valid values are 1 - RVA Recon standard template Version 1.0
deliveryTime:
maxLength: 6
type: string
description: Denotes the delivery type or day when the RVA recon file needs to be generated and delivered. If the value for this field (the tag is not sent) is not provided, the system defaults it to'1:00' AM for the daily frequency and 1 for weekly and monthly frequency. Valid format for the time for the daily frequency is 'HH:MM' in 24 hours format. Valid values for the Weekly frequency 1 to 7 denoting the days. 1 being Sunday and 7 being Saturday and Monthly Frequency 1 to 31
deliveryFrequency:
type: integer
description: Denotes the frequency in which the RVA recon file needs to be delivered. Needs to be numeric. Valid values are 1 – Daily 2 – Weekly 3 - Monthly
recipientLoginIds:
maxItems: 80
uniqueItems: true
type: array
description: Contains the list of user ids of bank/buyer users who will be receiving the RVA recon file in their VOL mailbox. You can setup upto 80 user ids to receive the RVA recon file.The user ids should have the VOL mailbox service entitled to them.
items:
type: string
RvaReconciliationFileConfigForUpdate-1:
type: object
properties:
fileLevel:
maxLength: 1
type: string
description: Denotes if the RVA recon COMM File configuration is defined to be delivered to the bank(B) or Company (C). Valid values are B - Bank and C - Company. This field can be updated at any time.
commFileId:
type: string
description: Denotes the Comm File ID associated with the RVA recon file outbound. The COMM file definition should exist in the system. The Visa implementation team provides this value after the outbound RVA recon file configuration has been completed. This field can be updated at any time.
fileFormat:
type: integer
description: Denotes the format in which the RVA recon file needs to be generated. Needs to be numeric. Valid values are 1 – XLS V0, 2 – CSV V0, 3 - XLS V1, 4 – CSV V1. This field can be updated at any time.
templateId:
maxLength: 5
type: string
description: Denotes the id of the recon template to be used for generating the RVA reconciliation file. Valid values are 1 - RVA Recon standard template Version 1.0. This field can be updated at any time.
deliveryTime:
maxLength: 6
type: string
description: Denotes the delivery type or day when the RVA recon file needs to be generated and delivered. Valid format for the time for the daily frequency is 'HH:MM' in 24 hours format. Valid values for the Weekly frequency 1 to 7 denoting the days. 1 being Sunday and 7 being Saturday and Monthly Frequency 1 to 31 This field can be updated at any time.
deliveryFrequency:
type: integer
description: Denotes the frequency in which the RVA recon file needs to be delivered. Needs to be numeric. Valid values are 1 – Daily 2 – Weekly 3 - Monthly. This field can be updated at any time.
recipientLoginIds:
maxItems: 80
uniqueItems: true
type: array
description: Contains the list of user ids of bank/buyer users who will be receiving the RVA recon file in their VOL mailbox. You can setup upto 80 user ids to receive the RVA recon file.The user ids should have the VOL mailbox service entitled to them. This field can be updated at any time.
items:
type: string
PaymentNotificationConfigForUpdate:
type: object
properties:
dateFormat:
type: string
description: Denotes the date format which will be used for parsing date fields in the payment files in EDI or CSV or tab format. Should be one of the VPA system supported date formats. This field can be updated at any time. Refer to Date Formats table.
format: date
defaultBuyerLanguageCode:
maxLength: 10
type: string
description: Denotes the language which will be used in notifications sent to the buyer. A valid locale (language code) should be provided. For example "en_US" for US english. Refer to the Language Code table for langauge codes. This field can be updated at any time.
example: en_us
attachRemittanceDetailsFile:
type: boolean
description: Denotes if the remittance details file (containing the invoice details) will be attached to the payment advice notification while processig a payment. Optional field. If the value for this field (the tag is not sent) is not provided, the system defaults it to value set for this option for the bank. Valid values are 'True' or 'False'. This field can be set to true only if the bank attach remittance details file option is set to 'True'. This field can be updated at any time.
supplierReminderNotificationDays:
maxLength: 2
pattern: ^[\d]+$
type: string
description: Denotes the number of days before the payment expiration date when the system sends a reminder notification to the supplier. Optional Field. If the value for this field (the tag is not sent) is not provided, the system defaults it to 7 days. Should be between 0 and 100. This value should be specified only when suppress supplier notification is disabled and supplier reminder notification is enabled for the buyer. This field can be updated at any time.
supplierReminderNotificationEnabled:
type: boolean
description: Denotes if the system will send the payment reminder notification to the supplier (before the configured number of days (supplier reminder notification days) from the payment expiration date) to remind them to collect the payment. If the value for this field (the tag is not sent) is not provided, the system defaults it to 'False' if the suppress supplier notification is enabled and to 'True' if the suppress supplier notifiation is disabled. This field can be set to true only if the bank supplier reminder notification option is set to 'True' and suppress supplier notification option for the buyer is set to false. This field can be updated at any time.
BErrorItem:
type: object
properties:
errorCode:
type: string
errorDescription:
type: string
description: Error Item
STPPaymentConfig:
type: object
properties:
stpPaymentEnabled:
type: boolean
description: Denotes if the STP Payments is enabled for a template (buyer). Valid values are 'True' or 'False'. Optional field. If the value for this field (the tag is not sent) is not provided, the system defaults it to 'False'. This field can be set to true only if the bank STP Payments option is set to 'True'.
remittanceNotificationEnabled:
type: boolean
description: Denotes if the STP Payment Remittance notification is enabled for a template (buyer). Valid values are 'True' or 'False'. Optional field. If the value for this field (the tag is not sent) is not provided, the system defaults it to 'False'. This field can be set to true only if the bank STP Payment Remittance Notification option is set to 'True'. Only if this field is enabled, the STP supplier will be getting the payment remittance notification.
Error:
type: object
properties:
errorList:
type: array
items:
$ref: '#/components/schemas/ErrorItem'
description: Error object
x-tagGroups:
- name: API Reference
tags:
- Foreign Exchange Rates API