### IPN Payload Example

Source: https://documenter.getpostman.com/view/19338260/2s9YkkeNKN/index

This JSON object represents the structure of the Instant Payment Notification (IPN) payload sent by FastPay upon a successful payment. It includes details such as transaction IDs, order information, amounts, currency, customer details, and timestamps.

```json
{
  "gw_transaction_id": "AXMNP7A123",
  "merchant_order_id": "M20211231735856794",
  "received_amount": "250.00",
  "currency": "IQD",
  "customer_name": "John Doe",
  "customer_mobile_number": "+9641000000004",
  "at": "2023-12-13 15:32:00",
  "transaction_id": "AXMNP7A123",
  "order_id": "M20211231735856794",
  "customer_account_no": "+9641000000004",
  "status": "Success",
  "received_at": "2023-12-13 15:32:00"
}
```

--------------------------------

### API # APIGW - Payment Initiation

Source: https://documenter.getpostman.com/view/19338260/2s9YkkeNKN/index

Initiates a payment transaction by requesting a unique transaction URL from the FastPay server with necessary credentials and data for validation.

```APIDOC
## POST /api/payment/initiate

### Description
Initiates a payment transaction. The merchant server requests a unique transaction URL from the FastPay server by submitting credentials and data for validation. Upon verification, FastPay issues a Redirect URL to the merchant.

### Method
POST

### Endpoint
/api/payment/initiate

### Parameters
#### Request Body
- **credentials** (object) - Required - Merchant's authentication credentials.
- **transaction_data** (object) - Required - Data required for transaction validation, including amount, currency, order ID, etc.
```

--------------------------------

### API # APIGW - Payment Refund

Source: https://documenter.getpostman.com/view/19338260/2s9YkkeNKN/index

Processes a refund for a previously completed payment transaction.

```APIDOC
## POST /api/refund/process

### Description
Processes a refund for a specified payment transaction. Requires transaction details and refund amount.

### Method
POST

### Endpoint
/api/refund/process

### Parameters
#### Request Body
- **transaction_id** (string) - Required - The unique identifier of the transaction to be refunded.
- **refund_amount** (string) - Required - The amount to be refunded.
- **reason** (string) - Optional - The reason for the refund.
```

--------------------------------

### API # APIGW - Refund Validation

Source: https://documenter.getpostman.com/view/19338260/2s9YkkeNKN/index

Validates the details and authenticity of a refund request or confirmation.

```APIDOC
## POST /api/refund/validate

### Description
Validates the details and authenticity of a refund request or confirmation to ensure it is legitimate and accurate.

### Method
POST

### Endpoint
/api/refund/validate

### Parameters
#### Request Body
- **refund_details** (object) - Required - The details of the refund to be validated.
- **validation_token** (string) - Required - A token used for validating the refund request.
```

--------------------------------

### API # APIGW - Webhook Notification

Source: https://documenter.getpostman.com/view/19338260/2s9YkkeNKN/index

Receives Instant Payment Notification (IPN) messages from FastPay for successful payments.

```APIDOC
## POST /merchant/ipn

### Description
Receives Instant Payment Notification (IPN) messages from FastPay for successful payments. The IPN URL is configurable via the Merchant Web Panel.

### Method
POST

### Endpoint
/merchant/ipn

### Parameters
#### Request Body
- **gw_transaction_id** (string) - The unique identifier of the transaction from FastPay.
- **merchant_order_id** (string) - The merchant's order identifier.
- **received_amount** (string) - The amount received in the transaction.
- **currency** (string) - The currency of the transaction (e.g., IQD).
- **customer_name** (string) - The name of the customer.
- **customer_mobile_number** (string) - The mobile number of the customer.
- **at** (string) - The timestamp when the payment was processed.
- **transaction_id** (string) - An alternative transaction identifier.
- **order_id** (string) - An alternative order identifier.
- **customer_account_no** (string) - The customer's account number.
- **status** (string) - The status of the transaction (e.g., "Success").
- **received_at** (string) - The timestamp when the IPN was received.
```

--------------------------------

### API # APIGW - Payment Validation API

Source: https://documenter.getpostman.com/view/19338260/2s9YkkeNKN/index

Validates the authenticity and accuracy of an Instant Payment Notification (IPN) message received from FastPay.

```APIDOC
## POST /api/payment/validate

### Description
Validates the authenticity and accuracy of an Instant Payment Notification (IPN) message received from FastPay. This is crucial for ensuring the integrity of payment data.

### Method
POST

### Endpoint
/api/payment/validate

### Parameters
#### Request Body
- **ipn_message** (object) - Required - The Instant Payment Notification (IPN) payload received from FastPay.
- **merchant_signature** (string) - Required - A signature generated by the merchant to verify the request's origin and integrity.
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.