API Meest Transfer

Przelewy i wypłaty środków między rachunkami.

Autentykacja

API używa podstawowej autentykacji HTTP (Basic Auth). Każde zapytanie musi zawierać dane uwierzytelniające.

Dane uwierzytelniające składają się z:

app_id — identyfikator aplikacji. Testowe id: transfer_app_id
app_password — hasło aplikacji. Testowe hasło: transfer_app_password

W zapytaniach CURL używamy flagi -u "app_id:app_password", która automatycznie koduje dane w formacie Base64.

Wszystkie zapytania powinny być wysyłane na endpoint z prefiksem /api i zawierać nagłówek Content-Type: application/json.

Sender (Nadawca)

Pobieranie listy nadawców

Pobiera listę wszystkich nadawców przypisanych do konta merchanta.

GET /api/senders

curl -X GET "https://transfer.meestpay.com/api/senders" \
  -u "transfer_app_id:transfer_app_password" \
  -H "Content-Type: application/json"

Pobieranie szczegółów nadawcy

Pobiera szczegółowe informacje o konkretnym nadawcy.

GET /api/senders/1

curl -X GET "https://transfer.meestpay.com/api/senders/1" \
  -u "transfer_app_id:transfer_app_password" \
  -H "Content-Type: application/json"

Tworzenie nadawcy

Tworzy nowego nadawcę.

POST /api/senders

curl -X POST "https://transfer.meestpay.com/api/senders" \
  -u "transfer_app_id:transfer_app_password" \
  -H "Content-Type: application/json" \
  -d '{
    "sender": {
      "first_name": "Jan",
      "middle_name": "",
      "last_name": "Kowalski",
      "email": "jan.kowalski@example.com",
      "city": "Warszawa",
      "country_code": "PL",
      "address": "ul. Przykładowa 123",
      "sender_reference": "REF123",
      "state_code": "",
      "phone": "+48123456789"
    }
  }'

Aktualizacja nadawcy

Aktualizuje dane istniejącego nadawcy.

PATCH /api/senders/1

curl -X PATCH "https://transfer.meestpay.com/api/senders/1" \
  -u "transfer_app_id:transfer_app_password" \
  -H "Content-Type: application/json" \
  -d '{
    "sender": {
      "first_name": "Jan",
      "middle_name": "",
      "last_name": "Nowak",
      "email": "jan.nowak@example.com",
      "city": "Kraków",
      "country_code": "PL",
      "address": "ul. Nowa 456",
      "sender_reference": "REF456",
      "state_code": "",
      "phone": "+48987654321"
    }
  }'

Usuwanie nadawcy

Usuwa nadawcę z systemu.

DELETE /api/senders/1

curl -X DELETE "https://transfer.meestpay.com/api/senders/1" \
  -u "transfer_app_id:transfer_app_password" \
  -H "Content-Type: application/json"

Generowanie linku publicznego

Generuje publiczny link dla nadawcy, który może być użyty do logowania w interfejsie webowym.

POST /api/senders/1/public_link

curl -X POST "https://transfer.meestpay.com/api/senders/1/public_link" \
  -u "transfer_app_id:transfer_app_password" \
  -H "Content-Type: application/json"

Sender Cards (Karty nadawcy)

Pobieranie listy kart nadawcy

Pobiera listę wszystkich kart przypisanych do konkretnego nadawcy.

GET /api/senders/1/sender_cards

curl -X GET "https://transfer.meestpay.com/api/senders/1/sender_cards" \
  -u "transfer_app_id:transfer_app_password" \
  -H "Content-Type: application/json"

Pobieranie szczegółów karty nadawcy

Pobiera szczegółowe informacje o konkretnej karcie nadawcy.

GET /api/sender_cards/1

curl -X GET "https://transfer.meestpay.com/api/sender_cards/1" \
  -u "transfer_app_id:transfer_app_password" \
  -H "Content-Type: application/json"

Dodawanie karty nadawcy

Dodaje nową kartę do nadawcy. Wymaga tokenu karty uzyskanego z systemu płatności.

POST /api/senders/1/sender_cards

curl -X POST "https://transfer.meestpay.com/api/senders/1/sender_cards" \
  -u "transfer_app_id:transfer_app_password" \
  -H "Content-Type: application/json" \
  -d '{
    "sender_card": {
      "token": "card_token_123456"
    }
  }'

Usuwanie karty nadawcy

Usuwa kartę nadawcy z systemu.

DELETE /api/sender_cards/1

curl -X DELETE "https://transfer.meestpay.com/api/sender_cards/1" \
  -u "transfer_app_id:transfer_app_password" \
  -H "Content-Type: application/json"

Receiver (Odbiorca)

Pobieranie listy odbiorców

Pobiera listę wszystkich odbiorców przypisanych do konkretnego nadawcy.

GET /api/senders/1/receivers

