# Refund a payment

**POST /payment/refund**

Refund all or part of a previous payment.
Can be full or partial refunds.



## Servers
- Production API: https://pay-api.aiic.nz/v1 (Production API)
- Staging API: https://pay-api-staging.aiic.nz/v1 (Staging API)
- Development API: https://pay-api-dev.aiic.nz/v1 (Development API)


## Authentication methods
- Api key auth


## Parameters



### Body: application/json (object)

- **data** (object)
  The actual request data to be processed
- **signature** (string)
  ed25519 signature of the data, signed with user's private key
- **publicKey** (string)
  User's derived public key for signature verification
- **timestamp** (integer)
  Unix timestamp when the request was created (milliseconds)
- **nonce** (string)
  Unique nonce to prevent replay attacks


## Responses
### 201
Refund initiated successfully

#### Body: application/json (object)
- **success** (boolean)

- **refundId** (string)

- **originalTransactionId** (string)

- **amount** (number)

- **status** (string)

- **timestamp** (string(date-time))


### 400
Invalid request parameters

### 401
Authentication failed

### 403
Refund not allowed

### 404
Original transaction not found

### 429
Rate limit exceeded

### 500
Internal server error


[Powered by Bump.sh](https://bump.sh)