From e74d9cfb7f91157327dbd2397cc4d469c406cc51 Mon Sep 17 00:00:00 2001
From: frank <frank@yuansfer.com>
Date: Thu, 3 Nov 2022 17:29:16 +0800
Subject: [PATCH] credit card recurring

---
 credit-card.md | 119 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 119 insertions(+)
 create mode 100644 credit-card.md

diff --git a/credit-card.md b/credit-card.md
new file mode 100644
index 0000000..752489a
--- /dev/null
+++ b/credit-card.md
@@ -0,0 +1,119 @@
+
+
+# card on file
+
+* 保存卡号， recurring
+* creditType = cit
+
+### Request
+
+```json
+{
+    "amount": "50",
+    "callbackUrl": "https://exmaple.com/notify?transactionNo={transactionNo}&status={status}&amount={amount}&time={time}&reference={reference}&note={note}",
+    "creditType": "cit",
+    "currency": "USD",
+    "description": "ae8d38bb057396f5e42882db0f176904",
+    "ipnUrl": "https://exmaple.com/notify",
+    "merchantNo": "202553",
+    "note": "ae8d38bb057396f5e42882db0f176904",
+    "reference": "ae8d38bb057396f5e42882db0f176904",
+    "settleCurrency": "USD",
+    "storeNo": "300014",
+    "terminal": "ONLINE",
+    "timeout": "120",
+    "vendor": "creditcard",
+    "verifySign": "add5dfcc303514dac1c9427524ca2a31"
+}
+```
+
+### Response
+
+```json
+{
+    "result":
+    {
+        "amount": "50.00",
+        "cashierUrl": "http://ldd-tys.yunkeguan.com/app-redirect-record/yuansfer-redirect-record/297554233633599712",
+        "currency": "USD",
+        "reference": "ae8d38bb057396f5e42882db0f176904",
+        "settleCurrency": "USD",
+        "transactionNo": "297554233633599712"
+    },
+    "ret_code": "000100",
+    "ret_msg": "prepay success "
+}
+```
+
+### IPN交易结果通知
+
+* `cardNumber`参数为卡号对应的token，请妥善保存，使用cardNumber可直接扣款。与merchantNo绑定。
+
+###### cardType 枚举
+
+|Code|描述|
+|---|---|
+|V|VISA|
+|M|MASTERCARD|
+|X|AMERICAN EXPRESS|
+|J|JCB|
+|R|DISCOVER|
+
+
+```json
+ {
+     "amount": "50.00",
+     "cardNumber": "8aigMwX85Mj81111",
+     "cardType": "V",
+     "note": "ae8d38bb057396f5e42882db0f176904",
+     "reference": "ae8d38bb057396f5e42882db0f176904",
+     "status": "success",
+     "time": "20221103170757",
+     "transactionNo": "297554233633599712",
+     "verifySign": "c2c50ff2c5411922d1b5c790d3518cee"
+ }
+```
+
+# Recurring示例
+
+* creditType = cit
+
+### Request
+
+```json
+{
+    "amount": "321.66",
+    "cardNumber": "8aigMwX85Mj81111",
+    "creditType": "cit",
+    "currency": "USD",
+    "description": "0badeefee75229756011b3cb5f5e507e",
+    "merchantNo": "202553",
+    "note": "0badeefee75229756011b3cb5f5e507e",
+    "reference": "0badeefee75229756011b3cb5f5e507e",
+    "settleCurrency": "USD",
+    "storeNo": "300014",
+    "terminal": "ONLINE",
+    "timeout": "120",
+    "vendor": "creditcard",
+    "verifySign": "e124296fcf97566792d5c757c04bb913"
+}
+```
+
+### Response
+
+```json
+{
+    "result":
+    {
+        "amount": "321.66",
+        "cardNumber": "8aigMwX85Mj81111",
+        "cardType": "V",
+        "reference": "0badeefee75229756011b3cb5f5e507e",
+        "time": "20221103172454",
+        "yuansferId": "297552263622460720"
+    },
+    "ret_code": "000100",
+    "ret_msg": "Success"
+}
+```
+