POST /api/v2/server-side-api/purchase/set/transaction/

Thiết lập giao dịch

Tạo giao dịch mới cho người dùng cuối trong ứng dụng của bạn trong Adapty và cung cấp mức độ truy cập. Giao dịch được tạo bởi phương thức này sẽ xuất hiện trong phân tích và Event Feed của bạn, đồng thời sẽ được gửi tới tất cả các tích hợp.

Cập nhật gói đăng ký hiện có: Để cập nhật billing_issue_detected_at hoặc renew_status_changed_at mà không tạo sự kiện subscription_renewed mới, hãy sử dụng lại store_transaction_id hiện có (trong cùng store_original_transaction_id). Việc gửi bất kỳ store_transaction_id mới nào sẽ được coi là giao dịch mới và kích hoạt sự kiện subscription_renewed.

Header parameters

adapty-customer-user-idstring

ID duy nhất của khách hàng trong hệ thống của bạn. Cần cung cấp adapty-customer-user-id hoặc adapty-profile-id.

adapty-profile-idstring

ID duy nhất của hồ sơ người dùng trong hệ thống của bạn. Lựa chọn tốt nhất khi làm việc với hồ sơ ẩn danh. Cần cung cấp adapty-customer-user-id hoặc adapty-profile-id.

Request body

Option 1 — object

Dữ liệu giao dịch cho sản phẩm mua một lần

purchase_typestringrequired

Loại giao dịch mua

One of: "one_time_purchase"

storestringrequired

Cửa hàng nơi thực hiện giao dịch mua. Các giá trị phổ biến bao gồm app_store, play_store, stripe, paddle, hoặc bất kỳ định danh cửa hàng tùy chỉnh nào

environmentstring

Môi trường nơi thực hiện giao dịch mua

One of: "Production", "Sandbox"

store_product_idstringrequired

ID sản phẩm trong cửa hàng

store_transaction_idstringrequired

ID giao dịch trong cửa hàng. Tối đa 50 ký tự. ID giao dịch PayPal và một số cửa hàng tùy chỉnh có thể vượt quá giới hạn này — hãy cắt ngắn hoặc băm giá trị trước khi gửi, nếu không yêu cầu sẽ thất bại.

store_original_transaction_idstringrequired

ID giao dịch gốc trong cửa hàng

is_family_sharedboolean

Liệu giao dịch mua có được chia sẻ gia đình hay không

priceobjectrequired

countrystringrequired

Mã quốc gia

currencystringrequired

Mã tiền tệ

valuenumberrequired

Giá trị giá

purchased_atstringrequired

Thời điểm thực hiện giao dịch mua

variation_idstring

ID biến thể cho A/B test

offerobject

categorystringrequired

Danh mục ưu đãi

One of: "introductory", "promotional", "offer_code", "win_back"

typestringrequired

Loại ưu đãi

One of: "free_trial", "pay_as_you_go", "pay_up_front"

idstring

ID ưu đãi

refunded_atstring

Thời điểm giao dịch mua được hoàn tiền

cancellation_reasonstring

Lý do hủy

One of: "billing_error", "cancelled_by_developer", "new_subscription_replace", "price_increase", "product_was_not_available", "refund", "unknown", "upgraded", "voluntarily_cancelled", "adapty_revoked"

Option 2 — object

Dữ liệu giao dịch cho gói đăng ký

purchase_typestringrequired

Loại giao dịch mua

One of: "subscription"

storestringrequired

Cửa hàng nơi thực hiện giao dịch mua. Các giá trị phổ biến bao gồm app_store, play_store, stripe, paddle, hoặc bất kỳ định danh cửa hàng tùy chỉnh nào

environmentstring

Môi trường nơi thực hiện giao dịch mua

One of: "Production", "Sandbox"

store_product_idstringrequired

ID sản phẩm trong cửa hàng

store_transaction_idstringrequired

store_original_transaction_idstringrequired

ID giao dịch gốc trong cửa hàng

is_family_sharedboolean

Liệu giao dịch mua có được chia sẻ gia đình hay không

priceobjectrequired

countrystringrequired

Mã quốc gia

currencystringrequired

Mã tiền tệ

valuenumberrequired

Giá trị giá

purchased_atstringrequired

Thời điểm thực hiện giao dịch mua

variation_idstring

ID biến thể cho A/B test

offerobject

categorystringrequired

Danh mục ưu đãi

One of: "introductory", "promotional", "offer_code", "win_back"

typestringrequired

Loại ưu đãi

