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

Refund Endpoint

Testing

POST

https://ws2-payments.datmanpay.com/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 Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://ws2-payments.datmanpay.com/api2.php?action=refund' \
--header 'api_token: ' \
--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"
}'

Response Example

Success

{
    "outcome": "success"
}

Request

Query Params

action

string

required

Example:

refund

Header Params

api_token

string

required

Example:

Content-Type

string

required

Example:

application/json

Body Params application/json

order_id

string

required

amount

string

required

merchant_id

string

required

reason

string

required

destination

string

optional

requested_by

string

optional

Examples

Responses

🟢200Success

application/json

Body

outcome

string

required

message

string

optional

Token Sale

Transaction Lookup

Refund Endpoint

Refund API#

Overview#

Request

Responses

Refund API

Overview