Create pricing intent
Use this method to create a pricing intent that you can assign to a processing account.
In the request, you must provide the following:
- Processing fees, including the pricing program and the fee to process each transaction.
- Gateway fees, including the fee for each transaction handled by our gateway.
- Base fees, including maintenance and PCI fees.
In the response, our gateway returns information about the pricing intent and the pricingIntentId, which you need for the following methods:
- [Create Merchant Platform](https://docs.payroc.com/api/schema/boarding/merchant-platforms/create) - Assign the pricing intent to a processing account, when you create the merchant platform and its processing accounts.
- [Create Processing Account](https://docs.payroc.com/api/schema/boarding/merchant-platforms/create-processing-account) - Assign the pricing intent to a processing account.
- [Retrieve Pricing Intent](https://docs.payroc.com/api/schema/boarding/pricing-intents/retrieve) - Retrieve information about a pricing intent.
- [Update Pricing Intent](https://docs.payroc.com/api/schema/boarding/pricing-intents/update) - Update the details of a pricing intent.
- [Delete Pricing Intent](https://docs.payroc.com/api/schema/boarding/pricing-intents/delete) - Delete a pricing intent.
- [Partially Update Pricing Intent](https://docs.payroc.com/api/schema/boarding/pricing-intents/partially-update) - Partially update the details of a pricing intent.
Headers
Authorization
Bearer authentication of the form Bearer <token>
, where token is your auth token.
Idempotency-Key
Unique identifier that you generate for each request. You must use the [UUID v4 format](https://www.rfc-editor.org/rfc/rfc4122) for the identifier. For more information about the idempotency key, go to [Idempotency](https://docs.payroc.com/api/idempotency).
Request
This endpoint expects an object.
pricing intent version 5.0
Response
Successful response. We created the pricing intent and it is waiting for approval.
pricing intent version 5.0