薪资卡手册 - 发行
- 跟踪(下一步)
该 API 仍处于开发阶段,因此本手册可能会有所变动。
1. 查询受益人资格
资格查询可验证某个 CPF 是否符合 INSS 薪资/福利卡申领条件。该操作为同步操作,立即返回核验结果。
持有 CPF 和出生日期数据后,即可查询受益人资格。目前唯一进行的资格验证是受益人年龄是否在 18 至 65 岁之间。
Request
Params
| 字段 | 类型 | 描述 | 必填 | 格式 |
|---|---|---|---|---|
| document_number | string | 受益人 CPF 号码 | 是 | 11 位数字 |
| birth_date | date | 出生日期 | 是 | YYYY-MM-DD |
Response
Response 示例
符合资格:
{
"status": "eligible"
}
不符合资格 - 年龄超出范围:
{
"status": "not_eligible",
"error_description": "Age 66 is not within the eligible range (18-65 years)"
}
Response Body 详情
| 字段 | 类型 | 描述 |
|---|---|---|
| status | string | 资格状态(eligible/not_eligible) |
| error_description | string | 不符合资格时的错误描述(可选) |
2. 取款模拟与卡片额度
模拟计算可根据所提供的财务参数,计算可用取款金额和薪资卡额度。该操作适用于在签约前向受益人展示条件。
Request
Request Body
{
"financial": {
"salary_amount": 5000.00,
"number_of_installments": 96,
"monthly_interest_rate": 0.0246
},
"withdrawal": {
"disbursement_date": "2026-01-02",
"limit_days_to_disburse": 1,
"withdrawal_ratio": 0.7
},
"collateral": {
"collateral_type": "social_security_benefit_card"
}
}
Request Body 详情
| 字段 | 类型 | 描述 | 格式 | 必填 |
|---|---|---|---|---|
| financial | object | 操作财务数据 | - | 是 |
| withdrawal | object | 取款数据 | - | 是 |
| collateral | object | 担保物数据 | - | 是 |
Payload financial
| 字段 | 类型 | 描述 | 格式 | 必填 |
|---|---|---|---|---|
| salary_amount | number | 受益人薪资金额 | 最小值: 1 | 是 |
| number_of_installments | number | 取款 CCB 分期数 | 最小值: 1,最大值: 96 | 是 |
| monthly_interest_rate | number | 取款 CCB 月利率 | 最小值: 0.01,最大值: 0.0246 | 是 |
Payload withdrawal
| 字段 | 类型 | 描述 | 格式 | 必填 |
|---|---|---|---|---|
| disbursement_date | date | 取款 CCB 放款日期 | YYYY-MM-DD | 是 |
| limit_days_to_disburse | number | 取款 CCB 放款最长天数 | 最小值: 1,最大值: 10 | 是 |
| withdrawal_ratio | number | 用于取款的额度比例 | 最小值: 0.5,最大值: 0.7 | 否(默认: 0.7) |
Payload collateral
| 字段 | 类型 | 描述 | 格式 | 必填 |
|---|---|---|---|---|
| collateral_type | string | 卡片类型 | Enum: "social_security_benefit_card", "social_security_payroll_card" | 是 |
Response
Response Body
{
"total_limit_amount": 8000,
"reservation_amount": 250,
"withdrawal": {
"withdrawal_amount": 5600,
"withdrawal_data": {
"prefixed_interest_rate": {
"interest_base": "calendar_days",
"annual_rate": 0.3386043084,
"monthly_rate": 0.0246,
"daily_rate": 0.0008104046
},
"disbursement_options": [
{
"disbursement_date": "2026-01-02",
"cet": 0.0261,
"annual_cet": 0.3618,
"total_iof": 193.55,
"disbursed_issue_amount": 5600,
"issue_amount": 5793.55,
"installments": [
{
"total_amount": 160.51,
"due_date": "2026-02-10",
"business_due_date": "2026-02-11",
"installment_number": 1
},
{
"total_amount": 160.51,
"due_date": "2026-03-10",
"business_due_date": "2026-03-11",
"installment_number": 2
},
{
"total_amount": 160.51,
"due_date": "2026-04-10",
"business_due_date": "2026-04-13",
"installment_number": 3
},
...
]
}
]
}
},
"payroll_card": {
"card_limit": 2400
}
}
Response Body 详情
| 字段 | 类型 | 描述 |
|---|---|---|
| total_limit_amount | number | 考虑取款和卡片后的可用总额度 |
| reservation_amount | number | 薪资卡预约金额 |
| withdrawal | object | 取款数据 |
| withdrawal.withdrawal_amount | number | 计算得出的取款 CCB 放款金额 |
| withdrawal.withdrawal_data | object | 取款详细数据 |
| payroll_card | object | 薪资卡数据 |
| payroll_card.card_limit | number | 卡片计算得出的总额度 |
Payload withdrawal.withdrawal_data
| 字段 | 类型 | 描述 |
|---|---|---|
| prefixed_interest_rate | object | 固定利率 |
| disbursement_options | array | 可用放款选项 |
Payload prefixed_interest_rate
| 字段 | 类型 | 描述 |
|---|---|---|
| daily_rate | number | 日利率 |
| interest_base | string | 利息计算基准 |
| monthly_rate | number | 月利率 |
| annual_rate | number | 年利率 |
Payload disbursement_options
| 字段 | 类型 | 描述 |
|---|---|---|
| disbursement_date | string | 放款日期 |
| cet | number | 月综 合实际利率 |
| annual_cet | number | 年综合实际利率 |
| total_iof | number | IOF 总金额 |
| disbursed_issue_amount | number | 放款金额 |
| issue_amount | number | 发行金额 |
| installments | array | 分期列表 |
Payload installments
| 字段 | 类型 | 描述 |
|---|---|---|
| total_amount | number | 分期总金额 |
| due_date | string | 到期日期 |
| installment_number | number | 分期编号 |
3. 创建取款操作并生成条款
创建取款操作将启动薪资卡签约流程。该操作创建卡片预约、生成所需文件,并返回用于跟踪流程的密钥。
Request
Request Body
{
"request_control_key": "150e8400-e29b-41d4-a716-446655440000",
"purchaser_document_number": "55566677000177",
"card_holder": {
"name": "Carlos Eduardo Lima",
"email": "carlos.lima@email.com",
"phone": {
"number": "654321098",
"area_code": "31",
"country_code": "055"
},
"gender": "male",
"address": {
"city": "Belo Horizonte",
"state": "MG",
"number": "789",
"street": "Rua das Palmeiras",
"complement": "Casa 3",
"postal_code": "30112000",
"neighborhood": "Savassi"
},
"birth_date": "1990-09-18",
"mother_name": "Fernanda Lima",
"nationality": "Brasileiro",
"document_number": "55566677788",
"document_identification": {
"document_identification_date": "2012-05-20",
"document_identification_type": "rg",
"document_identification_number": "555666777"
}
},
"related_parties": [
{
"name": "Pedro Costa",
"email": "pedro.costa@email.com",
"phone": {
"number": "765432109",
"area_code": "21",
"country_code": "055"
},
"address": {
"city": "Rio de Janeiro",
"state": "RJ",
"number": "789",
"street": "Rua Ipanema",
"complement": "Apto 12",
"postal_code": "22080001",
"neighborhood": "Ipanema"
},
"role_type": "issuer_legal_representative",
"person_type": "natural",
"is_pep": false,
"individual_document_number": "11122233344",
"birth_date": "1980-12-05",
"mother_name": "Lucia Costa",
"document_identification": {
"document_identification_date": "2017-01-14",
"document_identification_type": "rg",
"document_identification_number": "222333444"
}
}
],
"withdrawal": {
"disbursement_date": "2026-01-02",
"limit_days_to_disburse": 1,
"withdrawal_ratio": 0.7,
"contract_number": "PCR12345678",
"disbursement_bank_account": {
"name": "Carlos Eduardo Lima",
"bank_code": "104",
"account_digit": "3",
"branch_number": "5678",
"account_number": "987654321",
"document_number": "55566677788",
"transfer_method": "pix",
"account_type": "checking_account"
}
},
"financial": {
"salary_amount": 5000.00,
"number_of_installments": 96,
"monthly_interest_rate": 0.0246,
"emission_installments": 1
},
"collateral": {
"state": "MG",
"benefit_number": "5556667777",
"collateral_type": "social_security_benefit_card",
"subcorban_document_number": "12123456000101",
"assistance_type": "pension_by_death_rural_worker"
},
"credit_agent": {
"document_number": "44455566677",
"name": "Agente de Crédito Lima"
}
}
Request Body 详情
| 字段 | 类型 | 描述 | 格式 | 必填 |
|---|---|---|---|---|
| request_control_key | string | 请求标识密钥 | UUID v4 | 是 |
| purchaser_document_number | string | 买方 CNPJ | 14 位数字 | 是 |
| card_holder | object | 持卡人数据 | - | 是 |
| withdrawal | object | 取款数据 | - | 是 |
| financial | object | 操作财务数据 | - | 是 |
| collateral | object | 担保物数据 | - | 是 |
| credit_agent | object | 信贷代理人数据 | - | 是 |
| related_parties | array | 相关方列表 | - | 否 |
Payload card_holder
| 字段 | 类型 | 描述 | 格式 | 必填 |
|---|---|---|---|---|
| name | string | 持卡人全名 | 最少 1 个有效字符 | 是 |
| string | 持卡人电子邮件 | 有效电子邮件格式 | 是 | |
| phone | object | 电话数据 | - | 是 |
| gender | string | 性别 | Enum: "male", "female" | 是 |
| address | object | 持卡人地址及卡片寄送地址 | - | 是 |
| birth_date | date | 出生日期 | YYYY-MM-DD | 是 |
| mother_name | string | 母亲姓名 | 最少 1 个有效字符 | 是 |
| nationality | string | 国籍 | 最少 1 个字符 | 是 |
| document_number | string | 持卡人 CPF | 11 位数字 | 是 |
| document_identification | object | 身份证件数据 | - | 是 |
Payload related_parties
| 字段 | 类型 | 描述 | 格式 | 必填 |
|---|---|---|---|---|
| name | string | 相关方姓名 | 最少 1 个有效字符 | 是 |
| string | 相关方电子邮件 | 有效电子邮件格式 | 是 | |
| phone | object | 电话数据 | - | 是 |
| address | object | 相关方地址 | - | 是 |
| role_type | string | 角色类型 | Enum: "issuer_legal_representative", "issuer_attorney" | 是 |
| person_type | string | 人员类型 | Enum: "natural" | 是 |
| is_pep | boolean | 是否为政治敏感人士 | true/false | 是 |
| individual_document_number | string | 相关方 CPF | 11 位数字 | 是 |
| birth_date | date | 出生日期 | YYYY-MM-DD | 是 |
| mother_name | string | 母亲姓名 | 最少 1 个有效字符 | 是 |
| document_identification | object | 身份证件数据 | - | 是 |
Payload phone
| 字段 | 类型 | 描述 | 格式 | 必填 |
|---|---|---|---|---|
| number | string | 电话号码 | 仅数字 | 是 |
| area_code | string | 区号 | 仅数字 | 是 |
| country_code | string | 国家代码 | 仅数字 | 是 |
Payload address
| 字段 | 类型 | 描述 | 格式 | 必填 |
|---|---|---|---|---|
| city | string | 城市 | 最少 1 个字符 | 是 |
| state | string | 州 | 2 个字符 | 是 |
| number | string | 门牌号 | 最少 1 个字符 | 是 |
| street | string | 街道 | 最少 1 个字符 | 是 |
| complement | string | 补充 | 最少 1 个字符 | 否 |
| postal_code | string | 邮政编码 | 8 位数字 | 是 |
| neighborhood | string | 社区 | 最少 1 个字符 | 是 |
Payload document_identification
| 字段 | 类型 | 描述 | 格式 | 必填 |
|---|---|---|---|---|
| document_identification_date | date | 证件签发日期 | YYYY-MM-DD | 是 |
| document_identification_type | string | 证件类型 | Enum: "rg", "passport", "other" | 是 |
| document_identification_number | string | 证件号码 | 最少 1 个字符 | 是 |
Payload withdrawal
| 字段 | 类型 | 描述 | 格式 | 必填 |
|---|---|---|---|---|
| disbursement_date | date | 放款日期 | YYYY-MM-DD | 是 |
| limit_days_to_disburse | number | 放款最长天数 | 最小值: 1,最大值: 10 | 是 |
| contract_number | string | 合同编号 | 3 个 大写字母 + 8 位数字 | 是 |
| disbursement_bank_account | object | 放款银行账户 | - | 是 |
Payload disbursement_bank_account
| 字段 | 类型 | 描述 | 格式 | 必填 |
|---|---|---|---|---|
| name | string | 账户持有人姓名 | 最少 1 个有效字符 | 是 |
| bank_code | string | 银行代码 | 3 位数字 | 是 |
| account_digit | string | 账户校验位 | 1 位数字 | 是 |
| branch_number | string | 支行号 | 仅数字 | 是 |
| account_number | string | 账户号码 | 仅数字 | 是 |
| document_number | string | 持有人 CPF | 11 位数字 | 是 |
| transfer_method | string | 转账方式 | Enum: "pix", "ted" | 是 |
| account_type | string | 账户类型 | Enum: "checking_account","deposit_account","guaranteed_account","investment_account","payment_account","saving_account","salary_account" | 是 |
Payload financial
| 字段 | 类型 | 描述 | 格式 | 必填 |
|---|---|---|---|---|
| salary_amount | number | 受益人薪资金额(福利总金额) | 最小值: 1 | 是 |
| number_of_installments | number | CCB(取款和循环)分期数 | 最小值: 1,最大值: 96 | 是 |
| monthly_interest_rate | number | CCB(取款和循环)月利率 | 最小值: 0.01,最大值: 0.0246 | 是 |
| emission_installments | number | 卡片发行费分期数(根据向受益人收集的信息填写) | 最小值: 1,最大值: 3 | 是 |
Payload collateral
| 字段 | 类型 | 描述 | 格式 | 必填 |
|---|---|---|---|---|
| state | string | 州 | 2 个字符 | 是 |
| benefit_number | string | 福利编号 | 最少 1 个字符 | 是 |
| collateral_type | string | 担保物类型 | Enum: "social_security_benefit_card"(福利卡),"social_security_payroll_card"(薪资卡) | 是 |
| assistance_type | string | 福利类型 | Enum: 枚举值 | 是 |
Payload credit_agent
| 字段 | 类型 | 描述 | 格式 | 必填 |
|---|---|---|---|---|
| document_number | string | 信贷代理人 CPF | 11 或 14 位数字 | 是 |
| name | string | 信贷代理人姓名 | 最少 1 个有效字符 | 是 |
Response
Response Body
{
"request_control_key": "150e8400-e29b-41d4-a716-446655440000",
"payroll_card_type": "social_security_benefit_card",
"payroll_card_reservation_key": "72d63aea-15b6-402c-a18b-d12cd4619c9d",
"card_holder_document_number": "55566677788",
"identifier_number": "5556667777",
"total_limit_amount": 8000,
"reservation_amount": 250,
"withdrawal": {
"withdrawal_key": "56cfe7b7-ed6e-4212-8744-c9fcff309ec0",
"withdrawal_amount": 5600,
"credit_operation_key": null,
"withdrawal_status": "pending_signature",
"contract_number": "PCR12345678",
"withdrawal_data": {
"prefixed_interest_rate": {
"interest_base": "calendar_days",
"annual_rate": 0.3386043084,
"monthly_rate": 0.0246,
"daily_rate": 0.0008104046
},
"disbursement_options": [
{
"disbursement_date": "2026-01-02",
"cet": 0.0261,
"annual_cet": 0.3618,
"total_iof": 193.55,
"disbursed_issue_amount": 5600,
"issue_amount": 5793.55,
"installments": [
{
"total_amount": 160.51,
"due_date": "2026-02-10",
"business_due_date": "2026-02-11",
"installment_number": 1
},
{
"total_amount": 160.51,
"due_date": "2026-03-10",
"business_due_date": "2026-03-11",
"installment_number": 2
},
{
"total_amount": 160.51,
"due_date": "2026-04-10",
"business_due_date": "2026-04-13",
"installment_number": 3
},
...
]
}
]
},
"wallet_entry_key": null
},
"payroll_card": {
"payroll_card_key": "572650c7-67f6-4f73-8444-b9da72000057",
"payroll_card_status": "pending_issuance",
"card_key": null,
"payment_instrument_key": null,
"card_issuance_entry_key": null,
"card_issuance_entry_amount": 17.28,
"card_limit": 2400
},
"attached_documents": [
{
"document_key": "32f5e5e2-a15a-40af-9ddc-cddaba1966cf",
"document_type": "withdrawal_operation_term",
"document_certifier": "qi_sign",
"document_status": "pending_generation",
"document_url": null,
"document_batch_key": "f4f2b64c-5608-44bb-a2df-bf62cf26cc76"
},
{
"document_key": "7767e30e-417e-4dd7-b061-bba722451d10",
"document_type": "payroll_card_term",
"document_certifier": "qi_sign",
"document_status": "pending_generation",
"document_url": null,
"document_batch_key": "f4f2b64c-5608-44bb-a2df-bf62cf26cc76"
},
{
"document_key": "6c839b10-9558-4e6e-9f7d-d1e494cf6156",
"document_type": "payroll_card_consent_term",
"document_certifier": "qi_sign",
"document_status": "pending_generation",
"document_url": null,
"document_batch_key": "f4f2b64c-5608-44bb-a2df-bf62cf26cc76"
}
],
"payroll_card_reservation_status": "pending_document_generation",
"wallet_key": null,
"reservation_contract_number": "PCR0000000822"
}
Response Body 详情
| 字段 | 类型 | 描述 |
|---|---|---|
| request_control_key | string | 请求标识密钥 |
| payroll_card_reservation_key | string | 薪资卡预约密钥 |
| payroll_card_reservation_status | string | 薪资卡预约状态 |
| card_holder_document_number | string | 持卡人 CPF |
| identifier_number | string | 操作标识号 |
| reservation_amount | number | 薪资卡预约金额 |
| reservation_contract_number | string | Dataprev 批注合同编号 |
| withdrawal | object | 取款数据 |
| payroll_card | object | 薪资卡数据 |
| attached_documents | array | 附件文件列表 |
| payroll_card_type | string | 卡片类型(social_security_benefit_card 或 social_security_payroll_card) |
| wallet_key | string | 已创建钱包的唯一密钥(UUID4) |
Payload withdrawal
| 字段 | 类型 | 描述 |
|---|---|---|
| withdrawal_key | string | 取款唯一密钥 |
| contract_number | string | 取款 CCB 合同编号 |
| withdrawal_amount | number | 计算得出的取款 CCB 放款金额 |
| disbursement_date | date | 操作放款日期 |
| withdrawal_status | string | 取款状态 |
| withdrawal_data | object | 取款详细数据 |
Payload withdrawal_data
| 字段 | 类型 | 描述 |
|---|---|---|
| prefixed_interest_rate | object | 固定利率 |
| disbursement_options | array | 可用放款选项 |
Payload prefixed_interest_rate
| 字段 | 类型 | 描述 |
|---|---|---|
| daily_rate | number | 日利率 |
| interest_base | string | 利息计算基准 |
| monthly_rate | number | 月利率 |
| annual_rate | number | 年利率 |
Payload disbursement_options
| 字段 | 类型 | 描述 |
|---|---|---|
| disbursement_date | string | 放款日期 |
| cet | number | 月综合实际利率 |
| annual_cet | number | 年综合实际利率 |
| total_iof | number | IOF 总金额 |
| disbursed_issue_amount | number | 放款金额 |
| issue_amount | number | 发行金额 |
| installments | array | 分期列表 |
Payload installments
| 字段 | 类型 | 描述 |
|---|---|---|
| total_amount | number | 分期总金额 |
| due_date | string | 到期日期 |
| installment_number | number | 分期编号 |
Payload payroll_card
| 字段 | 类型 | 描述 |
|---|---|---|
| payroll_card_key | string | 薪资卡唯一密钥 |
| payroll_card_status | string | 薪资卡状态 |
| card_limit | number | 卡片计算得出的总额度 |
| card_issuance_entry_amount | number | 卡片发行费金额 |
Payload attached_documents
| 字段 | 类型 | 描述 |
|---|---|---|
| document_key | string | 文件唯一密钥 |
| document_batch_key | string | 文件批次密钥 |
| document_type | string | 文件类型 |
| document_certifier | string | 文件认证机构 |
| document_status | string | 文件状态 |
| document_url | string | 文件 URL |
| signature_url | string | 签名 URL |
4. 发送附加文件
Dataprev 批注保证金后,预约状态更新为 pending_additional_documents_submission。要释放操作放款,必须发送附加文件(对于 INSS 薪资/福利卡产品,为签约确认视频)。
上传处理为异步操作。上传成功后将自动触发预约状态转换至 pending_additional_documents_validation,发送状态变更和文件更新 Webhook,并触发文件验证。
如果附加文件在系统验证中被拒绝,预约将返 回至 pending_additional_documents_submission 状态,可通过同一接口重新提交附加文件。在系统分析批准/拒绝之前,不可重新提交附加文件,且每个预约和文件类型的分析次数上限为 5 次。
发送附加文件及系统随后的批准视为信贷操作的授权。文件验证成功后,操作将自动进入 pending_withdrawal_disbursement 状态(通过 Webhook 通知客户),并在受益人账户执行放款,无需额外审批步骤。
Request
Params
| 字段 | 类型 | 描述 | 必填 |
|---|---|---|---|
| payroll_card_reservation_key | string | 预约唯一密钥(UUID) | 是 |
Request Body
{
"documents": [
{
"document_type": "payroll_card_confirmation_video",
"document_url": "https://download.samplelib.com/mp4/sample-5s.mp4"
}
]
}
Request Body 详情
| 字段 | 类型 | 描述 | 必填 |
|---|---|---|---|
| documents | array | 待附加文件列表 | 是 |
Payload documents
| 字段 | 类型 | 描述 | 格式 | 必填 |
|---|---|---|---|---|
| document_type | string | 文件类型 | Enum: "payroll_card_confirmation_video" | 是 |
| document_url | string | 视频文件公开下载链接 | 有效 URL | 是 |
请确保发送的 URL 可被外部用户访问,以便我们将文件上传至 QI 内部数据库。
- 支持的文件格式:.mp4
- 最大文件大小:256MB
Response
请求已成功接收,文件将异步处理。
{
"attached_documents": [
{
"document_key": "2fc216c6-5d1c-4713-b70b-6e1f75f8bb17",
"document_type": "payroll_card_confirmation_video",
"document_certifier": "electronic_client_side",
"document_status": "pending_generation",
"document_url": ""
}
],
}
5. 取款付款重新提交
如因数据不正确导致付款未能处理,可通过以下接口调整银行账户信息进行重新提交:
Request
Request Body
{
"disbursement_bank_account": {
"name": "Carlos Eduardo Lima",
"bank_code": "001",
"account_digit": "3",
"branch_number": "5678",
"account_number": "987654321",
"document_number": "55566677788",
"transfer_method": "pix",
"account_type": "checking_account"
}
}
Request Body 详情
| 字段 | 类型 | 描述 | 格式 | 必填 |
|---|---|---|---|---|
| disbursement_bank_account | object | 放款银行账户 | - | 是 |
Payload disbursement_bank_account
| 字段 | 类型 | 描述 | 格式 | 必填 |
|---|---|---|---|---|
| name | string | 账户持有人姓名 | 最少 1 个有效字符 | 是 |
| bank_code | string | 银行代码 | 3 位数字 | 是 |
| account_digit | string | 账户校验位 | 1 位数字 | 是 |
| branch_number | string | 支行号 | 仅数字 | 是 |
| account_number | string | 账户号码 | 仅数字 | 是 |
| document_number | string | 持有人 CPF | 11 位数字 | 是 |
| transfer_method | string | 转账方式 | Enum: "pix", "ted" | 是 |
| account_type | string | 账户类型 | Enum: "checking_account","deposit_account","guaranteed_account","investment_account","payment_account","saving_account","salary_account" | 是 |
Response
6. 附录
同质化测试环境(Mock)
为方便在 Sandbox 环境中进行集成测试,系统根据创建 payload 中发送的受益人 CPF 首位数字模拟不同行为。
使用下表模拟成功和错误场景:
| CPF 首位数字 | 场景 | 内部行为 | 最终结果(客户) |
|---|---|---|---|
| 1 | 理想流程(完整) | 签名成功 入网成功 批注(Dataprev)成功 | 卡片已发行 (状态: card_issued) |
| 2 | Dataprev 查询错误 | 签名成功 入网成功 福利查询失败 | 预约已取消 (状态: canceled)+ 发送状态 Webhook (状态: canceled) |
| 3 | Dataprev 批注错误 | 签名成功 入网成功 保证金批注/预约失败 | 预约已取消 (状态: canceled)+ 发送状态 Webhook (状态: canceled) |
| 4 | 地址错误 | 签名成功 入网成功(地址不符) 批注(Dataprev)成功 | 卡片已发行 (状态: card_issued)+ 发送地址更新 Webhook |
| 5 | 入网被拒 | 签名成功 入网/KYC 被拒 | 预约已取消 (状态: canceled)+ 发送状态 Webhook (状态: canceled) |
| 6 | 不符合资格(年龄 > 65) | 签名成功 入网成功(返回年龄超过 65 岁) | 预约已取消 (状态: canceled)+ 发送状态 Webhook (状态: canceled) |
| 7 | 不符合资格(年龄 < 18) | 签名成功 入网成功(返回年龄低于 18 岁) | 预约已取消 (状态: canceled)+ 发送状态 Webhook (状态: canceled) |
| 8 | Teimosinha(重试) | 签名成功 入网成功 批注(Dataprev)临时失败 | 等待释放 (状态: pending_reservation)+ 发送 Collateral Webhook |
要测试理想流程,请确保使用以 1 开头的 CPF(例如:123.456.789-00)且为有效 CPF(校验位计算正确)。
成功 Mock 配置为模拟最高 R$10,000.00 的福利。如果使用超过此金额的福利值,系统将在批注时返回保证金超额错误,取消预约。
福利类型表
| 代码 | 福利类型 |
|---|---|
| 1 | pension_by_death_rural_worker |
| 2 | pension_by_death_accident_rural_worker |
| 3 | pension_by_death_rural_employer |
| 4 | retirement_invalidity_rural_emploee |
| 5 | retirement_invalidity_accident_rural_worker |
| 6 | retirement_invalidity_rural_employer |
| 7 | retirement_by_eldness_rural_worker |
| 8 | retirement_by_age_rural_employer |
| 9 | complement_by_work_accident_rural_worker |
| 11 | support_invalidity_rural_worker |
| 12 | support_by_age_rural_worker |
| 13 | aid_sickness_rural_worker |
| 15 | aid_time_off_rural_worker |
| 16 | aid_federal |
| 17 | international_agreement |
| 18 | inclusion_benefit |
| 19 | pension_student_law7004 |
| 20 | pension_by_death_diplomat |
| 21 | pension_by_death |
| 22 | pension_by_death_statute |
| 23 | pension_by_death_veteran |
| 24 | pension_special_institutional_act |
| 25 | aid_time_off |
| 26 | pension_by_death_special_law593 |
| 27 | pension_by_death_federal_emploee |
| 28 | pension_by_death_general_regime_law20465 |
| 29 | pension_by_death_marine_veteran |
| 30 | monthly_income_lifetime_invalidity |
| 31 | aid_sickness |
| 32 | retirement_invalidity_social_security |
| 33 | retirement_invalidity_aeronautic |
| 34 | retirement_invalidity_marine_law1756 |
| 35 | aid_sickness_veteran |
| 36 | aid_social_security_accident |
| 37 | retirement_capin_extra_emploee |
| 38 | retirement_federal_extra_emploee |
| 39 | aid_invalidity_student_law7004 |
| 40 | monthly_income_lifetime_by_age_upper70_law6179 |
| 41 | retirement_by_age |
| 42 | retirement_by_contribution_time |
| 43 | retirement_by_time_of_service_veteran |
| 44 | retirement_special_aeronautic |
| 45 | retirement_by_time_of_service_journalist |
| 46 | retirement_special |
| 47 | allowance_25 |
| 48 | allowance_20 |
| 49 | retirement_ordinary |
| 50 | aid_sickness_extinct_basic_plan |
| 51 | retirement_invalidity_extinct_basic_plan |
| 52 | retirement_by_age_extinct_basic_plan |
| 53 | aid_time_off_extinct_basic_plan |
| 54 | pension_indemnity_federal |
| 55 | pension_by_death_extinct_basic_plan |
| 56 | pension_lifetime_syndrome_thalidomide |
| 57 | retirement_by_teacher_labor_time |
| 58 | retirement_anisty |
| 59 | pension_by_death_amnesty |
| 60 | indemnity |
| 61 | aid_birth |
| 62 | aid_funeral |
| 63 | aid_funeral_rural_worker |
| 64 | aid_funeral_rural_employer |
| 65 | savings_special_autarchy |
| 67 | savings_mandatory_ipase_law5128 |
| 68 | savings_special_retirement_ps_affiliated_upper60 |
| 69 | savings_student_law7004 |
| 70 | restitution |
| 71 | monthly_income |
| 72 | retirement_by_time_of_service_law1756 |
| 73 | monthly_income_family_statute |
| 74 | complement_pension_federal |
| 75 | complement_retirement_federal |
| 76 | monthly_income_statute |
| 77 | monthly_income_sinpas_family_statute |
| 78 | retirement_by_age_law1756 |
| 79 | advantage |
| 80 | monthly_income_maternity |
| 81 | compulsory_retirement |
| 82 | retirement_by_time_of_service_sasse |
| 83 | retirement_invalidity_ex_sasse |
| 84 | pension_by_death_sasse |
| 85 | pension_lifetime_rubber_tapper_law7986 |
| 86 | pension_lifetime_rubber_tapper_dependent_law7986 |
| 87 | continuous_aid_physical_disabilities |
| 88 | continuous_aid_eldness |
| 89 | pension_special_hemodialysis_victim_caruaru |
| 90 | medic_assistency_work_accident |
| 91 | aid_sickness_by_work_accident |
| 92 | retirement_invalidity_work_accident |
| 93 | pension_by_death_work_accident |
| 94 | aid_work_accident |
| 95 | aid_additional_work_accident |
| 96 | pension_special_leprosy_law11520 |
| 97 | savings_by_death_work_accident |
| 98 | aid_longshoreman |
| 99 | time_off_15 |