curl --request POST \
  --url https://api.sandbox.z2pay.com/v1/transactions/{transactionId}/payments/process \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "customer": {
    "name": "<string>",
    "email": "jsmith@example.com",
    "document": "<string>"
  },
  "creditCard": {
    "cardId": "<string>",
    "token": "<string>",
    "billingAddress": {
      "street": "<string>",
      "number": "<string>",
      "complement": "<string>",
      "neighborhood": "<string>",
      "city": "<string>",
      "state": "<string>",
      "country": "<string>",
      "postalCode": "<string>"
    }
  },
  "boleto": {
    "expirationDate": "2023-11-07T05:31:56Z",
    "instructions": "<string>"
  },
  "pix": {
    "expirationDate": "2023-11-07T05:31:56Z"
  },
  "ip": "<string>",
  "paymentIds": [
    "<string>"
  ]
}
'

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    customer: {name: '<string>', email: 'jsmith@example.com', document: '<string>'},
    creditCard: {
      cardId: '<string>',
      token: '<string>',
      billingAddress: {
        street: '<string>',
        number: '<string>',
        complement: '<string>',
        neighborhood: '<string>',
        city: '<string>',
        state: '<string>',
        country: '<string>',
        postalCode: '<string>'
      }
    },
    boleto: {expirationDate: '2023-11-07T05:31:56Z', instructions: '<string>'},
    pix: {expirationDate: '2023-11-07T05:31:56Z'},
    ip: '<string>',
    paymentIds: ['<string>']
  })
};

fetch('https://api.sandbox.z2pay.com/v1/transactions/{transactionId}/payments/process', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.sandbox.z2pay.com/v1/transactions/{transactionId}/payments/process"

payload = {
    "customer": {
        "name": "<string>",
        "email": "jsmith@example.com",
        "document": "<string>"
    },
    "creditCard": {
        "cardId": "<string>",
        "token": "<string>",
        "billingAddress": {
            "street": "<string>",
            "number": "<string>",
            "complement": "<string>",
            "neighborhood": "<string>",
            "city": "<string>",
            "state": "<string>",
            "country": "<string>",
            "postalCode": "<string>"
        }
    },
    "boleto": {
        "expirationDate": "2023-11-07T05:31:56Z",
        "instructions": "<string>"
    },
    "pix": { "expirationDate": "2023-11-07T05:31:56Z" },
    "ip": "<string>",
    "paymentIds": ["<string>"]
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "processed": 1,
  "results": [
    {
      "payments": [
        {
          "id": "pay_k0fg3q4jjcbi56hdhbi7xlj5e",
          "status": "paid"
        }
      ]
    }
  ]
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Validation failed",
    "issues": [
      {
        "path": "status",
        "message": "Status inválido. Valores aceitos: pending, waiting_payment, paid, refused, canceled, refunded"
      },
      {
        "path": "startDate",
        "message": "Data deve ser ISO 8601 com timezone (ex.: 2026-06-24T00:00:00Z)"
      }
    ]
  }
}

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key"
  }
}

{
  "error": "A request with this idempotency key is already being processed"
}

{
  "error": "Idempotency key already used with a different request body"
}