> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wepayout.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Test Documents

> Test documents for payout scenarios in sandbox environment

## Documents for Testing

The result of the payout payment is linked to the beneficiary's document. Use the documents below to test different payment scenarios in the sandbox environment.

## PIX Key Payment

For payments using **PIX key**, use one of the following CPF documents to ensure the payment is approved:

| Document (CPF)  | Status | Description                   |
| --------------- | ------ | ----------------------------- |
| **58713371126** | Paid   | Payment approved successfully |
| **59730932395** | Paid   | Payment approved successfully |
| **78592315492** | Paid   | Payment approved successfully |

### Example - PIX Key Payment

```json theme={null}
{
  "payment_method": "PIX",
  "currency": "BRL",
  "country": "BR",
  "amount": 50.00,
  "invoice": "unique-invoice-id",
  "beneficiary": {
    "name": "João Silva",
    "document": {
      "type": "CPF",
      "number": "58713371126"
    }
  },
  "pix": {
    "pix_key": "58713371126"
  }
}
```

## Bank Account Payment

For payments using **bank account details**, use one of the following CPF documents to ensure the payment is approved:

| Document (CPF)  | Status | Description                   |
| --------------- | ------ | ----------------------------- |
| **58713371126** | Paid   | Payment approved successfully |
| **59730932395** | Paid   | Payment approved successfully |
| **78592315492** | Paid   | Payment approved successfully |
| **78493353094** | Paid   | Payment approved successfully |

### Example - Bank Account Payment

```json theme={null}
{
  "payment_method": "PIX",
  "currency": "BRL",
  "country": "BR",
  "amount": 100.00,
  "invoice": "unique-invoice-id",
  "beneficiary": {
    "name": "Maria Santos",
    "document": {
      "type": "CPF",
      "number": "59730932395"
    }
  },
  "pix": {
    "ispb": "18236120",
    "bank_branch": "0496",
    "account": "51659",
    "account_digit": "7",
    "account_type": "CHECKING"
  }
}
```

## Testing Flow

<Steps>
  <Step title="Choose payment method">
    Decide whether to test PIX key or bank account payment
  </Step>

  <Step title="Select test document">
    Choose one of the approved CPF documents from the tables above
  </Step>

  <Step title="Create payment">
    Use the [Create Payment](/api-reference/cash-out/payout/create-payment) endpoint with the test document
  </Step>

  <Step title="Monitor status">
    Check the payment status using webhooks or the [Get Payment](/api-reference/cash-out/payout/get-unique-payment) endpoint
  </Step>

  <Step title="Verify completion">
    Confirm the payment reaches **Paid** status (status\_id: 3)
  </Step>
</Steps>

## Best Practices

<Note>
  **Sandbox Environment**: Always use test documents in the sandbox environment. These documents are specifically configured for testing purposes.
</Note>

<Tip>
  **Unique Invoice**: Always use a unique invoice ID for each payment to avoid duplicates and ensure proper tracking.
</Tip>

## Common Test Scenarios

<AccordionGroup>
  <Accordion title="PIX Key - Successful Payment">
    **Document**: 58713371126

    **Payment Method**: PIX Key

    **Expected Result**: Payment approved and completed

    ```json theme={null}
    {
      "payment_method": "PIX",
      "currency": "BRL",
      "country": "BR",
      "amount": 43.34,
      "invoice": "test-pix-key-001",
      "beneficiary": {
        "name": "João Silva",
        "document": {
          "type": "CPF",
          "number": "58713371126"
        }
      },
      "pix": {
        "pix_key": "58713371126"
      }
    }
    ```
  </Accordion>

  <Accordion title="Bank Account - Successful Payment">
    **Document**: 59730932395

    **Payment Method**: Bank Account Details

    **Expected Result**: Payment approved and completed

    ```json theme={null}
    {
      "payment_method": "PIX",
      "currency": "BRL",
      "country": "BR",
      "amount": 150.00,
      "invoice": "test-bank-account-001",
      "beneficiary": {
        "name": "Maria Santos",
        "document": {
          "type": "CPF",
          "number": "59730932395"
        }
      },
      "pix": {
        "ispb": "18236120",
        "bank_branch": "0496",
        "account": "51659",
        "account_digit": "7",
        "account_type": "CHECKING"
      }
    }
    ```
  </Accordion>
</AccordionGroup>

## Payment Status Flow

After creating a payment with a test document, the payment will go through the following statuses:

<Steps>
  <Step title="Awaiting (7)">
    Initial status - Payment created and awaiting processing
  </Step>

  <Step title="Received (1)">
    Payment received and stored in the system
  </Step>

  <Step title="Processing (2)">
    Payment sent for processing
  </Step>

  <Step title="Processed (8)">
    Payment processed and waiting confirmation
  </Step>

  <Step title="Paid (3)">
    Payment completed successfully ✓
  </Step>
</Steps>

## Important Notes

<CardGroup cols={2}>
  <Card title="PIX Key Documents" icon="key">
    **3 approved documents**

    Use these CPF numbers as PIX keys for successful payments
  </Card>

  <Card title="Bank Account Documents" icon="building-columns">
    **4 approved documents**

    Use these CPF numbers with any valid bank account details
  </Card>
</CardGroup>

<Warning>
  **Production Environment**: Never use these test documents in production. They are only valid in the sandbox environment.
</Warning>

## Related Resources

<CardGroup cols={2}>
  <Card title="Create Payment" icon="plus" href="/api-reference/cash-out/payout/create-payment">
    Create a new payout payment
  </Card>

  <Card title="Payment Status" icon="list-check" href="/cash-out/status-flow">
    Understanding payment status flow
  </Card>

  <Card title="Rejection Reasons" icon="circle-xmark" href="/cash-out/rejection-reasons">
    Common rejection reasons and solutions
  </Card>

  <Card title="About Payments" icon="circle-info" href="/cash-out/about-payments">
    Learn about payout payments
  </Card>
</CardGroup>