> 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://en.docs.api.corpx.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://en.docs.api.corpx.com/_mcp/server.

# Test vectors

The values below are generated and verified by the same code that validates
in production (`internal/reqsign`). If your implementation reproduces these
signatures, it will pass at the gateway.

> **Test RSA key**
>
> The PS256 private key published here exists only so you can reproduce the
> vector. It was never registered on any credential; do not use it for
> anything else.

## Request signature

Both algorithms sign the **same** canonical string (LF between lines, no trailing newline):

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

| Field                 | Value                                                              |
| --------------------- | ------------------------------------------------------------------ |
| `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

| Field | Value                                  |
| ----- | -------------------------------------- |
| `kid` | `cfe8291443215153e11b76a7a533dd3c`     |
| `jti` | `00000000-0000-4000-8000-000000000001` |

**Public key (SPKI PEM)**

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

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

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

The ES256 signature is 64 bytes (R||S, `ieee-p1363`). DER does not verify.

#### PS256

| Field | Value                                  |
| ----- | -------------------------------------- |
| `kid` | `5da1832445b8f656f3db0b3d78bf26ea`     |
| `jti` | `00000000-0000-4000-8000-000000000002` |

**Public key (SPKI PEM)**

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

**Test private key (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-----
```

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

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

PS256 uses PSS with salt length equal to the hash (32 bytes) and SHA-256. Every signature differs (random salt); verification is deterministic.

## Webhook HMAC signature

With `authType: HMAC`, every delivery carries `X-Signature = base64(HMAC_SHA256(secret, raw_body))` (standard Base64, with padding). Compute it over the exact bytes received — never over re-serialised JSON.

| Field         | Value                                          |
| ------------- | ---------------------------------------------- |
| `secret`      | `whsec_test_0123456789abcdef0123456789abcdef`  |
| `X-Signature` | `JNDRKgQ0ApKBavDOoLYfNnQHhFXUN6RhEspaqKf5fX8=` |

**Raw body**

```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"}}
```