Payment Methods Charges

This endpoint allows a user to calculate payment charges associated with different payment methods. It supports scenarios including:

Customer transactions (subAction = "transaction")
Money transfers (subAction = "transfer")

Charges are determined based on:

Selected payment method
Amount and currency
Organisation and customer country

Authentication

string

required

Authentication token obtained after login.

string

required

Device UUID used for request tracking.

string

required

Platform identifier (e.g., “WEB”, “ANDROID”, “IOS”).

Request Body

string

Payment code number. Required if subAction = "transaction".

string

required

Action type. Accepted values:

"transaction"
"transfer"

string

required

Selected payment method. Must match PaymentMethod enum, e.g., "ONLINE_CARD_PAYMENT", "BANK_TRANSFER".

string

Currency code for the transfer (required if subAction = "transfer").

string

Amount for the transfer (required if subAction = "transfer").

Code Examples

curl --request POST \
  --url "https://{your-domain}.fincode.software/api/v6/services/paymentmanagement/payment-methods-charges" \
  --header 'Content-Type: application/json' \
  --header 'X-Auth-Token: your_auth_token' \
  --header 'uuid: your_device_uuid' \
  --header 'platform: WEB' \
  --data '{
    "subAction": "transfer",
    "payment_method": "BANK_TRANSFER",
    "currency": "USD",
    "amount": "150"
  }'

const response = await fetch(
  "https://{your-domain}.fincode.software/api/v6/services/paymentmanagement/payment-methods-charges",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-Auth-Token": authToken,
      "uuid": deviceUuid,
      "platform": "WEB"
    },
    body: JSON.stringify({
      subAction: "transfer",
      payment_method: "BANK_TRANSFER",
      currency: "USD",
      amount: "150"
    })
  }
);

const data = await response.json();

import requests

url = "https://{your-domain}.fincode.software/api/v6/services/paymentmanagement/payment-methods-charges"
headers = {
    "Content-Type": "application/json",
    "X-Auth-Token": "your_auth_token",
    "uuid": "your_device_uuid",
    "platform": "WEB"
}
payload = {
    "subAction": "transfer",
    "payment_method": "BANK_TRANSFER",
    "currency": "USD",
    "amount": "150"
}

response = requests.post(url, json=payload, headers=headers)
data = response.json()

Use Cases

1. Retrieve Charges for a Transfer

await paymentMethodsCharges({
  subAction: "transfer",
  payment_method: "BANK_TRANSFER",
  currency: "USD",
  amount: "150"
});

2. Retrieve Charges for a Transaction

await paymentMethodsCharges({
  subAction: "transaction",
  pcn: "PCN123",
  payment_method: "ONLINE_CARD_PAYMENT"
});

Getting Started

Core Flows

API Endpoints

Authentication

Request Body

Code Examples

Use Cases

1. Retrieve Charges for a Transfer

2. Retrieve Charges for a Transaction

​Authentication

​Request Body

​Code Examples

​Use Cases

​1. Retrieve Charges for a Transfer

​2. Retrieve Charges for a Transaction

Authentication

Request Body

Code Examples

Use Cases

1. Retrieve Charges for a Transfer

2. Retrieve Charges for a Transaction