> This page is for Internet banking (beta).

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.api.corpx.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.api.corpx.com/_mcp/server.

# Vetores de teste

Os valores abaixo são gerados e verificados pelo mesmo código que valida em
produção (`internal/reqsign`). Se a sua implementação reproduz estas
assinaturas, ela vai passar no gateway.

> **Chave RSA de teste**
>
> A chave privada PS256 publicada aqui existe só para você reproduzir o
> vetor. Ela nunca foi cadastrada em credencial nenhuma; não a use para nada
> além deste teste.

## Assinatura de requisição

Os dois algoritmos assinam a **mesma** string canônica (LF entre linhas, sem newline no fim):

```text
POST
/v1/accounts/acc-123/pix/payments
1789412400
4f1e3b7a-9d2c-4a11-8f55-2b0c6a7d1e90
612612d208fb618eb2b007d2a7f8d7a1cfb511532389298f1cc33322c3094bcc
```

| Campo                 | Valor                                                              |
| --------------------- | ------------------------------------------------------------------ |
| `method`              | `POST`                                                             |
| `path?query`          | `/v1/accounts/acc-123/pix/payments`                                |
| `X-Request-Timestamp` | `1789412400`                                                       |
| `Idempotency-Key`     | `4f1e3b7a-9d2c-4a11-8f55-2b0c6a7d1e90`                             |
| body                  | `{"amount":1000}`                                                  |
| `X-Content-SHA256`    | `612612d208fb618eb2b007d2a7f8d7a1cfb511532389298f1cc33322c3094bcc` |

#### ES256

| Campo | Valor                                  |
| ----- | -------------------------------------- |
| `kid` | `cfe8291443215153e11b76a7a533dd3c`     |
| `jti` | `00000000-0000-4000-8000-000000000001` |

**Chave pública (SPKI PEM)**

```text
-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE6VuQL7n18jc/8dHENPXeHZrdCVPu
q2j496awbvsDhxWTVj3hBScPI9MioPmlfS9nNUo9MJhTDNMfVRUALXXrfg==
-----END PUBLIC KEY-----
```

**JWS destacada (`X-Request-Signature`)**

```text
eyJhbGciOiJFUzI1NiIsImtpZCI6ImNmZTgyOTE0NDMyMTUxNTNlMTFiNzZhN2E1MzNkZDNjIiwianRpIjoiMDAwMDAwMDAtMDAwMC00MDAwLTgwMDAtMDAwMDAwMDAwMDAxIn0..hN37T9veyWLyXnEvXqnPwFIsD1GzgKfoY_bHzkc3rx3-MZCNhVaIVq1W_P77g8Dfw6IJ09wBddu6bhNQkGulvQ
```

A assinatura ES256 tem 64 bytes (R||S, `ieee-p1363`). DER não confere.

#### PS256

| Campo | Valor                                  |
| ----- | -------------------------------------- |
| `kid` | `5da1832445b8f656f3db0b3d78bf26ea`     |
| `jti` | `00000000-0000-4000-8000-000000000002` |

**Chave pública (SPKI PEM)**

```text
-----BEGIN PUBLIC KEY-----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA1YwPOJ02FEZZ1W0tGSlt
z+EEpIxqAuC7aYIxpm5knIQ9Ep5rGuAFanmKYWKF7JNLnd+ljN8PxRN0XkHUJ9qJ
YOv6BHKeVFs7IpNiTbtAXJXZaQqp9eSXfLRWH6vAIvp26ut3s3NqOHflZVlTNEB/
nwO6dZ9S4YPRvvE7AJizQq+WMa72mx8kji8cpfZxgHbGlfTU7QsW9IFaLY2XErmt
FojL/DB4YupG8YcIp1D3sXvpqTpHbEwJt9iNuxVh739fHiRCtdd3jJBgI/jFkBAA
z0i/ZJsEMEwCrs2mtTpPyto0lxFW479nZjtCZHSqNG7Kk6L/DkOvGlrRc8j5GrvC
HwIDAQAB
-----END PUBLIC KEY-----
```

