> For the complete documentation index, see [llms.txt](https://useepay.gitbook.io/developer/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://useepay.gitbook.io/developer/reference/local-pay-ben-di-hua/ben-di-hua-jie-kou/yin-hang-zhuan-zhang/giropay.md).

# Giropay

## 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)](/developer/gui-fan-xing-shuo-ming/huo-bi-dan-wei.md)                                     |
| currency<mark style="color:red;">\*</mark>        | String(3)    | 3 位 ISO 大写字母货币代码[(详见 ISO 4217)](/developer/gui-fan-xing-shuo-ming/huo-bi-dan-wei.md) 目前仅支持**EUR**                           |
| notifyUrl<mark style="color:red;">\*</mark>       | String(512)  | [异步通知](/developer/reference/notify/notifyurl.md)                                                                            |
| 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

```
amount=100&appId=www.pay.com&autoRedirect=true&country=&currency=EUR&deviceInfo=&echoParam=echoParam&gatewaySource=useepay&language=&merchantNo=500000000007381&notifyUrl=https://gatewaytest.useepay.com/gateway-test/notifyV2u0&orderInfo={"subject":"订单标题"}&payerInfo={"paymentMethod":"giropay","billingAddress":{"houseNo":"El+Gallo+Giro(https://gallogiro.com/)","email":"victor.yang@useepay.com","phoneNo":"(323)+585-4433","firstName":"Victor","lastName":"Yang","street":"7148+Pacific+Blvd,+Huntington+Park,+CA+90255","postalCode":"90225","city":"Huntington+Park","state":"CA","country":"US"}}&redirectUrl=https://gatewaytest.useepay.com/gateway-test/redirectV2u0&reserved=reserved&sign=e719acf5ee23072f3af144e42451219d&signType=MD5&terminalType=WEB&transactionExpirationTime=30&transactionId=202203130722437&transactionType=pay&userInfo={"userId":"victor007","ip":"103.25.65.178","email":"victor.yang@useepay.com","phoneNo":"(323)+585-4433","createTime":"20200520131400"}&version=1.0
```

{% endtab %}

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

```
Location: https://checkout1.uat.useepay.com/?accessToken=eAF1VN1u40QUfhU0ewNSktpjx3F8RRoaWKktgba7WiGEJp4TZ1R7xhqPm7WqXnOBuFyJS7QPAFc8EqvlLTjH9rQFxESy4vMdn5_vfGfumYWmLR3L7tle2cZdigpYxl6p3BnLJqwUj7Y3QhdoKYSDo-iuTGtzcr25Ojvbrt4gUouuAu0uwB2MbFj23T3LhZXXXQ3Dm8N_-EWhrEFf9vD9hOkhn9Gl0vDDTuhbhVkIMVaCfan3hmrbqRIdii-gya2qqbSMrfqDeTGJVegr0Xg8HmcYe5abipDWWtB5h8DZzbdUvMHKxh4__vb-z5_fffj1x7_e_4JQBTY_CO2-7vNSLB5wHkRhFCw4j6MF-gw1ERYG4QCGS86T-SLghDsrdLOqkE50CLyBCEBLI0pgDxOmmrXQ37Qqv90iCRnrkB0k72A0XGKz7NOIR599Mk_n0ziOIoSgEqpE4K4fyqzDOXzeNgBPfYqyXBu9V4XnS0hROyCWghgj7IxzpnqN5aPlFA_aqNkCzvHRioLqC8loQQzsClkpveqz70BKkJuyoHBk0fJaVbA2ZT-HF5tNHPfdFpVbUwAgmGVhghSFAY_jRbpE7it3YaTadx6NEx4mEU-SNEFWsLRlEBE9VwdzXJtWO2mOesxZPtUJGmtASvQ1Mobwi6A_ZIRqN-oA6acTxgkx6GfbS2Q-QPRcRCl17eFRGJsPf_z08fd3BFC9KC3M8sgHsn7q_pubzC2yrLfqLeC0OI4UiULRbk1ZUsu4A_MJ7ptUFnKiwpPeYL-nKPCxVf_6b71TpT32fJjeuMZFO5hSjvtEYyLf9d0dRvVOG2MGUXjDl7QOEpfqmVNvG8N4v3NTkDJ91H5FaGCPkV_DrlHusSEnrPuHROIV_aioTl8ah6Tmwimjh7tiDO2gqktUD02JoxL8-ziWr0zjQOLO0CWzJc0-udxYYu-ELLSClNu0tIY8TYc97M5NLjzFuD0X47pfDWUH7AFX0w9nCHdwrm6yk5PxxnPQuNmzvfP2KQEn_tNXvKWEXlL_ozi6Fy_NeXvQ6wPktyxztoUJE3VdAnboi3spsVWvQB-S7rZZI7Tcmbe-Hmrc3OJmZKjZOqtErTKqqMlA5FGaJ8FU8N1-GoaQT5dxDlNYJmkYi2gRQ8oe_gaN1vDy
```

{% 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)](/developer/gui-fan-xing-shuo-ming/huo-bi-dan-wei.md)                                     |
| currency<mark style="color:red;">\*</mark>        | String(3)    | 3 位 ISO 大写字母货币代码[(详见 ISO 4217)](/developer/gui-fan-xing-shuo-ming/huo-bi-dan-wei.md) 目前仅支持**EUR**                           |
| notifyUrl<mark style="color:red;">\*</mark>       | String(512)  | [异步通知](/developer/reference/notify/notifyurl.md)                                                                            |
| 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" %}

