地址管理

导航

文件与签名（上一步）

在入网和 KYC 流程中，受益人的地址会经过我们的分析流程和受益人本人的验证。如果检测到任何不一致，将通知客户与受益人确认或更正数据。

1. 地址验证错误 Webhook

当 KYC 流程发现发送的地址与我们数据库中的地址之间存在不一致时，触发此 Webhook。

需要采取行动

收到此 Webhook 后，客户必须联系受益人，并通过地址更新接口请求更正数据。不执行此更正可能导致卡片配送失败。

WEBHOOK TYPE

laas.payroll_card_reservation.address

Webhook Body

{
    "key": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "webhook_type": "laas.payroll_card_reservation.address",
    "status": "pending_card_issuance",
    "event_datetime": "2025-01-15T16:45:00Z",
    "data": {
        "address": {
          "city": "Belo Horizonte",
          "state": "MG",
          "postal_code": "30112000",
          "street": "Rua Inexistente",
          "number": "000",
          "neighborhood": "Savassi"
        }, 
        "rejected_reason": "address_validation_failed",
        "rejection_details": {
            "description": "Endereço não encontrado na base de validação"
        }
    }
}

2. 地址更新

此接口用于在收到地址验证错误 Webhook 后更正受益人地址。

信息

如果受益人确认地址无误，则无需发送地址更新请求，已登记的地址将用于卡片配送。

请求

PATCH

/payroll_card_reservation/social_security/{payroll_card_reservation_key}/address

Request Body

{
    "address": {
        "city": "Belo Horizonte",
        "state": "MG",
        "number": "789",
        "street": "Rua das Palmeiras",
        "complement": "Casa 3",
        "postal_code": "30112000",
        "neighborhood": "Savassi"
    }
}

参数详情

字段	类型	描述	必填
city	string	城市	是
state	string	州（UF）	是
number	string	门牌号	是
street	string	街道名称	是
complement	string	补充信息	否
postal_code	string	邮政编码（仅数字）	是
neighborhood	string	区/邻里	是

响应

STATUS

200 (OK)

操作将在 KYC 流程中自动重新处理，如果再次检测到不一致，可能会产生新的错误 Webhook。

1. 地址验证错误 Webhook​

2. 地址更新​

请求​

响应​

1. 地址验证错误 Webhook

2. 地址更新

请求

响应