# DANA Merchant Portal API Documentation

> Curated LLM entry point for DANA Merchant Portal API documentation. Use these Markdown files to understand onboarding, authentication, sandbox testing, Gapura Payment Gateway integration, API behavior, and settlement reporting.

## Start Here

- [DANA Enterprise Overview](https://dashboard.dana.id/api-docs-v2/llms/guide/overview.md): High-level overview of DANA Enterprise solutions, including Gapura Payment Gateway, Integrated Payment, Disbursement, and Submerchants.
- [Getting Started](https://dashboard.dana.id/api-docs-v2/llms/guide/getting-started/getting-started-onboarding.md): Steps to create a DANA Enterprise account, complete business information, and access the onboarding dashboard.
- [Business Verification Overview](https://dashboard.dana.id/api-docs-v2/llms/guide/getting-started/business-verification-overview.md): Business document verification, required documents, upload flow, and validation steps.
- [Integration Overview](https://dashboard.dana.id/api-docs-v2/llms/guide/getting-started/integration-overview.md): Developer dashboard, webhook setup, credentials, and integration preparation.

## Developer Tools

- [Authentication Asymmetric SNAP](https://dashboard.dana.id/api-docs-v2/llms/guide/authentication/authentication-asymmetric.md): Asymmetric signature authentication, public/private key usage, credential setup, and SNAP request signing.
- [Libraries](https://dashboard.dana.id/api-docs-v2/llms/guide/getting-started/libraries.md): DANA API client libraries and self-testing tools for Go, Node.js, Java, PHP, and Python.
- [Sandbox Tools](https://dashboard.dana.id/api-docs-v2/llms/guide/getting-started/sandbox-tools.md): Sandbox helper tools for transaction simulation and integration testing.
- [Scenario Testing](https://dashboard.dana.id/api-docs-v2/llms/guide/scenario-testing.md): UAT scenario checklist and testing flow before going live.

## Recommended Integration Paths

Use [DANA libraries](https://dashboard.dana.id/api-docs-v2/llms/guide/getting-started/libraries.md) to integrate faster and reduce manual work for request signing, request formatting, and response parsing.

| Goal | Use This When | Primary Docs | API References |
| --- | --- | --- | --- |
| Custom Checkout with SDK | Merchant builds their own checkout page, consults available payment methods, and creates orders through DANA APIs. | [Libraries](https://dashboard.dana.id/api-docs-v2/llms/guide/getting-started/libraries.md), [Authentication Asymmetric SNAP](https://dashboard.dana.id/api-docs-v2/llms/guide/authentication/authentication-asymmetric.md), [Gapura Custom Checkout Guide](https://dashboard.dana.id/api-docs-v2/llms/guide/payment-gateway/custom-checkout.md) | [Consult Pay](https://dashboard.dana.id/api-docs-v2/llms/api/payment-gateway/consult-pay.md), [Create Order - Custom Checkout](https://dashboard.dana.id/api-docs-v2/llms/api/payment-gateway/create-order-custom.md), [Finish Notify](https://dashboard.dana.id/api-docs-v2/llms/api/payment-gateway/finish-notify.md) |
| Hosted Checkout with SDK | Merchant redirects users to a DANA-hosted checkout page and receives payment notification after completion. | [Libraries](https://dashboard.dana.id/api-docs-v2/llms/guide/getting-started/libraries.md), [Authentication Asymmetric SNAP](https://dashboard.dana.id/api-docs-v2/llms/guide/authentication/authentication-asymmetric.md), [Gapura Hosted Checkout Guide](https://dashboard.dana.id/api-docs-v2/llms/guide/payment-gateway/hosted-checkout.md) | [Create Order - Hosted Checkout](https://dashboard.dana.id/api-docs-v2/llms/api/payment-gateway/create-order-hosted.md), [Finish Notify](https://dashboard.dana.id/api-docs-v2/llms/api/payment-gateway/finish-notify.md) |
| Post-payment operations | Merchant needs to check payment status, cancel an order, or refund a payment after order creation. | [Gapura Payment Gateway Overview](https://dashboard.dana.id/api-docs-v2/llms/api/payment-gateway/overview.md) | [Query Payment](https://dashboard.dana.id/api-docs-v2/llms/api/payment-gateway/optional-api/query-payment.md), [Cancel Order](https://dashboard.dana.id/api-docs-v2/llms/api/payment-gateway/optional-api/cancel-order.md), [Refund Order](https://dashboard.dana.id/api-docs-v2/llms/api/payment-gateway/optional-api/refund-order.md) |

## API Basics

- [API Overview](https://dashboard.dana.id/api-docs-v2/llms/api/overview.md): REST API behavior, base URLs, sandbox and production endpoints, and general API conventions.
- [API Status](https://dashboard.dana.id/api-docs-v2/llms/api/api-status.md): DANA Sandbox API status monitoring, uptime, maintenance windows, and live status page.

## Gapura Payment Gateway Overview

- [Gapura Payment Gateway Overview](https://dashboard.dana.id/api-docs-v2/llms/api/payment-gateway/overview.md): Gapura solution overview, Hosted Checkout and Custom Checkout scenarios, process flows, required APIs, optional APIs, and settlement reference.

## Gapura Solution Guides

- [Gapura Custom Checkout Guide](https://dashboard.dana.id/api-docs-v2/llms/guide/payment-gateway/custom-checkout.md): Integration guide for merchants that build their own checkout page and use DANA payment APIs directly.
- [Gapura Hosted Checkout Guide](https://dashboard.dana.id/api-docs-v2/llms/guide/payment-gateway/hosted-checkout.md): Integration guide for merchants that redirect users to a DANA-hosted checkout page.

## Gapura Payment Gateway APIs

- [Consult Pay](https://dashboard.dana.id/api-docs-v2/llms/api/payment-gateway/consult-pay.md): Consult available payment methods or payment channels before creating an order for Custom Checkout.
- [Create Order - Custom Checkout](https://dashboard.dana.id/api-docs-v2/llms/api/payment-gateway/create-order-custom.md): Create a Payment Gateway order for Custom Checkout flows, including idempotency, pay options, URL params, and additional info.
- [Create Order - Hosted Checkout](https://dashboard.dana.id/api-docs-v2/llms/api/payment-gateway/create-order-hosted.md): Create a Payment Gateway order for Hosted Checkout flows and receive a checkout redirect URL.
- [Finish Notify](https://dashboard.dana.id/api-docs-v2/llms/api/payment-gateway/finish-notify.md): Webhook notification from DANA to merchant systems for payment status and transaction information.

## Gapura Optional APIs

- [Query Payment](https://dashboard.dana.id/api-docs-v2/llms/api/payment-gateway/optional-api/query-payment.md): Query payment status and transaction details from merchant systems to DANA.
- [Cancel Order](https://dashboard.dana.id/api-docs-v2/llms/api/payment-gateway/optional-api/cancel-order.md): Cancel an existing Payment Gateway order from the merchant platform.
- [Refund Order](https://dashboard.dana.id/api-docs-v2/llms/api/payment-gateway/optional-api/refund-order.md): Refund a Payment Gateway order, including refund amount, partner refund number, and refund response handling.

## Settlement

- [Payment Services Settlement File](https://dashboard.dana.id/api-docs-v2/llms/guide/settlement-file/payment-services.md): Settlement file specification, file generation, download flow, and field-level settlement report details for payment services.