Cards v4 - Getting Started
Cards v4 write APIs provide certified partner financial networks, issuing banks, and fin-tech partners with an automated path for mutual clients to make self-service connections between the partner and Concur Expense. This path enables the partner to subsequently submit Credit Card Account and Transaction data to Concur Expense in near real time. The write APIs are only available to partners who have been granted access and are creating a certified application. Those are not intended to be accessed by clients directly.
The Cards v4 read APIs can be used to read card transactions for a given user.
Overview
The Cards v4 API exposes the following resources:
| Resource | Description |
|---|---|
| Account | Partners can create Accounts via bulk API. |
| Transaction | Partners can create Transactions via bulk API. Users can retrieve Transactions. |
| Bulk Request | Partners can retrieve the details of a Bulk Request. |
Limitations
Access to this documentation does not provide access to the API.
Write API limitations:
- Cards v4 write APIs are available in all data centers exceptand only to partners who have been granted access.
- Maximum number of accounts / transactions per call is 1000.
- Notification of bulk request completion via Event Subscription Service is already depicted in the process flow diagram but not yet available.
Process Flow
Products and Editions
- Concur Expense Professional Edition
- Concur Expense Standard Edition
Scope Usage
| Name | Description | Endpoint | Supported Authentication |
|---|---|---|---|
cards.account.writeonly |
Write Credit Card Account | POST | Company JWT for certified partners |
cards.transaction.writeonly |
Write Credit Card Transaction | POST | Company JWT for certified partners |
cards.transaction.read |
Read Credit Card Transaction | GET | User JWT |
cards.bulkrequest.read |
Read Bulk Request details | GET | Company JWT for certified partners |
Dependencies
SAP Concur clients must purchase Concur Expense in order to use this API. Please contact your SAP Concur representative for more information.
The Identity v4 API can be used to retrieve the userId and companyId.
Access Token Usage
The write APIs support company level access tokens. The read API for card transactions supports user level access tokens.