Tích hợp Thanh Toán ở Backend cho app TikiVIP

1. Điều kiện

Để có thể tích hợp với Backend của Tini App, sau khi đăng ký tài khoản tích hợp, bạn cần sử dụng cặp key api_key và api_secret.

Chú ý rằng cặp key này cần gắn với cặp partner_code và client_id bạn đã sử dụng khi tích hợp ở client. Việc sử dụng sai các key sẽ dẫn tới dữ liệu sai và tích hợp bị sai.

Mọi request gọi tới backend của Tiki đều cần phải có signature. Chi tiết việc tính signature được mô tả trong tài liệu tính signature

2. Luồng tích hợp thanh toán

Để tích hợp thanh toán, Partner cần thực hiện các bước sau (số thứ tự của các bước được tính mô tả trên sơ đồ luồng ở trên):

• Bước 2: Cài đặt hàm Delegate trên ứng dụng Android / iOS của bạn. Chi tiết xem tại phần cài đặt cho Android và iOS

• Bước 4: Cài đặt một webhook IPN để gọi sang backend của Tiki. Mục đích của IPN này nhằm báo cho Backend của Tiki biết giao dịch đã được thực hiện thành công, chi tiết xem tại IPN

Trong trường hợp đối tác gọi tới IPN của Tiki mà bị lỗi, đối tác nên retry gọi lại IPN này ít nhất 3 lần. Sau 3 lần gọi, đối tác cũng có thể gọi API để kiểm tra trạng thái đơn giao dịch

• Bước 12: Cài đặt API để nhận về request hoàn tiền của Tiki. Trong trường hợp cần hoàn tiền, Tiki Backend sẽ gửi tới backend của đối tác chi tiết hoàn tiền cho từng giao dịch

3. Luồng đối soát

Chi tiết của luồng đối soát sẽ được bàn bạn cụ thể với từng đối tác, tạm thời ở đây chúng tôi mô tả một luồng chuẩn về đối soát theo định dạng giao dịch của Tiki.

Luồng đối soát

3.1. Chi tiết file đối soát

File đối soát của đối tác là một file CSV trong đó cần có chứa các trường

tên trường	ý nghĩa
tiki_transaction_id	id giao dịch do Tiki gửi cho đối tác
transaction_id	id giao dịch của đối tác
transaction_amount	số tiền của giao dịch
status	trạng thái của giao dịch
created_at	ngày tạo giao dịch
updated_at	ngày cập nhật của giao dịch