การทำธุรกรรม

post https://api.cryptomus.com/v2/user-api/transaction/list สำเนา

ขอ

พารามิเตอร์การค้นหา

ชื่อประเภทพารามิเตอร์คำนิยาม
date_fromstringการกรองตามวันที่สร้าง จาก (รูปแบบ: "YYYY-MM-DD H:mm:ss")
date_tostringการกรองตามวันที่สร้างเป็น (รูปแบบ: "YYYY-MM-DD H:mm:ss")
typestringประเภทธุรกรรม

ประเภทพารามิเตอร์

string

คำนิยาม

การกรองตามวันที่สร้าง จาก (รูปแบบ: "YYYY-MM-DD H:mm:ss")

ประเภทพารามิเตอร์

string

คำนิยาม

การกรองตามวันที่สร้างเป็น (รูปแบบ: "YYYY-MM-DD H:mm:ss")

ประเภทพารามิเตอร์

string

คำนิยาม

ประเภทธุรกรรม

ขอตัวอย่าง


curl https://api.cryptomus.com/v2/user-api/transaction/list \
    -X POST \
    -H 'userId: 8b03432e-385b-4670-8d06-064591096795' \
    -H 'sign: fe99035f86fa436181717b302b95bacff1' \
    -H 'Content-Type: application/json' \
    -d '{
    "date_from": "2023-05-16 00:00:00",
    "date_to": "2023-05-16 23:59:59",
    "type": "payment"
  }'
สำเนา

ประเภท

ประเภทคำขอ

ชื่อคำนิยาม
paymentธุรกรรมการชำระเงิน
payoutธุรกรรมการจ่ายเงิน
transferโอนจาก/ไปยังธุรกรรมกระเป๋าเงินธุรกิจ

คำนิยาม

ธุรกรรมการชำระเงิน

คำนิยาม

ธุรกรรมการจ่ายเงิน

คำนิยาม

โอนจาก/ไปยังธุรกรรมกระเป๋าเงินธุรกิจ

การตอบสนอง

พารามิเตอร์การตอบสนอง

ชื่อประเภทพารามิเตอร์คำนิยาม
itemsarray โครงสร้าง
paginateobject โครงสร้าง

ประเภทพารามิเตอร์

array

คำนิยาม

โครงสร้าง

ประเภทพารามิเตอร์

object

คำนิยาม

โครงสร้าง

พารามิเตอร์การตอบสนองรายการ

ชื่อประเภทพารามิเตอร์คำนิยาม
uuidstringUUID ธุรกรรม
typestringประเภทธุรกรรม
statusstring|null โครงสร้าง
created_atstringเวลาทำธุรกรรม
amountstringจำนวน
amount_equivalentstring|nullจำนวนเงินเทียบเท่า
currency_equivalentstring|nullจำนวนเงินเทียบเท่าสกุลเงิน (สกุลเงินที่กำหนดไว้ในบัญชีส่วนตัวของคุณ)
currencystringรหัสสกุลเงิน
networkstring|nullรหัสเครือข่ายบล็อคเชน
txidstring|nullแฮชธุรกรรม
addressstring|nullที่อยู่กระเป๋าเงินสำหรับการชำระเงิน
commentstring|nullบทวิจารณ์

ประเภทพารามิเตอร์

string

คำนิยาม

UUID ธุรกรรม

ประเภทพารามิเตอร์

string

คำนิยาม

ประเภทธุรกรรม

ประเภทพารามิเตอร์

string|null

คำนิยาม

โครงสร้าง

ประเภทพารามิเตอร์

string

คำนิยาม

เวลาทำธุรกรรม

ประเภทพารามิเตอร์

string

คำนิยาม

จำนวน

ประเภทพารามิเตอร์

string|null

คำนิยาม

จำนวนเงินเทียบเท่า

ประเภทพารามิเตอร์

string|null

คำนิยาม

จำนวนเงินเทียบเท่าสกุลเงิน (สกุลเงินที่กำหนดไว้ในบัญชีส่วนตัวของคุณ)

ประเภทพารามิเตอร์

string

คำนิยาม

รหัสสกุลเงิน

ประเภทพารามิเตอร์

string|null

คำนิยาม

รหัสเครือข่ายบล็อคเชน

ประเภทพารามิเตอร์

string|null

คำนิยาม

แฮชธุรกรรม

ประเภทพารามิเตอร์

string|null

คำนิยาม

ที่อยู่กระเป๋าเงินสำหรับการชำระเงิน

ประเภทพารามิเตอร์

string|null

คำนิยาม

บทวิจารณ์

พารามิเตอร์การตอบสนองการแบ่งหน้า

ชื่อประเภทพารามิเตอร์คำนิยาม
countintegerจำนวนรายการในหน้าปัจจุบัน
hasPagesbooleanมีองค์ประกอบเพียงพอที่จะแยกออกเป็นหลายหน้าหรือไม่ (จริง / เท็จ)
nextCursorstring|nullเคอร์เซอร์ไปยังหน้าถัดไป
previousCursorstring|nullเคอร์เซอร์ไปยังหน้าก่อนหน้า
perPageintegerจำนวนองค์ประกอบสูงสุดต่อหน้า

