API PayPal

PAYPAL API

Tích hợp giao dịch PayPal

Truy vấn giao dịch PayPal qua một endpoint thống nhất để đưa thanh toán quốc tế vào hệ thống đối soát. Kết nối này phù hợp cho dịch vụ quốc tế, freelancer và website bán sản phẩm số.

Tài liệu API theo phiên bản

Chọn phiên bản tương ứng trong trang quản lý tài khoản PayPal để xem tham số và dữ liệu trả về.

curl --request GET \
  "https://thueapibank.vn/historyapipaypal/YOUR_TOKEN" \
  --header "Accept: application/json"

<?php
$ch = curl_init('https://thueapibank.vn/historyapipaypal/YOUR_TOKEN');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 20,
    CURLOPT_HTTPHEADER => ['Accept: application/json'],
]);
$response = curl_exec($ch);
$data = json_decode($response, true, flags: JSON_THROW_ON_ERROR);
curl_close($ch);

const response = await fetch('https://thueapibank.vn/historyapipaypal/YOUR_TOKEN', {
  headers: { Accept: 'application/json' }
});

if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

{
  "status": "success",
  "message": "Thành công",
  "transactions": [
    {
      "type": "IN",
      "transactionID": "FT26091912345678",
      "amount": 450000,
      "description": "DH1024 THANH TOAN",
      "transactionDate": "2026-09-19 10:24:36"
    }
  ]
}

curl --request GET \
  "https://thueapibank.vn/historyapipaypalv2/YOUR_TOKEN" \
  --header "Accept: application/json"

<?php
$ch = curl_init('https://thueapibank.vn/historyapipaypalv2/YOUR_TOKEN');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 20,
    CURLOPT_HTTPHEADER => ['Accept: application/json'],
]);
$response = curl_exec($ch);
$data = json_decode($response, true, flags: JSON_THROW_ON_ERROR);
curl_close($ch);

const response = await fetch('https://thueapibank.vn/historyapipaypalv2/YOUR_TOKEN', {
  headers: { Accept: 'application/json' }
});

if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

{
  "status": "success",
  "message": "Thành công",
  "transactions": [
    {
      "type": "IN",
      "transactionID": "FT26091912345678",
      "amount": 450000,
      "description": "DH1024 THANH TOAN",
      "transactionDate": "2026-09-19 10:24:36"
    }
  ]
}

Response thực tế có thể bổ sung trường riêng của PayPal. Luôn kiểm tra trường tồn tại trước khi đọc.

Luồng xử lý khuyến nghị

1. 1
   Lưu mã giao dịch

   Dùng transactionID làm khóa chống xử lý trùng.

2. 2
   Chỉ xử lý tiền vào

   Kiểm tra type === "IN" trước khi ghép đơn.

3. 3
   Ghép đúng đơn hàng

   So khớp số tiền và mã đơn trong nội dung chuyển khoản.

4. 4
   Đối soát lại

   Chạy tác vụ định kỳ để bù các webhook bị chậm hoặc thất bại.

Tài liệu liên quan

API Viettel Money→API ZaloPay→API Binance→