One of: "free_trial", "pay_as_you_go", "pay_up_front"

idstring

ID ưu đãi

refunded_atstring

Thời điểm giao dịch mua được hoàn tiền

cancellation_reasonstring

Lý do hủy

originally_purchased_atstringrequired

Thời điểm gói đăng ký được mua lần đầu

expires_atstringrequired

Thời điểm gói đăng ký hết hạn

renew_statusbooleanrequired

Liệu gói đăng ký có tự động gia hạn hay không

renew_status_changed_atstring

Thời điểm trạng thái gia hạn thay đổi

billing_issue_detected_atstring

Thời điểm phát hiện vấn đề thanh toán

grace_period_expires_atstring

Thời điểm thời gian ân hạn hết hạn

Responses

Giao dịch được ghi lại thành công

Schema

dataobjectrequired

app_idstringrequired

ID nội bộ của ứng dụng của bạn

profile_idstringrequired

ID hồ sơ người dùng Adapty

customer_user_idstringrequired

ID người dùng của bạn trong hệ thống của bạn

total_revenue_usdnumberrequired

Giá trị float biểu thị tổng doanh thu tính bằng USD kiếm được trong hồ sơ người dùng

segment_hashstringrequired

Tham số nội bộ

timestampintegerrequired

Thời gian phản hồi tính bằng mili giây, cần để giải quyết điều kiện tranh chấp

custom_attributesarray of objectrequired

Tối đa 30 thuộc tính tùy chỉnh được phép đặt cho hồ sơ người dùng

keystringrequired

Khóa phải là chuỗi không quá 30 ký tự. Chỉ cho phép chữ cái, số, dấu gạch ngang, dấu chấm và dấu gạch dưới

valuestring | numberrequired

Giá trị thuộc tính không được quá 50 ký tự. Chỉ cho phép chuỗi và số thực làm giá trị

access_levelsarray of objectrequired

Mảng các đối tượng mức độ truy cập. Mảng rỗng nếu khách hàng không có mức độ truy cập nào

access_level_idstring

Định danh mức độ truy cập

storestring

Cửa hàng nơi mức độ truy cập được mua

store_product_idstring

ID sản phẩm trong cửa hàng

store_base_plan_idstring

ID gói cơ bản trong cửa hàng

store_transaction_idstring

ID giao dịch trong cửa hàng

store_original_transaction_idstring

ID giao dịch gốc trong cửa hàng

offerallOf

Thông tin ưu đãi, nếu có áp dụng ưu đãi hoặc ưu đãi giới thiệu

categorystring

Danh mục ưu đãi

One of: "introductory", "promotional", "offer_code", "win_back"

typestring

Loại ưu đãi

One of: "free_trial", "pay_as_you_go", "pay_up_front"

idstring

ID ưu đãi

starts_atstring

Thời điểm mức độ truy cập bắt đầu

purchased_atstring

Thời điểm mức độ truy cập được mua

originally_purchased_atstring

Thời điểm mức độ truy cập được mua lần đầu

expires_atstring

Thời điểm mức độ truy cập hết hạn

renewal_cancelled_atstring

Thời điểm gia hạn bị hủy

billing_issue_detected_atstring

Thời điểm phát hiện vấn đề thanh toán

is_in_grace_periodboolean

Liệu mức độ truy cập có đang trong thời gian ân hạn hay không

cancellation_reasonstring

Lý do hủy

subscriptionsarray of objectrequired

Mảng các đối tượng gói đăng ký. Mảng rỗng nếu khách hàng không có gói đăng ký nào

storestring

Cửa hàng nơi gói đăng ký được mua

store_product_idstring

ID sản phẩm trong cửa hàng

store_base_plan_idstring

ID gói cơ bản trong cửa hàng

store_transaction_idstring

ID giao dịch trong cửa hàng

store_original_transaction_idstring

ID giao dịch gốc trong cửa hàng

offerallOf

Thông tin ưu đãi, nếu có áp dụng ưu đãi hoặc ưu đãi giới thiệu

categorystring

Danh mục ưu đãi

One of: "introductory", "promotional", "offer_code", "win_back"

typestring

Loại ưu đãi

One of: "free_trial", "pay_as_you_go", "pay_up_front"

idstring

ID ưu đãi

environmentstring

Môi trường (Sandbox, Production)

purchased_atstring

Thời điểm gói đăng ký được mua

originally_purchased_atstring

Thời điểm gói đăng ký được mua lần đầu

expires_atstring

Thời điểm gói đăng ký hết hạn

