Genesis Card
快速启动
- 报名 at genesis.com 并获取 API 凭据
- 创建终端 输入 管理控制台 参数如下:
- 开始处理 ——适配器预建并准备使用.
概览
创世纪卡支付整合
| 供应商 ID | genesis_card |
| 类别 | 卡片处理器 |
| 网站 | genesis.com |
配置
所需参数
| 参数 | 说明 |
|---|---|
merchant | 商家标识符 |
api_key | API 键 HMAC-SHA 签名 |
currency | 货币编码(例如: RUB) |
callback_url | URL 提供商的召回通知 |
示例配置
{
"env": "prod",
"merchant": "merchant123",
"api_key": "hmac_secret_key",
"currency": "RUB",
"callback_url": "https://api.merchant.com/callback"
}
付款流程
付款(一个阶段和两个阶段):
单阶段:
- 启动(_T) - 通过下列方式建立付款机制: POST
/payment:(标识符:start_tx)- 发送数据卡( pan, cvc2, exp_ month, exp_ year)(标识符:
exp_month,exp_year) - 客户端_ip, 数量, 货币, 成功_ url, 失败_ url, 回调_ url(标识符:
customer_ip,success_url,fail_url,callback_url) - HMAC-SHA 签名所有参数( 字母顺序)
- 检索交易_ id, 状态, 可选 3DS 参数 (pareq, md, term_ url)(标识符:
transaction_id,term_url)
- 发送数据卡( pan, cvc2, exp_ month, exp_ year)(标识符:
双阶段:
- verify = one_phase(发起付款)
- 承诺未执行(仅使用核查)
付款(一个阶段):
- 启动(_T) - 通过下列方式进行支付: POST
/payout:(标识符:start_tx)- 正在发送目的地_ card, 受益人_ first_ name, 受益人_ last_ name(标识符:
destination_card,beneficiary_first_name,beneficiary_last_name) - 金额、 货币、 顺序_ id(标识符:
order_id) - HMAC-SHA 签名有效载荷
- RSA X 签名信头( S)MD5 散列卡+ 金额+ 货币+ 订单_ id)(标识符:
order_id) - 检索交易_ ID 和状态(标识符:
transaction_id)
- 正在发送目的地_ card, 受益人_ first_ name, 受益人_ last_ name(标识符:
状态检查 :
- POST
/payment/statusor POST/payout/status - 参数:商号、订单_id、时间戳(标识符:
order_id) - HMAC-SHA 签名参数
- 退款状态_ 代码和状态_ text(标识符:
status_code,status_text)
状态映射
| 提供者状况 | 4 工资状况 | 说明 |
|---|---|---|
1 | charging | |
2 | charged | |
6 | rejected | |
-6 | failed |