Unable to Put a Beneficial Owner into Document Status in Sandbox


We’re using the sandbox to build out our integration. We have the beneficial owner’s firstName set to “retry” and lastName set to “retry.”

After the initial POST https://[Dwolla-Version-URL]/customers/[id]/beneficial-owners, we receive a customer_beneficial_owner_reverification_needed webhook as expected. We then have made several POST https://[Dwolla-Version-URL]/beneficial-owners/[id] requests in an attempt to update the beneficial owner. Each time, we get the bellow response and no additional webhooks. The documentation indicates that after “a second attempt to re-verify a beneficial owner fails,” we should receive a customer_beneficial_owner_verification_document_needed webhook event. However, this is not occurring.

I see that the beneficial owner is being placed into incomplete status, but there are no webhook events being omitted after multiple failed retries. We also noted that the documentation states that “The Customer will only have one opportunity to correct any mistakes” (link), so we would expect the document status (“If a beneficial owner is not verified after being placed in incomplete status and submitting a second verification attempt, the only other state the beneficial owner can be in is document,” link).

I’m wondering if I’m missing something, or if this is an issue with the sandbox configuration?


    "body": {
        "_links": {
            "self": {
                "href": "https://api-sandbox.dwolla.com/beneficial-owners/634016f6-7032-4f96-bf64-8c215053399d",
                "type": "application/vnd.dwolla.v1.hal+json",
                "resource-type": "beneficial-owner"
            "retry-verification": {
                "href": "https://api-sandbox.dwolla.com/beneficial-owners/634016f6-7032-4f96-bf64-8c215053399d",
                "type": "application/vnd.dwolla.v1.hal+json",
                "resource-type": "beneficial-owner"
        "id": "634016f6-7032-4f96-bf64-8c215053399d",
        "firstName": "retry",
        "lastName": "retry",
        "address": {
            "address1": "12 Johns Road",
            "address2": "null",
            "city": "Johnston",
            "stateProvinceRegion": "RI",
            "country": "US",
            "postalCode": "02911"
        "verificationStatus": "incomplete",
        "created": "2022-11-19T23:14:18.165Z"
    "error": {
        "status_code": 200,
        "status_message": "OK",
        "body": "\"{\\\"_links\\\":{\\\"self\\\":{\\\"href\\\":\\\"https://api-sandbox.dwolla.com/beneficial-owners/634016f6-7032-4f96-bf64-8c215053399d\\\",\\\"type\\\":\\\"application/vnd.dwolla.v1.hal+json\\\",\\\"resource-type\\\":\\\"beneficial-owner\\\"},\\\"retry-verification\\\":{\\\"href\\\":\\\"https://api-sandbox.dwolla.com/beneficial-owners/634016f6-7032-4f96-bf64-8c215053399d\\\",\\\"type\\\":\\\"application/vnd.dwolla.v1.hal+json\\\",\\\"resource-type\\\":\\\"beneficial-owner\\\"}},\\\"id\\\":\\\"634016f6-7032-4f96-bf64-8c215053399d\\\",\\\"firstName\\\":\\\"retry\\\",\\\"lastName\\\":\\\"retry\\\",\\\"address\\\":{\\\"address1\\\":\\\"12 Johns Road\\\",\\\"address2\\\":\\\"null\\\",\\\"city\\\":\\\"Johnston\\\",\\\"stateProvinceRegion\\\":\\\"RI\\\",\\\"country\\\":\\\"US\\\",\\\"postalCode\\\":\\\"02911\\\"},\\\"verificationStatus\\\":\\\"incomplete\\\",\\\"created\\\":\\\"2022-11-19T23:14:18.165Z\\\"}\""
    "returned_an_error": false,
    "headers": {
        "date": "Sat, 19 Nov 2022 23:22:54 GMT",
        "content-type": "application/vnd.dwolla.v1.hal+json",
        "content-length": "684",
        "connection": "keep-alive",
        "access-control-allow-origin": "*",
        "access-control-expose-headers": "Location",
        "x-request-id": "f1715eab-97eb-4ab5-81a1-1cbe3647c1e3",
        "cf-cache-status": "DYNAMIC",
        "set-cookie": [
            "__cf_bm=4XYJm5lqZ2Y8yXpS.yjQ7Fv1Jvcu98k.5YxvDwDcGb0-1668900174-0-AcG7ZTQ92TTBChtIeGKikQlrW9KwFFRU7Eqc8il9Ob6/AkK9McC2Skfo7jAAoY32omzEQ0Gm3IWcvu0IyEpUTJQ=; path=/; expires=Sat, 19-Nov-22 23:52:54 GMT; domain=.dwolla.com; HttpOnly; Secure"
        "server": "cloudflare",
        "cf-ray": "76ccb0c6f839c58a-SEA"

@spencer any ideas on this one? I’m not sure if it’s a bug in the sandbox setup or an issue with the calls we are making. I’m happy to provide more info if it would help.

Hi @barrownicholas , I believe this is the default behavior in Sandbox for this particular flow. What you’ll want to do is modify the firstName field value to document after being placed in incomplete. That will allow you to replicate the failed re-verification attempt which ultimately could cause a user to be placed in a document status.

1 Like

Hi @spencer , thanks for that! Just wanted to confirm if it was a bug or not.