Worldline Corporate Contract API
Corporate Contract API Controller
Worldline Corporate Contract API is one of 79 APIs that Worldline publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Corporate Contract. The published artifact set on APIs.io includes an OpenAPI specification.
This API exposes 43 operations across 35 paths, and defines 191 schemas. It is described by OpenAPI 3.2.0, at version 2.41.1.
Requests are made against a single base URL, https://sbx-wlip.api1-eu2.psapigateway.preprod.giservices.io/card-issuing/api/v2.
43 operations
35 paths
191 schemas
10 GET10 PATCH23 POST
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 1
Worldline Corporate Contract API declares
1 security scheme
for authenticating requests.
It supports OAuth 2.0 (basic) using the clientCredentials flow.
Paths & Operations 43
Across 35 paths, the API surfaces 43 operations — 10 GET, 10 PATCH, 23 POST. Each is listed below with its method, path, parameters, and response codes.
Corporate Contract 43
Corporate Contract API Controller
GET
/issuers/{issuerId}/corporate-contracts/{contractReference}/corporate-employee-accounts/{accountReference}
Retrieve corporate employee Accounts
PATCH
/issuers/{issuerId}/corporate-contracts/{contractReference}/corporate-employee-accounts/{accountReference}
Update Corporate employee account
GET
/issuers/{issuerId}/corporate-contracts/{contractReference}/corporate-employee-accounts/external-accounts/{issuerAccountExternalReference}
Retrieve corporate employee accounts by account external reference
PATCH
/issuers/{issuerId}/corporate-contracts/{contractReference}/corporate-employee-accounts/external-accounts/{issuerAccountExternalReference}
Update Corporate employee account by account external reference
GET
/issuers/{issuerId}/corporate-contracts/external-contracts/{issuerContractExternalReference}/corporate-employee-accounts/external-accounts/{issuerAccountExternalReference}
Retrieve corporate employee Accounts by contract external reference and account external reference
PATCH
/issuers/{issuerId}/corporate-contracts/external-contracts/{issuerContractExternalReference}/corporate-employee-accounts/external-accounts/{issuerAccountExternalReference}
Update Corporate employee account by contract external reference and account external reference
GET
/issuers/{issuerId}/corporate-contracts/external-contracts/{issuerContractExternalReference}/corporate-employee-accounts/{accountReference}
Retrieve corporate employee Accounts by contract external reference
PATCH
/issuers/{issuerId}/corporate-contracts/external-contracts/{issuerContractExternalReference}/corporate-employee-accounts/{accountReference}
Update Corporate employee account by contract external reference
GET
/issuers/{issuerId}/corporate-contracts/{contractReference}
Retrieve corporate contract
PATCH
/issuers/{issuerId}/corporate-contracts/{contractReference}
Modify Corporate contract
GET
/issuers/{issuerId}/corporate-contracts/external-contracts/{issuerContractExternalReference}
Retrieve corporate contract by external reference
PATCH
/issuers/{issuerId}/corporate-contracts/external-contracts/{issuerContractExternalReference}
Modify Corporate contract by external reference
POST
/issuers/{issuerId}/corporate-contracts/{contractReference}/close
Close Corporate contract
POST
/issuers/{issuerId}/corporate-contracts/{contractReference}/add-corporate-contract-entity
Add an entity to a Corporate contract
PATCH
/issuers/{issuerId}/corporate-contracts/{contractReference}/corporate-contract-entity/{companyEntityExternalReference}deprecated
Modify an entity of a Corporate contract - deprecated
PATCH
/issuers/{issuerId}/corporate-contracts/{contractReference}/corporate-contract-entities/{companyEntityExternalReference}
Modify an entity of a Corporate contract
PATCH
/issuers/{issuerId}/corporate-contracts/external-contracts/{issuerContractExternalReference}/corporate-contract-entity/{companyEntityExternalReference}deprecated
modify an entity of a Corporate contract by external reference - deprecated
PATCH
/issuers/{issuerId}/corporate-contracts/external-contracts/{issuerContractExternalReference}/corporate-contract-entities/{companyEntityExternalReference}
modify an entity of a Corporate contract by external reference
POST
/issuers/{issuerId}/corporate-contracts/external-contracts/{issuerContractExternalReference}/add-corporate-contract-entity
Add an entity to a Corporate contract by external reference
POST
/issuers/{issuerId}/corporate-contracts/{contractReference}/add-corporate-employee-cards-accounts
Add an employee and its card(s) and account(s) to a Corporate contract
POST
/issuers/{issuerId}/corporate-contracts/external-contracts/{issuerContractExternalReference}/add-corporate-employee-cards-accounts
Add an employee and its card(s) and account(s) to a Corporate contract by external reference
POST
/issuers/{issuerId}/corporate-contracts/{contractReference}/add-virtual-cards-accounts-service
Add Corporate VCA Service cards and accounts to a corporate contract
POST
/issuers/{issuerId}/corporate-contracts/external-contracts/{issuerContractExternalReference}/add-virtual-cards-accounts-service
Add Corporate VCA Service cards and accounts to a corporate contract by issuer contract external reference
POST
/issuers/{issuerId}/corporate-contracts/create-corporate-contract
Create a Corporate contract
POST
/issuers/{issuerId}/corporate-contracts/external-contracts/{issuerContractExternalReference}/close
Close Corporate contract by external reference
POST
/issuers/{issuerId}/corporate-contracts/{contractReference}/refund-fee-on-demand
Refund fee by contract reference for corporate contract
GET
/issuers/{issuerId}/corporate-contracts/external-contracts/{issuerContractExternalReference}/addon-subscriptions
List add-on services subscriptions for a corporate contract by external reference
POST
/issuers/{issuerId}/corporate-contracts/external-contracts/{issuerContractExternalReference}/addon-subscriptions
Subscribe to add-on for a corporate contract by external reference
GET
/issuers/{issuerId}/corporate-contracts/{contractReference}/addon-subscriptions
List add-on services subscriptions for a corporate contract
POST
/issuers/{issuerId}/corporate-contracts/{contractReference}/addon-subscriptions
Subscribe to add-on for a corporate contract
POST
/issuers/{issuerId}/corporate-contracts/external-contracts/{issuerContractExternalReference}/addon-subscriptions/unsubscribe
Unsubscribe add-on for a corporate contract by external reference
POST
/issuers/{issuerId}/corporate-contracts/{contractReference}/addon-subscriptions/unsubscribe
Unsubscribe add-on for a corporate contract
POST
/issuers/{issuerId}/corporate-contracts/external-contracts/{issuerContractExternalReference}/refund-fee-on-demand
Refund Fee By Issuer Contract External Reference For Corporate Contract
POST
/issuers/{issuerId}/corporate-contracts/{contractReference}/change-paying-account
Change paying account structure for a corporate contract
POST
/issuers/{issuerId}/corporate-contracts/{contractReference}/cancel-change-paying-account
Cancel scheduled change of paying account type
POST
/issuers/{issuerId}/corporate-contracts/external-contracts/{issuerContractExternalReference}/cancel-change-paying-account
Cancel scheduled change of paying account type by external reference
POST
/issuers/{issuerId}/corporate-contracts/external-contracts/{issuerContractExternalReference}/change-paying-account
Change paying account structure for a corporate contract by external reference
GET
/issuers/{issuerId}/corporate-contracts/{contractReference}/contract-owner
Retrieve contract owner for a corporate contract (beta)
GET
/issuers/{issuerId}/corporate-contracts/external-contracts/{issuerContractExternalReference}/contract-owner
Retrieve contract owner for a corporate contract by external reference (beta)
POST
/issuers/{issuerId}/corporate-contracts/{contractReference}/card-contracts/{cardContractReference}/reallocate
Reallocate employee
POST
/issuers/{issuerId}/corporate-contracts/external-contracts/{issuerContractExternalReference}/card-contracts/{cardContractReference}/reallocate
Reallocate employee by issuer contract external reference
POST
/issuers/{issuerId}/corporate-contracts/{contractReference}/card-contracts/external-card-contracts/{issuerCardContractExternalReference}/reallocate
Reallocate employee by issuer card contract external reference
POST
/issuers/{issuerId}/corporate-contracts/external-contracts/{issuerContractExternalReference}/card-contracts/external-card-contracts/{issuerCardContractExternalReference}/reallocate
Reallocate employee by issuer contract external reference and issuer card contract external reference
Schemas 191
The contract defines 191 schemas that model the data the API accepts and returns. The most detailed are Account (103 properties), CardContract (58 properties), Card (53 properties), ContractMember (44 properties). Each schema is shown below with its type and property counts.
CorporateContractFee
object
Specify the corporate contract Fee
CreateCorporateContractResponseAddress
object
3 properties
3 required
ModifyCorporateContractEntityRequest
object
2 properties
CreateCorporateContractRequestVcaServiceCardContract
object
Data related to each VCA service virtual card contract needs to be provided
10 properties
CreateAddOnSubscriptionResponse
object
4 properties
2 required
CreateCorporateContractResponseCorporateContractLevel
object
2 properties
2 required
ChangePayingAccountResponseCorporateContract
object
3 properties
CardBlockingInformation
object
25 properties
1 required
EmailAddress
object
1 property
1 required
CardContractModel
object
2 properties
HierarchyOutgoingCreditTransferFeature
object
Specify OctFeature (periodicOct, periodicOctType, periodicOctMaxThreshold, etc.)
9 properties
CreateCorporateContractRequestAddCorporateContractEntity
object
7 properties
5 required
AdvertisementFlags
object
Specify possible channels used to provide advertisements
6 properties
ForbiddenErrorApiResponse
object
1 property
1 required
NotFoundResponseMetadata
object
4 properties
4 required
ModifyCorporateEmployeeAccountRequest
object
2 properties
ApiResponseEntityAddCorporateEmployeeCardsAndAccountsResponse
object
Issuer response entity
2 properties
1 required
CreateCorporateContractResponseCorporateEmployeeAccount
object
2 properties
1 required
CardIdentifier
object
Identification of the card either by Issuer card external reference or by card reference
2 properties
CreateCorporateContractResponseCorporateEmployeeCard
object
1 property
ForbiddenResponseMetadata
object
4 properties
4 required
CreateCorporateContractRequestAddOnParameter
object
2 properties
CreateCorporateContractRequestVcaServiceCard
object
Card related data to be provided for the creation of the card.
3 properties
SepaMandateMailAddress
object
13 properties
ApiResponseEntityAddCorporateContractEntityResponse
object
Issuer response entity
2 properties
1 required
CreateCorporateContractRequestCard
object
Card related data to be provided for the creation of the card.
11 properties
CreateCorporateContractRequestCorporateVcaServiceCard
object
1 property
InternalServerErrorErrorApiResponse
object
1 property
1 required
ApiResponseEntityAddCorporateVcaServiceCardsAndAccountsResponse
object
Issuer response entity
2 properties
1 required
AccountModel
object
3 properties
ContractMember
object
44 properties
UnauthorizedResponseMetadata
object
4 properties
4 required
ApiResponseEntityContractMember
object
Issuer response entity
2 properties
1 required
CreateCorporateContractRequestAddressUsage
object
5 properties
2 required
CancelChangePayingAccountResponse
object
1 property
FeePostingEntityIdentifier
object
3 properties
ApiResponseEntityListAddonSubscription
object
Issuer response entity
2 properties
1 required
DeliveryChannel
object
Specify the channel for letter delivery used for this contract
3 properties
CycleInformation
object
Dates related to the closure calendar for the open closure cycle
10 properties
ChangePayingAccountResponseAccount
object
4 properties
AddOnServiceParameter
object
4 properties
ApiResponseEntityCorporateEmployeeAccountResponse
object
Issuer response entity
2 properties
1 required
ReallocateEmployeeRequest
object
2 properties
1 required
CloseCorporateContractResponseAccount
object
1 property
ModifyCorporateEmployeeAccountRequestCorporateEmployeeAccount
object
8 properties
OrderIdentifier
object
Order reference calculated by our system
1 property
FeeCondition
object
3 properties
ContractModel
object
Model containing predefined configuration for fee generation applicable on a contract
2 properties
CreateCorporateContractResponseContract
object
13 properties
7 required
CreateAddressRequestMailAddress
object
14 properties
1 required
InsuranceEvent
object
3 properties
ApiResponseEntityCorporateContract
object
Issuer response entity
2 properties
1 required
AccountIdentifier
object
2 properties
CreateCorporateContractRequestCorporateContractLevel
object
2 properties
2 required
RefundFeeOnDemandResponse
object
3 properties
RemoveAddOnSubscriptionResponse
object
4 properties
2 required
InternalServerErrorResponseMetadata
object
4 properties
4 required
Address
object
15 properties
2 required
CreateCorporateContractResponseAccount
object
5 properties
3 required
ResponseMetadata
object
6 properties
4 required
CorporateContract
object
31 properties
NotFoundErrorApiResponse
object
1 property
1 required
CreateCorporateContractRequestCorporateContractEntityAccount
object
1 property
ModifyCorporateContractEntityResponse
object
2 properties
2 required
AddCorporateContractEntityRequest
object
3 properties
1 required
CreateCorporateContractRequestAccountHierarchy
object
The issuer must provide at least data related to the root account when creating the corporate contract.
5 properties
AddCorporateEmployeeCardsAndAccountsResponseCorporateContractEntity
object
4 properties
2 required
UnauthorizedErrorApiResponse
object
1 property
1 required
ExternalRestriction
object
5 properties
1 required
AccountRelation
object
2 properties
2 required
AddressUsage
object
3 properties
2 required
CreateCorporateContractRequestCustomer
object
35 properties
3 required
ExternalVelocityLimitIdentifier
object
1 property
Vulnerability
object
2 properties
1 required
CreateCorporateContractResponseOrder
object
3 properties
ModifyCorporateEmployeeAccountRequestCorporateContractFee
object
8 properties
ApiResponseEntityModifyCorporateEmployeeAccountResponse
object
Issuer response entity
2 properties
1 required
RemoveAddOnSubscriptionRequest
object
5 properties
2 required
ReallocateEmployeeResponseOriginalCorporateEmployeeAccount
object
2 properties
2 required
AddressVersionIdentifier
object
1 property
ExternalVelocityLimit
object
7 properties
1 required
CreateAddressRequestPhoneNumber
object
2 properties
1 required
CardContractIdentifier
object
Identification of the card contract either by Issuer card contract external reference or by card contract reference
2 properties
CreateCorporateContractRequestCorporateEmployeeAccount
object
9 properties
BadRequestResponseMetadata
object
4 properties
4 required
CreateCorporateContractResponseCardContract
object
4 properties
CreateCorporateContractResponseCorporateContractEntity
object
6 properties
4 required
CardStatusHistory
object
6 properties
CreateCorporateContractRequestSepaMandate
object
The issuer must provide SEPA mandate if payment processing channel is SEPA (SEPA indicator is true) and payment mode is AUTOPAYMENT
13 properties
1 required
CreateCorporateContractRequestCardOrder
object
The issuer can provide data related to the card order if physical card is requested. If not provided and required then the default sending mode is retrieved fr…
4 properties
CreateCorporateContractResponseContact
object
4 properties
1 required
CreateCorporateContractRequestCompany
object
17 properties
3 required
CreateCorporateContractResponseCustomer
object
5 properties
4 required
CreateCorporateContractResponseCorporateContractRootEntity
object
2 properties
2 required
ApiResponseEntityModifyCorporateContractResponse
object
Issuer response entity
2 properties
1 required
ProductExtensionIdentifier
object
1 property
Order
object
35 properties
CreateCorporateContractRequestCorporateEmployeeCard
object
1 property
BadRequestErrorApiResponse
object
1 property
1 required
CardContract
object
58 properties
ReallocateEmployeeResponse
object
2 properties
2 required
CorporateContractEntity
object
Specify the corporate contract entity
8 properties
ContractFee
object
6 properties
ApiResponseEntityRemoveAddOnSubscriptionResponse
object
Issuer response entity
2 properties
1 required
ReallocateEmployeeResponseOriginalAccount
object
4 properties
4 required
Links
object
2 properties
1 required
PinInheritanceCardIdentifier
object
2 properties
ContactCenter
object
6 properties
InsuranceContractIdentifier
object
The insurance package which is linked to this contract
1 property
InsuranceContract
object
10 properties
CreateCorporateContractRequestPinMailerOrder
object
The issuer can provide data related to a PIN mailer order if it is configured as required in the PIN production model. If not provided and required then the de…
3 properties
Contact
object
11 properties
CreateAddOnSubscriptionRequest
object
7 properties
2 required
CreateCorporateContractRequest
object
6 properties
1 required
ApiResponseEntityCloseCorporateContractResponse
object
Issuer response entity
2 properties
1 required
Card
object
53 properties
1 required
ReallocateEmployeeResponseChangedCorporateEmployeeAccount
object
3 properties
3 required
ReallocateEmployeeResponseChangedCardContract
object
3 properties
3 required
CreateCorporateContractRequestAddCorporateVcaServiceCardsAndAccounts
object
5 properties
2 required
CreateCorporateContractRequestAddress
object
8 properties
2 required
CreateCorporateContractRequestAddCorporateEmployeeCardsAndAccounts
object
5 properties
3 required
MultiCardInfo
object
3 properties
ContactCenterIdentifier
object
1 property
CreateCorporateContractResponseCompany
object
4 properties
2 required
AccountStatusHistory
object
3 properties
AccountHierarchyModel
object
2 properties
ExternalRestrictionIdentifier
object
1 property
ReallocateEmployeeResponseChangedAccount
object
4 properties
4 required
ApiResponseEntityChangePayingAccountResponse
object
Issuer response entity
2 properties
1 required
BadGatewayErrorApiResponse
object
1 property
1 required
CloseCorporateContractRequest
object
5 properties
2 required
AddOnSubscription
object
6 properties
CustomerIdentifier
object
Identification of the updated customer either by Issuer customer external reference or by customer reference
2 properties
InsuranceContractPackage
object
2 properties
HierarchyOperationStatus
object
4 properties
BadGatewayResponseMetadata
object
4 properties
4 required
AddCorporateEmployeeCardsAndAccountsRequest
object
2 properties
1 required
ChangePayingAccountResponse
object
1 property
CreateCorporateContractRequestHierarchyOutgoingCreditTransferFeature
object
The issuer can enable or not each different Outgoing Credit Transfer (OCT) options if this latter is enabled and if can be overriden within the reimbursement m…
8 properties
HierarchyOperationStatusHistory
object
6 properties
CreateCorporateContractRequestContract
object
The issuer must provide data related to the contract.
18 properties
3 required
AddressIdentifier
object
2 properties
LoyaltyPoint
object
2 properties
CreateAddOnSubscriptionRequestAddOnParameter
object
2 properties
2 required
AddCorporateEmployeeCardsAndAccountsResponse
object
2 properties
1 required
ProductIdentifier
object
2 properties
CreateCorporateContractRequestCorporateContractRootEntity
object
The issuer must define the first level of the company organization (corresponding to the root entity).
4 properties
2 required
CreateCorporateContractResponseCorporateContractEntityAccount
object
1 property
EncryptedPan
object
2 properties
AuthorizationDataValidation
object
The issuer can update cardholder data used by the Front Office for verification (AVS/ANI).
6 properties
AddCorporateContractEntityResponseContract
object
2 properties
2 required
CloseCorporateContractResponse
object
2 properties
2 required
ApiResponseEntityCreateAddOnSubscriptionResponse
object
Issuer response entity
2 properties
1 required
ApiResponseEntityCreateCorporateContractResponse
object
Issuer response entity
2 properties
1 required
CreateCorporateContractRequestCorporateContractFee
object
7 properties
CreateCorporateContractRequestCardContract
object
Data related to each card contract and card have to be provided. If there is no card at creation time then no data to be provided.
19 properties
CreateCorporateContractRequestContact
object
8 properties
MailAddress
object
15 properties
1 required
MultiCard
object
6 properties
RefundFeeOnDemandRequest
object
2 properties
2 required
InsurancePackageIdentifier
object
Unique identifier of the insurance contract package
1 property
PinInheritanceExternalCardIdentifier
object
1 property
ContactIdentifier
object
1 property
ModifyCorporateEmployeeAccountResponse
object
1 property
CreateCorporateContractResponseCorporateEmployeeCardsAndAccounts
object
3 properties
1 required
ChangePayingAccountRequest
object
1 property
1 required
CorporateContractLevel
object
Specify the level in the company organization
2 properties
AddCorporateEmployeeCardsAndAccountsResponseContract
object
3 properties
2 required
CloseCorporateContractResponseCorporateContract
object
3 properties
3 required
ModifyCorporateContractResponse
object
1 property
1 required
CreateCorporateContractRequestAddOnSubscription
object
4 properties
PhoneNumber
object
3 properties
1 required
CreateCorporateContractResponseCard
object
8 properties
AddCorporateContractEntityResponse
object
3 properties
Customer
object
43 properties
2 required
AccountOutgoingCreditTransferFeature
object
Specify OctFeature (periodicOct, periodicOctType, periodicOctMaxThreshold, etc.)
9 properties
CreateCorporateContractResponse
object
3 properties
1 required
ApiResponseEntityRefundFeeOnDemandResponse
object
Refund Fee On Demand response entity
2 properties
1 required
OrderStatusHistory
object
3 properties
ModifyCorporateContractRequest
object
12 properties
ApiResponseEntityModifyCorporateContractEntityResponse
object
Issuer response entity
2 properties
1 required
AddCorporateVcaServiceCardsAndAccountsResponse
object
2 properties
1 required
Account
object
103 properties
12 required
CorporateEmployeeAccount
object
Specify the corporate employee account
17 properties
ApiResponseEntityReallocateEmployeeResponse
object
Reallocate Employee response entity
2 properties
1 required
ChangePayingAccountResponseAccountFutureUpdate
object
4 properties
CreateCorporateContractRequestAccount
object
32 properties
ContractIdentifier
object
Identification of thecorporate contract either by Issuer contract external reference or by contract reference
2 properties
Company
object
21 properties
AddCorporateVcaServiceCardsAndAccountsRequest
object
2 properties
1 required
Amount
object
3 properties
3 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Worldline 12
Other APIs Worldline publishes across the network.
Worldline Connect (Global Collect) API
Worldline Direct (Global Online Pay) API
Worldline Acquiring API
Worldline Financial Services Issuing API
Worldline Financial Services Acquiring API
Worldline Open Banking API
Worldline SmartPOS API
Worldline Identity and Authentication API
Worldline Account - AccountState API
Worldline Account API
Worldline Account - Authorization API
Worldline Account - Authorization Restriction API
#Corporate Contract
Where this information came from
This is an independent, third-party profile of Worldline Corporate Contract API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.