🚧 This project is currently in active development. A sandbox environment will be made available soon for testing and exploration. Stay tuned!

Refund Endpoint

Testing

Sandbox

https://sandbox-payments-{{account-name}}.datmanpay.com

POST

/api2.php

Refund API

Overview

This API is used to initiate a refund for a previously completed transaction. It supports both full and partial refunds, allowing merchants to reverse transactions in cases such as order cancellations, customer disputes, or store closures.

To process a refund, the merchant must provide the order ID, the amount to be refunded, and a reason for the refund.

Request

Query Params

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://sandbox-payments-{{account-name}}.datmanpay.com/api2.php?action=refund' \
--header 'api_token: {{API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "order_id": "12345678",
    "amount": "213.39",
    "merchant_id": "63123098",
    "reason": "store close",
    "destination": "CARD",
    "requested_by": "Client-01",
    "refund_split_fee": [
        {
            "partner_merchant_id": 567891234,
            "refund_amount": 1.00
        }
    ]
}'

Response Example

Success

{
    "outcome": "success"
}

Token Sale

Transaction Lookup

Refund Endpoint

Refund API#

Overview#

Request

Responses

Refund API

Overview