```
https://pay-gateway1.uat.useepay.com/api
Content-Type: application/x-www-form-urlencoded

amount: 10
appId: www.pay.com
currency: EUR
deviceInfo: {}
echoParam: echoParam
gatewaySource: useepay
merchantNo: 500000000007381
notifyUrl: https://gatewaytest.useepay.com/gateway-test/notifyV2u0
orderInfo: {"subject":"订单标题"}
payerInfo: {"paymentMethod":"giropay","authorizationMethod":"cvv","firstName":"amber","lastName":"lei"}
redirectUrl: https://gatewaytest.useepay.com/gateway-test/redirectV2u0
reserved: 
sign: ae30c7870aa44b513d3eecc2d2f58695
signType: MD5
transactionExpirationTime: 10
transactionId: 202203111204074
transactionType: pay
userInfo: {"ip":"103.25.65.178","email":"amber.lei@useepay.com"}
version: 1.0
```

{% endtab %}

{% tab title="Response" %}

```
{
    "amount": "10",
    "redirectUrl": "https://www.computop-paygate.com/giropay.aspx",
    "resultCode": "challenge",
    "sign": "f2bf49d10111b3bdf53b0e965b57d053",
    "errorCode": "3200",
    "transactionId": "202203111204074",
    "errorMsg": "Transaction is pending",
    "transactionType": "pay",
    "reference": "1012203111204656981",
    "redirectMethod": "POST",
    "echoParam": "echoParam",
    "redirectParam": "{\"Len\":\"592\",\"Data\":\"59649884668BE25B2800A1EF3E19EC93F027F34FCCCE772FB161856A2399E07478FA292F18DB8C44A84791D9D2919455775169D6386DA7E3C3E6B302317D4342B4EBE20ABEF4F29F384DA6E0D8FFB0986B88453F1DDC793BA57DD3A3E8B34FD23308908EEC153AB6850263126B5CCC83D668089DEF65CB819ED3B6C6EA407D6631CC2D1B95B30C8D544C97A8E4631090BE60CFB4559C3D59A9A464D76F6A97356B20AD4DA1C25F151CCC5A7BAD415A0800CC2701AB6EB5C78593F4B0A26AE9CB95261E15E55AF7A62D98ADD39F21917E071B7B1BCDCAEF4396570F06E15F0A5DBAFEA51CBB589C166A8786EC369353633A7361EB47FE2E454CC42B108C84CBEF461FEE9FDC17AC5FC2CF5C2EB1359B44760ED074F4C943359D0F56B47F159C5D0B11475E0A10181B9A0C1CFEEA4868063E1FC8B64C3224A212E15D84EE71109CD6DB1A1C916C96CBED61E810E6D96C9447E3820DACF9B5B023D4BF1FA07BC30B01F6B2D3F72A85ECCC0164F7CB947077E135D9CDF07986BCF573FFFD406C7A76ECC92C5AE03BC088169BFB66CA34616146EB23103A93BD4C8DA8AEE1ADE096E349224A4DF8215F1E5D5D0FC9CB89B968F5E7C1EC9DAFD03FC113F311D8D7E36E5B6F3F614AAA7ADF0FD86E76415D87A0BEAB17CC7C1783E0E2E200384E0B67639CBE24AA065061A0EE8F78073668128291ED067FFBADC27B12F9ED90038CB9F561501AE404CFB2ACF5A8A23402B25836B35564D9105E8D8F13A549EA4B37C8413EED4374DA69D56CC2DC63792BC1B3E1C59C14F3286505F78B2433ECBDA10AB3E2D21DEFFDF97AA847CD64E95F98AF31\",\"MerchantID\":\"Ipaylinks1_test\"}",
    "reserved": "",
    "signType": "MD5",
    "currency": "EUR",
    "merchantNo": "500000000007381"
}
```

{% endtab %}
{% endtabs %}

## Params

### PayerInfo Object

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

### BillingAddress Object

| 参数         | 必选    | 类型     | 说明                                                                            |
| ---------- | ----- | ------ | ----------------------------------------------------------------------------- |
| firstName  | **Y** | string | 收货人名                                                                          |
| lastName   | **Y** | string | 收货人姓                                                                          |
| email      | N     | string | 收货邮箱                                                                          |
| phoneNo    | N     | 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](broken://pages/-MVKobi5BxjIFLiFPvkG#goodsinfo) |