Effective July 1, 2025, all current and future Issuing, Treasury, Opal and Corporate Card accounts must meet enhanced validation for business and account representative addresses. These controls detect and prevent addresses associated with the use of registered agents, physical mailbox services, and virtual address services.
Registered agent addresses: Designated locations where a third party receives legal documents and government notices on behalf of a business. Many companies use registered agent services, especially when operating in states where they don’t have a physical presence.
Commercial Mail Receiving Agency addresses: Private businesses that provide mailbox rental and mail forwarding services, such as UPS Stores, FedEx Office locations, or virtual mail services.
以下は、アドレスにフラグが立てられた場合に Accounts API または account.updated Webhook イベントに表示される要件セクションの例です。
CMRA の住所
ビジネスの住所の場合:
{"requirements":{"current_deadline":null,"currently_due":["company.address.line1"],"errors":[{"code":"invalid_address_private_mailbox","reason":"The address you provided appears to be associated with a mailbox or virtual address service, which we can't accept. Please update your address to proceed.","requirement":"company.address.line1"}],"eventually_due":["company.address.line1"],"past_due":["company.address.line1"],"pending_verification":[]}}
代表者の住所の場合:
{"requirements":{"current_deadline":null,"currently_due":["person123.address.line1"],"errors":[{"code":"invalid_address_private_mailbox","reason":"The address you provided appears to be associated with a mailbox or virtual address service, which we can't accept. Please update your address to proceed.","requirement":"person123.address.line1"}],"eventually_due":["person123.address.line1"],"past_due":["person123.address.line1"],"pending_verification":[]}}
{"requirements":{"alternatives":[{"alternative_fields_due":["company.address.line1"],"original_fields_due":["documents.proof_of_address.files"]}],"currently_due":["documents.proof_of_address.files"],"errors":[{"code":"verification_address_registered_agent_address","requirement":"documents.proof_of_address.files","reason":"The address you provided appears to be associated with a registered agent, which we can't accept. Please update your address to proceed."}],"eventually_due":["documents.proof_of_address.files"],"past_due":["documents.proof_of_address.files"],"pending_verification":[]}}
代表者の住所の場合:
{"requirements":{"alternatives":[{"alternative_fields_due":["person123.address.line1"],"original_fields_due":["person123.verification.additional_document"]}],"currently_due":["person123.verification.additional_document"],"errors":[{"code":"verification_document_failed_other","requirement":"person123.verification.additional_document","reason":"The address you provided appears to be associated with a registered agent, which we can't accept. Please update your address to proceed."}],"eventually_due":["person123.verification.additional_document"],"past_due":["person123.verification.additional_document"],"pending_verification":[]}}
To remediate, update your address to a physical location where you operate.
実装のテスト
テスト環境でさまざまなシナリオを開始するには、Accounts API または Person API の住所 line1 フィールドで以下の値を使用します。
内容
line1
CMRA address. The address requirement won’t be satisfied.
Address CMRA
RA address. The address requirement won’t be satisfied.
Address RA
Normal address. The address requirement will be satisfied.