# konbini

## Redirect

## Giropay

<mark style="color:green;">`POST`</mark> `USEEPAY_PATH/cashier`

#### Headers

| Name                                           | Type   | Description                       |
| ---------------------------------------------- | ------ | --------------------------------- |
| content-type<mark style="color:red;">\*</mark> | String | application/x-www-form-urlencoded |

#### Request Body

| Name                                              | Type         | Description                                                                                                                 |
| ------------------------------------------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------- |
| transactionType<mark style="color:red;">\*</mark> | String       | <p></p><p></p><p>交易类型 : <strong>pay</strong> </p>                                                                           |
| version<mark style="color:red;">\*</mark>         | String(5)    | 目前固定为 1.0                                                                                                                   |
| signType<mark style="color:red;">\*</mark>        | String       | 商户生成签名字符串所使用的签名算法类型，目前支持：RSA/MD5                                                                                            |
| merchantNo<mark style="color:red;">\*</mark>      | String(16)   | 商户号                                                                                                                         |
| transactionId<mark style="color:red;">\*</mark>   | String(64)   | 商户订单号                                                                                                                       |
| transactionExpirationTime                         | String(6)    | 过期时间 (分钟)                                                                                                                   |
| appId<mark style="color:red;">\*</mark>           | String (128) | 网站域名                                                                                                                        |
| amount<mark style="color:red;">\*</mark>          | String(12)   | 支付金额，单位为对应币种的最小货币单位[(详见 ISO 4217)](https://useepay.gitbook.io/developer/gui-fan-xing-shuo-ming/huo-bi-dan-wei)              |
| currency<mark style="color:red;">\*</mark>        | String(3)    | 3 位 ISO 大写字母货币代码[(详见 ISO 4217)](https://useepay.gitbook.io/developer/gui-fan-xing-shuo-ming/huo-bi-dan-wei) 目前仅支持**EUR**    |
| notifyUrl<mark style="color:red;">\*</mark>       | String(512)  | [异步通知](https://useepay.gitbook.io/developer/reference/notify/notifyurl)                                                     |
| echoParam                                         | String(256)  | 回声参数，响应报文会原样返回                                                                                                              |
| payerInfo<mark style="color:red;">\*</mark>       | String       | Json格式的String 付款方信息, 请下方                                                                                                    |
| orderInfo                                         | String       | json string, 订单信息, 请参考下方                                                                                                    |
| userInfo<mark style="color:red;">\*</mark>        | String       | json string, 消费者信息, 请参考[消费者信息](https://useepay.gitbook.io/developer/reference/api-reference/parameter-description#userinfo) |
| redirectUrl                                       | String(512)  | 跳转商户地址                                                                                                                      |
| autoRedirect                                      | String       | false: 不跳转 默认true                                                                                                           |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "codeUrl": "weixin://wxpay/bizpayurl?pr=qCJcd2azz",
    "amount": "2",
    "resultCode": "pending",
    "sign": "1213b8dd73dff60c62e6c12d7000d32f",
    "errorCode": "3200",
    "transactionId": "202201180239183",
    "errorMsg": "Transaction is pending",
    "transactionType": "pay",
    "reference": "1012201181439650764",
    "echoParam": "echoParam",
    "signType": "MD5",
    "currency": "HKD",
    "merchantNo": "500000000007264"
}
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Request" %}
Request Body

```
```

{% endtab %}

{% tab title="Response" %}
Request Header

```
```

{% endtab %}
{% endtabs %}

## Direct

## Giropay

<mark style="color:green;">`POST`</mark> `USEEPAY_PATH/api`

\#

#### Headers

| Name                                           | Type   | Description                       |
| ---------------------------------------------- | ------ | --------------------------------- |
| content-type<mark style="color:red;">\*</mark> | String | application/x-www-form-urlencoded |

#### Request Body

| Name                                              | Type         | Description                                                                                                                 |
| ------------------------------------------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------- |
| transactionType<mark style="color:red;">\*</mark> | String       | <p></p><p></p><p>交易类型 : <strong>pay</strong> </p>                                                                           |
| version<mark style="color:red;">\*</mark>         | String(5)    | 目前固定为 1.0 (5)                                                                                                               |
| signType<mark style="color:red;">\*</mark>        | String       | 商户生成签名字符串所使用的签名算法类型，目前支持：RSA/MD5                                                                                            |
| merchantNo<mark style="color:red;">\*</mark>      | String(16)   | 商户号                                                                                                                         |
| transactionId<mark style="color:red;">\*</mark>   | String(64)   | 商户订单号                                                                                                                       |
| transactionExpirationTime                         | String(6)    | 过期时间                                                                                                                        |
| appId<mark style="color:red;">\*</mark>           | String (128) | 网站域名                                                                                                                        |
| amount<mark style="color:red;">\*</mark>          | String(12)   | 支付金额，单位为对应币种的最小货币单位[(详见 ISO 4217)](https://useepay.gitbook.io/developer/gui-fan-xing-shuo-ming/huo-bi-dan-wei)              |
| currency<mark style="color:red;">\*</mark>        | String(3)    | 3 位 ISO 大写字母货币代码[(详见 ISO 4217)](https://useepay.gitbook.io/developer/gui-fan-xing-shuo-ming/huo-bi-dan-wei) 目前仅支持**EUR**    |
| notifyUrl<mark style="color:red;">\*</mark>       | String(512)  | [异步通知](https://useepay.gitbook.io/developer/reference/notify/notifyurl)                                                     |
| echoParam                                         | String(256)  | 回声参数，响应报文会原样返回                                                                                                              |
| payerInfo<mark style="color:red;">\*</mark>       | String       | Json格式的String 付款方信息, 请下方                                                                                                    |
| orderInfo                                         | String       | json string, 订单信息, 请参考下方                                                                                                    |
| userInfo<mark style="color:red;">\*</mark>        | String       | json string, 消费者信息, 请参考[消费者信息](https://useepay.gitbook.io/developer/reference/api-reference/parameter-description#userinfo) |
| redirectUrl                                       | String(512)  | 跳转商户地址                                                                                                                      |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "codeUrl": "weixin://wxpay/bizpayurl?pr=qCJcd2azz",
    "amount": "2",
    "resultCode": "pending",
    "sign": "1213b8dd73dff60c62e6c12d7000d32f",
    "errorCode": "3200",
    "transactionId": "202201180239183",
    "errorMsg": "Transaction is pending",
    "transactionType": "pay",
    "reference": "1012201181439650764",
    "echoParam": "echoParam",
    "signType": "MD5",
    "currency": "HKD",
    "merchantNo": "500000000007264"
}
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Request" %}

```
```

{% endtab %}

{% tab title="Response" %}

```
```

{% endtab %}
{% endtabs %}

## Params

### PayerInfo Object

| 参数             | 必选 | 类型          | 说明            |
| -------------- | -- | ----------- | ------------- |
| paymentMethod  | Y  | String      | 目前固定为 konbini |
| billingAddress | Y  | Json String | 账单信息          |

### BillingAddress Object

| 参数         | 必选    | 类型     | 说明                                                                            |
| ---------- | ----- | ------ | ----------------------------------------------------------------------------- |
| firstName  | **Y** | string | 收货人名                                                                          |
| lastName   | **Y** | string | 收货人姓                                                                          |
| email      | **Y** | string | 收货邮箱                                                                          |
| phoneNo    | **Y** | string | 收货手机号                                                                         |
| street     | N     | string | 收货街道地址                                                                        |
| houseNo    | N     | string | 收货街道地址和门牌号当street存在时可以不填                                                      |
| postalCode | N     | string | 邮编，如果该国家或地区由邮编必须传，否则可以不传                                                      |
| city       | N     | string | 城市                                                                            |
| state      | N     | string | 省/州/地区, 需满足 [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)            |
| country    | N     | string | 国家，ISO 两位大写英文国家代码, 需满足 [ISO 3166-1](https://en.wikipedia.org/wiki/ISO_3166-1) |

### UserInfo Object

| 参数      | 必选 | 类型     | 说明                |
| ------- | -- | ------ | ----------------- |
| userId  | N  | string | max=128 用户id      |
| **ip**  | Y  | string | max=128 IPv4或IPv6 |
| email   | N  | string | max=128用户邮箱       |
| phoneNo | N  | string | max=32 用户手机号      |

### OrderInfo Object

| 参数        | 必选 | 类型                       | 说明                                                                                                                                                 |
| --------- | -- | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| subject   | Y  | String（128）              | 订单标题，可以是商品名称                                                                                                                                       |
| goodsInfo | N  | Array Json String (4096) | 商品信息, 请参考 [goodsInfo](https://useepay.gitbook.io/developer/reference/local-pay-ben-di-hua/ben-di-hua-jie-kou/bian-li-dian-zhi-fu/broken-reference) |