ประเภทพารามิเตอร์

integer

คำนิยาม

จำนวนรายการในหน้าปัจจุบัน

ประเภทพารามิเตอร์

boolean

คำนิยาม

มีองค์ประกอบเพียงพอที่จะแยกออกเป็นหลายหน้าหรือไม่ (จริง / เท็จ)

ประเภทพารามิเตอร์

string|null

คำนิยาม

เคอร์เซอร์ไปยังหน้าถัดไป

ประเภทพารามิเตอร์

string|null

คำนิยาม

เคอร์เซอร์ไปยังหน้าก่อนหน้า

ประเภทพารามิเตอร์

integer

คำนิยาม

จำนวนองค์ประกอบสูงสุดต่อหน้า

พารามิเตอร์การตอบสนองสถานะ

ชื่อคำนิยาม
checkรอให้ธุรกรรมปรากฏบนบล็อคเชน
paidการทำธุรกรรมสำเร็จแล้ว
failข้อผิดพลาดในการทำธุรกรรม
cancelธุรกรรมถูกยกเลิก
lockedเงินทุนถูกล็อคเนื่องจากโปรแกรม AML

คำนิยาม

รอให้ธุรกรรมปรากฏบนบล็อคเชน

คำนิยาม

การทำธุรกรรมสำเร็จแล้ว

คำนิยาม

ข้อผิดพลาดในการทำธุรกรรม

คำนิยาม

ธุรกรรมถูกยกเลิก

คำนิยาม

เงินทุนถูกล็อคเนื่องจากโปรแกรม AML

หากต้องการรับข้อมูลของหน้าถัดไป/ก่อนหน้า ให้ระบุแฮชเคอร์เซอร์ถัดไป/ก่อนหน้าในพารามิเตอร์แบบสอบถาม (?cursor=<nextCursorHash>)

ตัวอย่าง:


curl https://api.cryptomus.com/v2/user-api/transaction/list?cursor=eyJpZCI6MjEyLCJ fcG9pbnRzVzVG9OZhXh0SXRlbXMiOnRydWV9 \
    -X POST \
    -H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
    -H 'sign: f80fa426a89eb62bd53997326865d850' \
    -H 'Content-Type: application/json' \
    -d '{}'
สำเนา

ตัวอย่างการตอบกลับ


1{
2  "state": 0,
3  "result": {
4    "items": [
5      {
6        "uuid": "3a3efbe5-4835-48f3-95c0-7b63e2c8a0b6",
7        "type": "transfer",
8        "status": "paid",
9        "created_at": "2022-07-22T15:11:46.000000Z",
10        "amount": "10.00",
11        "amount_equivalent": "10.1679",
12        "currency_equivalent": "USD",
13        "currency": "USDT",
14        "network": null,
15        "txid": null,
16        "address": null,
17        "comment": null
18      },
19      {
20        "uuid": "d4953ea1-6f55-46f1-b1c9-f72c04badc45",
21        "type": "payout",
22        "status": "paid",
23        "created_at": "2022-09-01T14:46:44.000000Z",
24        "amount": "10.00",
25        "amount_equivalent": "10.1679",
26        "currency_equivalent": "USD",
27        "currency": "USDT",
28        "network": "tron",
29        "txid": null,
30        "address": "TSV1JBNzp71tucPrEsRPG5iLD1DkftzWzF",
31        "comment": null
32      },
33      {
34        "uuid": "690f745a-6b0c-42e1-a6ee-0de34485cab7",
35        "type": "payment",
36        "status": "fail",
37        "created_at": "2022-09-02T08:32:03.000000Z",
38        "amount": "2.00",
39        "amount_equivalent": "10.63359",
40        "currency_equivalent": "USD",
41        "currency": "USDT",
42        "network": "tron",
43        "txid": null,
44        "address": "TSV1JBNzp71tucPrEsRPG5iLD1DkftzWzF",
45        "comment": null
46      }
47    ],
48    "paginate": {
49      "count": 3,
50      "hasPages": true,
51      "nextCursor": "eyJpdiI6IlFIZnd5Lzd0VUN3TGtUNUF6ckV5TEE9PSIsInZhbHVlIjoiUHcvZm1rWmRqdDVKL25NMW5EVEQ1OW9JS0NiSjhJcHd1byt5SGhmVG95UjhGaUlCa3djT1ZSOU5Lc29Id3B3bC80T0VBSnhhZEZBWk1yZUN5RTByN2pKK0dNVUZ0QnFlcThwMU93d0NSR2pXMHJOQWZIa3N6cStmT0YxOG9VVDJyT1Q2NmVhbU9JU1N6cTJsM3JLTitRPT0iLCJtYWMiOiI2M2E4OWVmZTk3MDNjYzUwNjY0ZWY4ZjcxMjUyOGUzMmI4NzNkNWU4YzNlYmUxNmNmMThhM2JhN2RjNTkyYjgxIiwidGFnIjoiIn0=",
52      "previousCursor": null,
53      "perPage": 15
54    }
55  }
56}
57      
สำเนา