**Chave privada de teste (PKCS#8 PEM)**

```text
-----BEGIN PRIVATE KEY-----
MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQDVjA84nTYURlnV
bS0ZKW3P4QSkjGoC4LtpgjGmbmSchD0Snmsa4AVqeYphYoXsk0ud36WM3w/FE3Re
QdQn2olg6/oEcp5UWzsik2JNu0BcldlpCqn15Jd8tFYfq8Ai+nbq63ezc2o4d+Vl
WVM0QH+fA7p1n1Lhg9G+8TsAmLNCr5YxrvabHySOLxyl9nGAdsaV9NTtCxb0gVot
jZcSua0WiMv8MHhi6kbxhwinUPexe+mpOkdsTAm32I27FWHvf18eJEK113eMkGAj
+MWQEADPSL9kmwQwTAKuzaa1Ok/K2jSXEVbjv2dmO0JkdKo0bsqTov8OQ68aWtFz
yPkau8IfAgMBAAECggEAK9clttM7q3zn63OO+yfwtek1yUxUZUPa5eXHKKpoOGPD
oANq7KkKI5pRKP4PjYqNzxr/g0S2GZkNXl54Xjg01PONMAWR8LKMGOSWHWwwYfGX
oUOBsgwcd4sUVUsu1l+CM2dk+y/aIj6nFx/3/3WwXaZnzMcJPmgQEvm2ScCPqMRA
Q35mxzX0oKt9HwKBB18a3GHNiaBHIopb1zKYo1ukiU4pHw6ROEbksky5cAnDjuyM
EyILf+zdMXwOwZotFh2+OZreZPsU/So/G/48yAba9l1etL1D32J1O9zumOT7jWFo
rP6WHZnjTN84rYCuFhx63xOxz73fSkXNdoWc2iSluQKBgQD58O3OlKXNZIEn2TGC
MTVBSlU9dZMx4LrjYBQu0HHDtq+8dmMwW+y3HWJVNVqRjKTcgCBGfn5WT1YDB7zc
igGyjYTZPj2NTciVyVQmk1WPmVaIwDanqUmrgyEpMWQ4qOodq1sH7A6cIhfSIcSg
fibiXPQNKiU20aU82gQDlc2giQKBgQDauUdKy4/JN+P6Z0RSCLXgXmtHOKT3DUIz
ExrnH3cq22zTkGzHuwg8jY3qj8ibxKf1mgGNIW+lzBfLlHTjCs+gdQM6ZaPd5FcW
d6cbviokFvklwOeZQk434krrjUz93gCanlyt49+ymiP1+Bg6hT8u+Wo2Ljduy9ed
jmY03+YTZwKBgG86TcoKEsMVv/hoyoSCu41jtA1WvnuK5AB96F1w+7+6E/jNwpRp
xC01UWZUCQsOyOsrxbE5Z6WnRsKwdda7P8gi/ITlEuVIQUSPRPipxoDSH1VaHLh+
OL+v6lj3lv80BIPRlwAuh83pyioERwmZOlqwPReCsu7zWxJ6fyDNUKXpAoGAK0Jt
6UstmxykyIfYKWlzn3bNPP7lEb/bkgJ7Va8RgLZ5Zbaw7Sf+zwsoQHZDtRtGJPta
xzEPxfkB08/+9lDTE+dQxiIIMQDSgK0VrhUEfLLWgDMRG2zTz5XAP6poyeU4tVwQ
9IuXWNnHtwRktl5YStAlw6WMbSt/77eUW2zVMo0CgYEArlxqrcLmrBGddHAwFVGx
JF2JjE1t9R3b4dOZuS9CZsi4UbBhR6W+iwahGLTvtY2NQdmx2RKCcA9w6DXPbTZA
fanlg5eWASLFmp3w+lksbaPRZYO3dJvYf3IizE6c0Lid0vKsy/rCxGYBo+OyYPyy
tknvMcuVXhbW/4xGfKRFn5M=
-----END PRIVATE KEY-----
```

**JWS destacada (`X-Request-Signature`)**

```text
eyJhbGciOiJQUzI1NiIsImp0aSI6IjAwMDAwMDAwLTAwMDAtNDAwMC04MDAwLTAwMDAwMDAwMDAwMiIsImtpZCI6IjVkYTE4MzI0NDViOGY2NTZmM2RiMGIzZDc4YmYyNmVhIn0..xQz7Vf7RVsvrs428Jo5XKH2ATheC5z_MbG0xPEuMObWe-kdjZYVzN_A38eRh8XwIJgjjtiCazZZvdptbS4iKHG-NO7wptPO9wxTqR7KEQH3QjfwSzf5g9jIWuCyYsR4peiqUR4XMZuiztRDt2mA25NwyKAqP52FCmhrS-qmh5gt2_FXg7pUgV_eE2CjbH2C5HEdHXAEwCg4WJax0EIh3C7qQ_qskCbrfxWwnW4P0rI1AgZttLOPkkWQpMzZ9zikbc-o1zU1cI-5OiIpk-OoTXE5zq6IRMXDlGZDTrwe8FMTwMRMWPP44-qbUSxbWHXN8-RiJhR2fDp9WibNeocEpqg
```

PS256 usa PSS com salt do tamanho do hash (32 bytes) e SHA-256. Cada assinatura é diferente (salt aleatório); a verificação é determinística.

## Assinatura HMAC de webhook

Com `authType: HMAC`, cada entrega leva `X-Signature = base64(HMAC_SHA256(secret, corpo_bruto))` (Base64 padrão, com padding). Calcule sobre os bytes exatos recebidos — nunca sobre JSON reserializado.

| Campo         | Valor                                          |
| ------------- | ---------------------------------------------- |
| `secret`      | `whsec_test_0123456789abcdef0123456789abcdef`  |
| `X-Signature` | `JNDRKgQ0ApKBavDOoLYfNnQHhFXUN6RhEspaqKf5fX8=` |

**Corpo bruto**

```json
{"id":"pix-in-E0000000020251229211433912","type":"pix.in.completed","occurredAt":"2025-12-29T21:14:33.912Z","schemaVersion":"1.0","environment":"sandbox","tenantId":"tenant-acme","accountId":"acc_123456","data":{"transactionId":"2ee948cb-4e03-43d1-b202-b7fb31d5b016","endToEnd":"E0000000020251229211433912","amount":150.5,"status":"SUCCESS"}}
```