Fawry Pay

支付方式属性

属性	值
可用国家代码	埃及（EG）
消费者货币	EGP
处理货币	EGP
结算货币	EGP
类型 I	电子钱包 (wallet)
类型 II	`fawrypay`
会话超时	1小时
退款	支持全额退款，不支持部分退款
拒付	不支持
集成类型	异步

交易流程

消费者在商家结账时选择使用 opay支付。
商户系统将付款请求转发给 Future Pay。
Future Pay向‌Fawry Pay发起支付请求。
在Fawry Pay响应后，Future Pay将响应转发给商户。
消费者确认付款后，Fawry Pay通知支付成功结果到Future Pay。
Future Pay向商户发送成功通知，商户通知消费者支付成功。

集成

请求参数说明

参数名	类型	必填	说明
`reference`	String	是	订单唯一标识
`amount`	Object	是	订单金额信息
├── `currency`	String	是	货币类型（EGP）
├── `value`	Number	是	金额数值，单位为最小货币单位
`productDetail`	String	是	订单描述
`countryCode`	String	是	国家代码（EG）
`origin`	String	是	订单来源，如商城域名
`paymentMethod`	Object	是	支付方式信息
├── `telephoneNumber`	String	是	持卡人手机号
├── `type`	String	是	支付方式（fawrypay）
├── `holderName`	String	否	持卡人姓名
├── `shopperEmail`	String	否	付款人邮箱
`returnUrl`	String	是	支付完成后返回的 URL
`shopperReference`	String	是	付款人唯一标识

交易调用输入示例

{
    "amount": {
        "currency": "EGP",
        "value": 201
    },
    "paymentMethod":{
        "holderName":"test",
        "telephoneNumber":"123456456",
        "shopperEmail":"[email protected]",
        "type":"fawrypay"
    },
    "productDetail": "test",
    "countryCode": "EG",
    "origin": "rrrrrr.com",
    "reference": "show17855224q114",
    "shopperReference": "show17855224q114",
    "returnUrl": "https://www.baidu.com/"
}

交易响应字段说明

参数名	类型	必填	说明
`code`	String	是	响应代码（如 0 表示成功）
`msg`	String	是	响应消息（如 success）
`serverTime`	Number	是	服务端时间戳（毫秒）
`success`	Boolean	是	请求是否成功
`data`	Object	是	响应数据主体
├── `action`	Object	是	支付动作信息
│ ├── `paymentMethodType`	String	是	支付方式类型（fawrypay）
│ ├── `url`	String	是	跳转支付的 URL
│ ├── `method`	String	是	请求方式（如 GET/POST）
│ ├── `type`	String	是	动作类型（如 redirect 表示跳转支付）
├── `amount`	Object	是	订单金额信息
│ ├── `currency`	String	是	货币类型（EGP）
│ ├── `value`	Number	是	金额数值，单位为最小货币单位
├── `merchantReference`	String	是	商户侧订单号
├── `pspReference`	String	是	支付平台订单号（支付服务提供商生成的唯一标识）
├── `resultCode`	String	是	支付结果状态（如 PENDING 表示待支付）

交易调用输出示例

{
    "code": "0",
    "msg": "success",
    "serverTime": 1728633576429,
    "data": {
        "action": {
          "paymentMethodType": "fawrypay",
          "url": "https://r2.girogate.de/molpay/S1389/I?tx=2334590813&rs=ZMQklSaGdmdZw9NTiM16xen8591YbjuY&cs=e1f62ec550918e3471308d9e34a830e3d7f22dc40690616190a9c16d8f653049",
          "method": "Get",
          "type": "redirect"
        },
        "amount": {
            "currency": "EGP",
            "value": 201
        },
        "merchantReference": "9B6F974D3DB8436AA2B139551933FF08",
        "pspReference": "1844649030089572352",
        "resultCode": "PENDING"
    },
    "success": true
}