# Quick Start Guide source: https://developer.mastercard.com/account-to-account-commerce-for-csp/documentation/getting-started/index.md ## Overview {#overview} The creditor service provider interested in consuming the Account to Account Commerce service must contact the local Mastercard representative to commence the onboarding process. You can also reach out to us by filling out the form [here](https://www.vocalink.com/contact-us/). ## What does this API do? {#what-does-this-api-do} Account to Account Commerce enables creditor service providers (CSPs) to offer pay-by-bank checkout, direct bank payments, bank-app checkout, linked bank account payments, guest checkout, and recurring payment experiences for merchants and consumers. Using these APIs, merchants can allow customers to pay directly from their bank accounts, save bank accounts for future purchases, receive refunds, and manage recurring payment agreements. ## Who should use this API? {#who-should-use-this-api} This API is intended for: * Creditor Service Providers (CSPs) * Payment service providers * Merchant acquiring platforms * Ecommerce platforms * Digital wallet providers * Developers building bank-to-bank ecommerce payment experiences ## Main Supported Flows {#main-supported-flows} Mastercard Account to Account Commerce enables creditor service providers (CSPs) to deliver flexible pay by bank checkout and account-to-account payment solutions for merchants and consumers. It supports key use cases such as linked bank account payments (account-on-file), guest checkout with one-time bank payments, pay and link during checkout, recurring bank payments, bank-to-bank refunds, and payment status tracking. For more details on these use cases and implementation scenarios, refer to the [Use Cases](https://developer.mastercard.com/account-to-account-commerce-for-csp/documentation/use-cases/index.md) topic. ## Process Flow {#process-flow} ![Account to Account Commerce Creditor Process Flow](https://static.developer.mastercard.com/content/account-to-account-commerce-for-csp/documentation/images/A2AC_process_flow.png) ## Account-to-Account Commerce Onboarding Process, Activities, and Customer Responsibilities {#account-to-account-commerce-onboarding-process-activities-and-customer-responsibilities} Any customer seeking to implement the Account-to-Account (A2A) Commerce service must be onboarded onto the Mastercard platform. The onboarding process includes several key activities along with specific customer responsibilities to ensure successful implementation. ### Key Onboarding Activities and Customer Responsibilities {#key-onboarding-activities-and-customer-responsibilities} * Sign the Agreement * Sign the Mastercard Account-to-Account Commerce Agreement. * Obtain Credentials and Access * Obtain Mastercard credentials, including Interbank Card Association (ICA) and Mastercard Connect access. * Create a [Mastercard Developers Account](https://developer.mastercard.com/account/sign-up). and register on [Mastercard Connect](https://www.mastercardconnect.com). * Provide Resources and Information * Provide the necessary resources to support onboarding and testing activities. * Share required participant information for onboarding. * Code Development and Implementation * Develop and implement A2A Commerce according to the technical specifications in the API Reference. * Security Setup (Key Exchange) * Exchange and manage certificates and cryptographic keys through the Key Management Portal (as outlined in [API Basics](https://developer.mastercard.com/account-to-account-commerce-for-csp/documentation/api-basics/index.md)). * Connectivity Setup * Provide a network to establish connectivity between the participant and Mastercard. * Set up a logical address for file exchange. * Data Onboarding and Testing * Complete data onboarding to internal systems, including approximately 7 days in the Mastercard Test Facility (MTF) followed by production onboarding. * Perform certification in MTF and conduct connectivity testing. * Deployment and Launch Preparation * Deploy the solution to production. * Plan and prepare for launch. ## Get access to the API {#get-access-to-the-api} 1. Go to [Mastercard Developers Account](https://developer.mastercard.com/account/sign-up), and register on [Mastercard Connect](https://www.mastercardconnect.com). 2. Activate your account by opening the link sent to your email address, and log in. 3. Open your [My Projects](https://developer.mastercard.com/dashboard) page and start a new project. Sandbox access is open, so you can begin testing as soon as your project credentials are generated. ## Create a project and generate Sandbox credentials {#create-a-project-and-generate-sandbox-credentials} Create a Mastercard Developers project to generate your Sandbox credentials. Sandbox give you access to rich, mocked data that helps you understand the API and validate your integration before requesting Production access. To create a Sandbox project, refer to [Creating Sandbox](https://developer.mastercard.com/account-to-account-commerce-for-csp/tutorial/creating-a-sandbox-project/index.md) guide. ## First Sandbox call {#first-sandbox-call} Once you have your credentials, you can make your first call to the Sandbox environment. To run test cases, refer to [Invoking API using Insomnia](https://developer.mastercard.com/account-to-account-commerce-for-csp/documentation/testing/index.md). ## Integrate and Test {#integrate-and-test} ### Testing the Service {#testing-the-service} Now that you have your credentials, choose your preferred method to start testing immediately: * GUI-based tools (Insomnia): See Testing with [Insomnia](https://developer.mastercard.com/account-to-account-commerce-for-csp/documentation/testing/index.md). * Reference Application: See the [Reference Application](https://developer.mastercard.com/account-to-account-commerce-for-csp/documentation/reference-app/index.md) page. ## Promote the same project to Production {#promote-the-same-project-to-production} Once your project is working in Sandbox, request Production access for that same project. To request a production access, refer to [Move to Production](https://developer.mastercard.com/account-to-account-commerce-for-csp/tutorial/move-to-production/index.md) guide. ## Key Conventions {#key-conventions} | Terms (Acronyms in brackets) | Description | |------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | API Gateway (APIGW) | The API Gateway provides routing, configuration, authentication, and authorization for API traffic between Mastercard and its customers. The primary function of the API Gateway is to act as a security policy enforcement point for Mastercard APIs exposed to customers. | | Creditor | An individual or business who makes a request to the debtor (Payer) for payment, either for a bill, invoice, or funds transfer. | | Creditor Service Provider (CSP) | An entity that consumes Account to Account Commerce services to (1) associate a creditor to a debtor for the purpose of facilitating bill and invoice presentments and peer-to-peer fund transfers, and (2) exchange payment request data with the debtor service providers for such presentments and fund transfer.​ | | Debtor | An individual or business who authorizes a debit of their financial account to make payment for a bill, invoice, or funds transfer request. | | Debtor Service Provider (DSP) | An entity, often but not exclusively a financial institution, that consumes Account to Account Commerce services to (1) associate a debtor to a creditor for the purpose of facilitating bill and invoice presentments and fund transfers, and (2) exchange payment request data with creditor service providers for such presentments and fund transfers. | | Designated Settlement System (DSS) | The Designated Settlement System (DSS) refers to the method of processing settlement instructions and includes a payment system. A payment system is used for transferring funds. | | Initiating Party | Unique identification of the party that has initiated the message exchange. | | Operator | An entity that operates Mastercard's request for pay products, services, and solutions. The operator holds and manages the business relationships with creditor service providers, creditor institutions, debtor service providers, and debtor institutions determines which entities are allowed to be onboarded to Mastercard's Request for Pay (RFP) programs and sets 'resale' pricing of Mastercard RFP services for creditor service providers, creditor institutions, debtor service providers, and debtor institutions. | | Key Management Portal (KMP) | Self-service portal available in Mastercard Connect for participants to request and exchange keys and certificates with Mastercard. | | Key Management Services (KMS) | The business function within Mastercard responsible for keys and certificates exchange. | | Mastercard Connect (MCConnect) | [Mastercard Connect](https://www.mastercardconnect.com/) is a secure global platform for business customers to explore, onboard, enrol, service, and grow their businesses with Mastercard. A self-service portal, available in Mastercard Connect, for participants to request and exchange keys and certificates with Mastercard. | | Mastercard Test Facility (MTF) | Test environment for customers to perform testing with Mastercard. | | AtoAC | Account to Account Commerce. | | Participant (Customer) | A creditor service provider or, a debtor service provider. | | Zapp Platform | Zapp is the core platform powering the Account to Account Commerce solution. | ## Next Steps {#next-steps} 1. Now that you have access to the service, you can begin testing, proceed to the [Use Cases](https://developer.mastercard.com/account-to-account-commerce-for-csp/documentation/use-cases/index.md) section to learn about the different use cases of the service. 2. Use the [API Reference](https://developer.mastercard.com/account-to-account-commerce-for-csp/documentation/api-reference/index.md) section for details on environmental domains and specifications for each APIs. 3. Refer to the [API Basics](https://developer.mastercard.com/account-to-account-commerce-for-csp/documentation/api-basics/index.md) page to understand the Mastercard environments and the required project keys. 4. For information on testing and test cases for each API, visit the [Testing](https://developer.mastercard.com/account-to-account-commerce-for-csp/documentation/testing/index.md) page.