curl -X GET "https://transfer.meestpay.com/api/senders/1/receivers" \
  -u "transfer_app_id:transfer_app_password" \
  -H "Content-Type: application/json"

Pobieranie szczegółów odbiorcy

Pobiera szczegółowe informacje o konkretnym odbiorcy.

GET /api/receivers/1

curl -X GET "https://transfer.meestpay.com/api/receivers/1" \
  -u "transfer_app_id:transfer_app_password" \
  -H "Content-Type: application/json"

Tworzenie odbiorcy

Tworzy nowego odbiorcę dla konkretnego nadawcy.

POST /api/senders/1/receivers

curl -X POST "https://transfer.meestpay.com/api/senders/1/receivers" \
  -u "transfer_app_id:transfer_app_password" \
  -H "Content-Type: application/json" \
  -d '{
    "receiver": {
      "first_name": "Anna",
      "middle_name": "",
      "last_name": "Nowak",
      "email": "anna.nowak@example.com",
      "city": "Poznań",
      "country_code": "PL",
      "address": "ul. Przykładowa 789",
      "receiver_reference": "REF789",
      "state_code": "",
      "phone": "+48123456789"
    }
  }'

Aktualizacja odbiorcy

Aktualizuje dane istniejącego odbiorcy.

PATCH /api/receivers/1

curl -X PATCH "https://transfer.meestpay.com/api/receivers/1" \
  -u "transfer_app_id:transfer_app_password" \
  -H "Content-Type: application/json" \
  -d '{
    "receiver": {
      "first_name": "Anna",
      "middle_name": "Maria",
      "last_name": "Nowak",
      "email": "anna.maria.nowak@example.com",
      "city": "Gdańsk",
      "country_code": "PL",
      "address": "ul. Nowa 101",
      "receiver_reference": "REF101",
      "state_code": "",
      "phone": "+48987654321"
    }
  }'

Usuwanie odbiorcy

Usuwa odbiorcę z systemu.

DELETE /api/receivers/1

curl -X DELETE "https://transfer.meestpay.com/api/receivers/1" \
  -u "transfer_app_id:transfer_app_password" \
  -H "Content-Type: application/json"

Receiver Cards (Karty odbiorcy)

Pobieranie listy kart odbiorcy

Pobiera listę wszystkich kart przypisanych do konkretnego odbiorcy.

GET /api/receivers/1/receiver_cards

curl -X GET "https://transfer.meestpay.com/api/receivers/1/receiver_cards" \
  -u "transfer_app_id:transfer_app_password" \
  -H "Content-Type: application/json"

Pobieranie szczegółów karty odbiorcy

Pobiera szczegółowe informacje o konkretnej karcie odbiorcy.

GET /api/receiver_cards/1

curl -X GET "https://transfer.meestpay.com/api/receiver_cards/1" \
  -u "transfer_app_id:transfer_app_password" \
  -H "Content-Type: application/json"

Dodawanie karty odbiorcy

Dodaje nową kartę do odbiorcy. Wymaga tokenu karty uzyskanego z systemu płatności.

POST /api/receivers/1/receiver_cards

curl -X POST "https://transfer.meestpay.com/api/receivers/1/receiver_cards" \
  -u "transfer_app_id:transfer_app_password" \
  -H "Content-Type: application/json" \
  -d '{
    "receiver_card": {
      "token": "card_token_789012"
    }
  }'

Usuwanie karty odbiorcy

Usuwa kartę odbiorcy z systemu.

DELETE /api/receiver_cards/1

curl -X DELETE "https://transfer.meestpay.com/api/receiver_cards/1" \
  -u "transfer_app_id:transfer_app_password" \
  -H "Content-Type: application/json"

Card Transfers (płatności)

Obliczanie transferu

Oblicza kwoty transferu, kurs wymiany oraz opłatę serwisową dla transferu między kartami. Endpoint pozwala na obliczenie kwoty docelowej na podstawie kwoty źródłowej lub odwrotnie, w zależności od parametru conversion_issuer.

POST /api/card_transfers/calculate

curl -X POST "https://transfer.meestpay.com/api/card_transfers/calculate" \
  -u "transfer_app_id:transfer_app_password" \
  -H "Content-Type: application/json" \
  -d '{
    "card_transfer": {
      "sender_id": "1",
      "receiver_id": "2",
      "sender_currency": "USD",
      "receiver_currency": "EUR",
      "conversion_issuer": "sender",
      "sender_amount": "100.00"
    }
  }'

Parametry

sender_id — ID nadawcy (wymagane)
receiver_id — ID odbiorcy (wymagane)
sender_currency — waluta nadawcy (wymagane)
receiver_currency — waluta odbiorcy (wymagane)
conversion_issuer — określa, która kwota jest bazowa do obliczeń: sender lub receiver (wymagane)
sender_amount — kwota w walucie nadawcy (wymagane, jeśli conversion_issuer = sender)
receiver_amount — kwota w walucie odbiorcy (wymagane, jeśli conversion_issuer = receiver)