docs/credit-card.md

# 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"
}
```