renewal_cancelled_atstring

Thời điểm gia hạn bị hủy

billing_issue_detected_atstring

Thời điểm phát hiện vấn đề thanh toán

is_in_grace_periodboolean

Liệu gói đăng ký có đang trong thời gian ân hạn hay không

cancellation_reasonstring

Lý do hủy

non_subscriptionsarray of objectrequired

Mảng các đối tượng sản phẩm không phải gói đăng ký. Mảng rỗng nếu khách hàng không có giao dịch mua nào

purchase_idstring

Định danh giao dịch mua duy nhất

storestring

Cửa hàng nơi thực hiện giao dịch mua

store_product_idstring

ID sản phẩm trong cửa hàng

store_base_plan_idstring

ID gói cơ bản trong cửa hàng

store_transaction_idstring

ID giao dịch trong cửa hàng

store_original_transaction_idstring

ID giao dịch gốc trong cửa hàng

purchased_atstring

Thời điểm thực hiện giao dịch mua

environmentstring

Môi trường (Sandbox, Production)

is_refundboolean

Liệu đây có phải là hoàn tiền hay không

is_consumableboolean

Liệu đây có phải là giao dịch mua consumable hay không

Yêu cầu không hợp lệ

Schema

errorsarray of objectrequired

sourcestring

Nguồn gốc lỗi

errorsarray of string

Mảng thông báo lỗi

error_codestringrequired

Tên lỗi rút gọn

status_codeintegerrequired

Mã trạng thái HTTP

Không được phép

Schema

errorsarray of objectrequired

sourcestring

Nguồn gốc lỗi

errorsarray of string

Mảng thông báo lỗi

error_codestringrequired

Tên lỗi rút gọn

status_codeintegerrequired

Mã trạng thái HTTP

Không tìm thấy hồ sơ người dùng

Schema

errorsarray of objectrequired

sourcestring

Nguồn gốc lỗi

errorsarray of string

Mảng thông báo lỗi

error_codestringrequired

Tên lỗi rút gọn

status_codeintegerrequired

Mã trạng thái HTTP

Lỗi máy chủ nội bộ

Try it

Authorization

Header parameters

adapty-customer-user-id

adapty-profile-id

Body

curl --request POST \
  --url 'https://api.adapty.io/api/v2/server-side-api/purchase/set/transaction/' \
  --header 'Authorization: Api-Key YOUR_SECRET_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "purchase_type": "one_time_purchase",
    "store": "app_store",
    "environment": "Production",
    "store_product_id": "premium_lifetime",
    "store_transaction_id": "1000000123456789",
    "store_original_transaction_id": "1000000123456789",
    "is_family_shared": false,
    "price": {
      "country": "US",
      "currency": "USD",
      "value": 9.99
    },
    "purchased_at": "2024-01-15T10:30:00Z",
    "variation_id": "variation_123",
    "offer": null,
    "refunded_at": null,
    "cancellation_reason": null
  }'

const response = await fetch('https://api.adapty.io/api/v2/server-side-api/purchase/set/transaction/', {
  method: 'POST',
  headers: {
    'Authorization': 'Api-Key YOUR_SECRET_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "purchase_type": "one_time_purchase",
    "store": "app_store",
    "environment": "Production",
    "store_product_id": "premium_lifetime",
    "store_transaction_id": "1000000123456789",
    "store_original_transaction_id": "1000000123456789",
    "is_family_shared": false,
    "price": {
      "country": "US",
      "currency": "USD",
      "value": 9.99
    },
    "purchased_at": "2024-01-15T10:30:00Z",
    "variation_id": "variation_123",
    "offer": null,
    "refunded_at": null,
    "cancellation_reason": null
  }),
});
const data = await response.json();

import requests

response = requests.post('https://api.adapty.io/api/v2/server-side-api/purchase/set/transaction/', headers={
    'Authorization': 'Api-Key YOUR_SECRET_API_KEY',
    'Content-Type': 'application/json',
}, json={
      "purchase_type": "one_time_purchase",
      "store": "app_store",
      "environment": "Production",
      "store_product_id": "premium_lifetime",
      "store_transaction_id": "1000000123456789",
      "store_original_transaction_id": "1000000123456789",
      "is_family_shared": False,
      "price": {
        "country": "US",
        "currency": "USD",
        "value": 9.99
      },
      "purchased_at": "2024-01-15T10:30:00Z",
      "variation_id": "variation_123",
      "offer": None,
      "refunded_at": None,
      "cancellation_reason": None
    })
data = response.json()