# Tutorials and Guides
source: https://developer.mastercard.com/ethoca-alerts-for-merchants/documentation/tutorials-and-guides/index.md

## Integrate with Ethoca Alerts for Merchants {#integrate-with-ethoca-alerts-for-merchants}

This section provides step-by-step guidance for integrating with Ethoca Alerts for Merchants. For initial setup, start with the Quick Start Guide. Then explore endpoint-specific tutorials for detailed request/response examples and workflows.

*** ** * ** ***

## Getting Started {#getting-started}

**New to the API?** Follow this recommended learning path:

1. **[What Is Ethoca Alerts for Merchants?](https://developer.mastercard.com/ethoca-alerts-for-merchants/documentation/tutorials-and-guides/what-is-ethoca-alerts-for-merchants/index.md)** --- How Ethoca Alerts works, who it helps, and how to use it to prevent chargebacks and reduce fraud losses. (4--7 minutes)
2. **[Quick Start Guide](https://developer.mastercard.com/ethoca-alerts-for-merchants/documentation/tutorials-and-guides/quick-start-guide/index.md)** --- Project setup, credential generation, OAuth configuration, and first sandbox API call (5--10 minutes)
3. **[Reference Application](https://developer.mastercard.com/ethoca-alerts-for-merchants/documentation/tutorials-and-guides/reference-app-tutorial/index.md)** --- Complete end-to-end implementation with source code walkthrough (15--30 minutes)
4. **Choose your integration pattern:**
   * **[Pull API Tutorial](https://developer.mastercard.com/ethoca-alerts-for-merchants/documentation/tutorials-and-guides/pull-api-tutorial/index.md)** --- Polling-based alert retrieval and acknowledgement (10--15 minutes)
   * **[Push API Tutorial](https://developer.mastercard.com/ethoca-alerts-for-merchants/documentation/tutorials-and-guides/push-api-tutorial/index.md)** --- Webhook-based real-time alert delivery (10--15 minutes)
5. **[Outcome API Tutorial](https://developer.mastercard.com/ethoca-alerts-for-merchants/documentation/tutorials-and-guides/outcome-api-tutorial/index.md)** --- Investigation outcome submission (5--10 minutes)
6. **[Data Explanations](https://developer.mastercard.com/ethoca-alerts-for-merchants/documentation/tutorials-and-guides/data-explanations/index.md)** --- Field formats, enumerations, and data model reference (reference as needed)

*** ** * ** ***

## Endpoint Tutorials {#endpoint-tutorials}

### Pull API --- Retrieve and Acknowledge Alerts {#pull-api--retrieve-and-acknowledge-alerts}

[Pull API Tutorial](https://static.developer.mastercard.com/content/ethoca-alerts-for-merchants/documentation/tutorials-and-guides/pull-api-tutorial.md) covers:

* Retrieving alerts with query filters (alert type, date range, batch size)
* Parsing alert payloads and extracting key fields
* Acknowledging alert receipt
* Error handling and retry logic
* Full request/response examples

**Best for:** Developers implementing polling-based integrations.

*** ** * ** ***

### Push API --- Receive Alerts via Webhook {#push-api--receive-alerts-via-webhook}

[Push API Tutorial](https://static.developer.mastercard.com/content/ethoca-alerts-for-merchants/documentation/tutorials-and-guides/push-api-tutorial.md) covers:

* Registering and configuring webhook endpoints
* Receiving webhook POST requests from Ethoca
* Parsing and validating webhook payloads
* Responding with immediate acknowledgement
* Handling retries and out-of-order delivery
* Full request/response examples

**Best for:** Developers implementing real-time push-based integrations.

*** ** * ** ***

### Outcome API --- Submit Investigation Results {#outcome-api--submit-investigation-results}

[Outcome API Tutorial](https://static.developer.mastercard.com/content/ethoca-alerts-for-merchants/documentation/tutorials-and-guides/outcome-api-tutorial.md) covers:

* Investigation workflow and timing (24-hour SLA)
* Outcome code selection based on alert type
* Refund information submission
* Batch outcome submission (up to 25 per request)
* Common outcome patterns and examples
* Full request/response examples

**Best for:** All developers after alert processing is complete.

*** ** * ** ***

## Reference Materials {#reference-materials}

### Quick Reference {#quick-reference}

* [Data Explanations](https://static.developer.mastercard.com/content/ethoca-alerts-for-merchants/documentation/tutorials-and-guides/data-explanations.md) --- Field formats, enumerations, alert types, outcome codes, refund types
* [API Reference](https://developer.mastercard.com/ethoca-alerts-for-merchants/documentation/api-reference/index.md) --- Interactive endpoint documentation
* [Codes \& Formats](https://developer.mastercard.com/ethoca-alerts-for-merchants/documentation/code-and-formats/index.md) --- Error codes and HTTP status mapping
* [Testing](https://developer.mastercard.com/ethoca-alerts-for-merchants/documentation/testing/index.md) --- Sandbox test cases and validation workflows

### Implementation Examples {#implementation-examples}

* [Reference Application](https://static.developer.mastercard.com/content/ethoca-alerts-for-merchants/documentation/tutorials-and-guides/reference-app-tutorial.md) --- Source code and deployment instructions
* [Use Cases](https://developer.mastercard.com/ethoca-alerts-for-merchants/documentation/use-cases/index.md) --- Real-world integration patterns (Push, Pull)
* [Developer Tools](https://developer.mastercard.com/ethoca-alerts-for-merchants/documentation/developer-tools/index.md) --- Postman, Insomnia, reference implementations

*** ** * ** ***

## Production Go-Live {#production-go-live}

Once you've completed Sandbox testing:

* Review [Onboarding Checklist](https://static.developer.mastercard.com/content/ethoca-alerts-for-merchants/documentation/tutorials-and-guides/onboarding-checklist.md) for production enablement steps
* See [Support](https://developer.mastercard.com/ethoca-alerts-for-merchants/documentation/support/index.md) for common questions and troubleshooting
* Contact your Ethoca Customer Delivery Team to schedule production deployment

*** ** * ** ***

## Next Steps {#next-steps}

* Start with [Quick Start Guide](https://static.developer.mastercard.com/content/ethoca-alerts-for-merchants/documentation/tutorials-and-guides/quick-start-guide.md) if you haven't already
* Choose your integration pattern: [Pull API](https://static.developer.mastercard.com/content/ethoca-alerts-for-merchants/documentation/tutorials-and-guides/pull-api-tutorial.md) or [Push API](https://static.developer.mastercard.com/content/ethoca-alerts-for-merchants/documentation/tutorials-and-guides/push-api-tutorial.md)
* Review [Data Explanations](https://static.developer.mastercard.com/content/ethoca-alerts-for-merchants/documentation/tutorials-and-guides/data-explanations.md) for field reference
* Test with [Developer Tools](https://developer.mastercard.com/ethoca-alerts-for-merchants/documentation/developer-tools/index.md)
* Schedule production deployment via [Onboarding Checklist](https://static.developer.mastercard.com/content/ethoca-alerts-for-merchants/documentation/tutorials-and-guides/onboarding-checklist.md)