webhook_auxilio_brasil

Auxílio Brasil Webhook

创建操作

在我们系统中创建 Auxílio Brasil 操作时，可能出现以下状态：

success：表示福利查询成功。
failure：表示福利查询过程中发生错误。

示例

查询成功 Webhook

body.json

{
    "callback": {
        "key": "bfbe918d-fe58-55a0-bdaf-5a3733b7a12d",
        "data": {
            "name": "LUIZ ANTONIO DA SILVA",
            "state": "RJ",
            "balance": "111",
            "family_code": 8553463416,
            "reference_date": "2022-08-03",
            "benefit_net_amount": 294,
            "benefit_total_amount": 294,
            "disbursement_bank_account": {
                "bank_code": "103",
                "account_digit": "5",
                "account_branch": "3880",
                "account_number": "000925559475"
            },
            "number_of_active_reservations": 0
        },
        "status": "success",
        "webhook_type": "social_benefit_balance",
        "event_datetime": "2022-08-29T20:47:48"
    }
}

查询错误 Webhook

body.json

{
    "callback": {
        "key": "5d85a8eb-94c1-4fcc-8f66-15b6301f6kfe",
        "data": {
            "enumerator": "not_found_family_member",
            "description": "there is not an active authorization for person"
        },
        "status": "failure",
        "webhook_type": "social_benefit_balance",
        "event_datetime": "2022-10-17T21:54:16"
    }
}

枚举值	描述
`dataprev_error`	Dataprev 意外错误
`not_found_family_member`	该人员没有有效授权
`benefit_deleted`	福利已被删除

取消操作

有几种情况会导致信贷操作被取消，主要包括：

PIX/TED 失败或被冲销；
已过放款日期；
背书申请被拒绝；

我们系统中所有已取消的操作都可以通过修改放款日期的方式恢复到之前的状态。某些情况无法恢复到初始状态，因为永远不会放款，例如第3种情况——背书申请被拒绝。

第一种情况：

body.json

{
    "key": "\<CHAVE DA OPERAÇÃO DE CRÉDITO\>",
    "data": {
        "pix_refusal": {
            "reason": "Número da conta de destino é inexistente ou inválido.",
            "reason_enumerator": "invalid_account"
        },
        "cancel_reason": "pix_refusal"
    },
    "status": "canceled",
    "webhook_type": "debt",
    "event_datetime": "2022-11-01 13:39:44"
}

reason_enumerator 可以是以下列表中的值：

枚举值	描述
`invalid_document_number`	无效证件号
`invalid_account`	无效账户
`unsupported_transaction`	不支持的交易
`blocked_account`	账户已冻结
`closed_account`	账户已关闭
`rejected_payment`	支付被拒绝
`amount_too_great`	金额过高
`spi_timeout`	服务提供商超时
`receiver_error`	接收方错误
`incorrect_account_type`	账户类型不正确
`duplicity_of_payment_order`	重复支付订单
`refund_after_unexpected_value`	意外金额后的退款
`refund_after_psp_error`	PSP 错误后的退款
`refund_after_technical_issues`	技术问题后的退款
`refund_after_cancellation`	取消后的退款
`refund_after_fraud`	欺诈后的退款
`refund_after_payee_request`	收款方申请后的退款
`refund_after_fraud_report`	欺诈报告后的退款
`payee_not_in_allowed_list`	收款方不在许可列表中
`payee_in_blocked_list`	收款方在黑名单中
`unjustified_payment_order`	无依据支付订单

第二种情况，当某个内部流程触发操作取消时：

body.json

{
    "key": "\<CHAVE DA OPERAÇÃO DE CRÉDITO\>",
    "data": {
        "cancel_reason": "Operacao cancelada manualmente",
        "cancel_reason_enumerator": "manual"
    },
    "status": "canceled",
    "webhook_type": "debt",
    "event_datetime": "2022-11-01 03:46:31"
}

此处可能出现以下 "cancel_reason_enumerators"：

PAB 拒绝中的取消原因枚举值：

枚举值	描述
`social_benefit_ineligible_benefit`	不符合条件的福利
`social_benefit_invalid_beneficiary_data`	受益人数据无效
`social_benefit_invalid_balance`	可用额度不足
`social_benefit_contract_limit_exceeded`	客户不能拥有更多合同
`social_benefit_installments_limit_exceeded`	客户在一份合同中不能有这么多分期
`social_benefit_invalid_disbursement_account`	账户与 DataPrev 不符

日期变更取消原因枚举值

枚举值	描述
`not_collateral_constituted_social_benefit`	日期已变更，操作的担保未被背书
`waiting_signature`	日期已变更，操作未被签署
`not_assigned`	日期已变更，CCB 被配置为转让后放款，但未被转让
`disburse_is_not_allowed`	日期已变更，CCB 被配置为"放款授权"流程，但尚未授权
`manual`	日期已变更，操作未被放款。

以 "social_benefit" 开头的取消原因是永久性的，表示背书请求确实被拒绝了。但其他情况仍可恢复到初始状态，需仔细分析。

Auxílio Brasil Webhook​

Auxílio Brasil Webhook