---
title: "POST /api/payments/requests/{id}/processor"
method: POST
path: "/api/payments/requests/{id}/processor"
tags: ["api", "payment-requests"]
---

# POST /api/payments/requests/{id}/processor

`POST /api/payments/requests/{id}/processor`

Receive Processor Info

## Path parameters

- `id` string, required

## Request body

- POSTPaymentRequestsReceiveProcessorInfo
  - `paymentGatewayId` string, required — The ID of the payment gateway the client intents to use
  - `returnUrl` string — The URL to return after the user has completed the payment
  - `secret` string — The secret of the payment request

## Response `200`

OK

- PaymentRequestProcessorResource
  - `paymentGatewayType` 'stripe' | 'paypal' | 'adyen' | 'custom' | 'cardconnect' | 'worldline' | 'shift4' | 'authorizenet' | 'wallee' | 'square' | 'payfast' | 'touchnet' | 'transact' | 'unzer' | 'monext' | 'vivenuPayments' | 'ebanx' | 'rapyd' | 'momentusPayments' | 'additional-payment-method', required
  - `paymentGatewayId` string
  - `reference` string
  - `redirectUrl` string
  - `data` union
    - boolean
    - number
    - object
    - string
  - `createdAt` string, date-time, required — An ISO timestamp indicating when the payment request processor was created

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/vivenu/apis/vivenu-api.md) · [All operations](https://skmtc.net/vivenu/apis/vivenu-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vivenu/vivenu-api/revisions/36be0dca14e7/schema)