curl --request POST \
--url https://api-sandbox.revolv3.com/api/Payments/authorization/{paymentMethodId} \
--header 'Content-Type: application/json-patch+json' \
--header 'x-revolv3-token: <api-key>' \
--data '
{
"onlinePaymentCryptogram": null,
"networkProcessing": null,
"amount": {
"currency": "USD",
"value": 30.99
},
"orderProcessingChannel": null,
"ecommercePlatformUrl": null,
"dynamicDescriptor": null,
"includeRawProcessorResponse": false,
"reportGroup": null,
"merchantInvoiceRefId": "1234-5678-9101"
}
'{
"networkTransactionId": "13d5c9b9-3a2a-4c27-9751-45b908f34496",
"paymentMethodAuthorizationId": 1,
"paymentMethod": {
"paymentMethodId": 1,
"billingAddressId": 1,
"billingAddress": {
"addressId": 1,
"addressLine1": "1 Default Street",
"addressLine2": null,
"city": "Los Angeles",
"state": "CA",
"postalCode": "90210",
"phoneNumber": null,
"email": null,
"country": "US"
},
"billingFirstName": "John",
"billingLastName": "Doe",
"merchantPaymentMethodRefId": "custom-payment-method-ref-id-001",
"paymentMethodAchDetails": null,
"paymentMethodCreditCardDetails": {
"binNumber": "411111",
"paymentLast4Digit": "1111",
"paymentExpirationDate": "0835",
"accountUpdateMessage": null,
"accountUpdateDateTime": null,
"accountUpdateCode": null,
"paymentAccountNumber": null
}
},
"paymentProcessor": "WorldPay",
"processorMerchantId": "10071676",
"responseMessage": "Approved",
"responseCode": "000",
"rawResponse": null,
"message": "Approved",
"processorResponseDateTime": null,
"authCode": null,
"processorTransactionId": null,
"revolv3ResponseCode": null,
"revolv3ResponseMessage": null,
"merchantInvoiceRefId": "1234-5678-9101"
}Authorize With Payment Method Id
Performs a payment authorization using a previously stored payment method, referenced by its unique ID. The funds are held on the customer’s account but not captured immediately.
This endpoint is typically used in multi-step checkout flows, bookings, or delayed fulfillment scenarios. It improves security and UX by leveraging saved payment methods, eliminating the need to re-enter payment data.
The authorization can later be captured using the Capture endpoint or voided via Reverse Authorization.
Related Links:
curl --request POST \
--url https://api-sandbox.revolv3.com/api/Payments/authorization/{paymentMethodId} \
--header 'Content-Type: application/json-patch+json' \
--header 'x-revolv3-token: <api-key>' \
--data '
{
"onlinePaymentCryptogram": null,
"networkProcessing": null,
"amount": {
"currency": "USD",
"value": 30.99
},
"orderProcessingChannel": null,
"ecommercePlatformUrl": null,
"dynamicDescriptor": null,
"includeRawProcessorResponse": false,
"reportGroup": null,
"merchantInvoiceRefId": "1234-5678-9101"
}
'{
"networkTransactionId": "13d5c9b9-3a2a-4c27-9751-45b908f34496",
"paymentMethodAuthorizationId": 1,
"paymentMethod": {
"paymentMethodId": 1,
"billingAddressId": 1,
"billingAddress": {
"addressId": 1,
"addressLine1": "1 Default Street",
"addressLine2": null,
"city": "Los Angeles",
"state": "CA",
"postalCode": "90210",
"phoneNumber": null,
"email": null,
"country": "US"
},
"billingFirstName": "John",
"billingLastName": "Doe",
"merchantPaymentMethodRefId": "custom-payment-method-ref-id-001",
"paymentMethodAchDetails": null,
"paymentMethodCreditCardDetails": {
"binNumber": "411111",
"paymentLast4Digit": "1111",
"paymentExpirationDate": "0835",
"accountUpdateMessage": null,
"accountUpdateDateTime": null,
"accountUpdateCode": null,
"paymentAccountNumber": null
}
},
"paymentProcessor": "WorldPay",
"processorMerchantId": "10071676",
"responseMessage": "Approved",
"responseCode": "000",
"rawResponse": null,
"message": "Approved",
"processorResponseDateTime": null,
"authCode": null,
"processorTransactionId": null,
"revolv3ResponseCode": null,
"revolv3ResponseMessage": null,
"merchantInvoiceRefId": "1234-5678-9101"
}Authorizations
Path Parameters
The unique identifier for the payment method information
Body
The amount information for the payment.
Show child attributes
Show child attributes
Network processing information.
Processors supporting this feature: Adyen, Nuvei, WorldPay, TSYS, BridgePay, Paymentech, PaymentLync.
Show child attributes
Show child attributes
Specifies the sales channel through which the shopper provides their card details.
Ecommerce - Internet or electronic commerce transaction. Moto - Single mail or telephone order transaction.
Processors supporting this feature: WorldPay, BridgePay. For other processors, Ecommerce is used by default.
Ecommerce, Moto The merchant's storefront or e-commerce platform URL or domain from which the transaction originates. If provided, this value will be sent to the processor (TSYS only) as the Acceptor URL Address. If not provided, the value configured in Merchant Details (E-Commerce Platform URL) will be used. If neither is available, the request is sent to TSYS without the Acceptor URL Address.
100Allows the merchant to define a dynamic descriptor, which appears in the payment statement. For dynamic descriptor, special configuration is required.
Processors supporting this feature: Nuvei, WorldPay, BridgePay, EPX, Paymentech, PaymentLync.
Show child attributes
Show child attributes
Determine whether to return raw processor data in the response.
Report Groups could be used to separate your transactions into different categories, so you can view the financial reports by your specific report group names (Worldpay only).
Merchant's unique identifier for the invoice.
100Decrypted package online payment cryptogram for a digital wallet.
512Response
OK
The identifier returned for Visa, Mastercard, and Discover transactions. Visa and Discover use this value to link subsequent payments in a recurring/installment stream back to the initial transaction. You must include this value in the request message (originalNetworkTransactionId element) for subsequent recurring payments.
100Unique identifier for a previously pre-authorized payment method.
1 <= x <= 1000000000The payment method information for the payment.
Show child attributes
Show child attributes
The name of the processor by which the transaction was processed.
100The merchant account ID (MID) of the processor by which the transaction was processed.
100The processor response message.
500The processor response code.
10Conditional. The value is returned if includeRawProcessorResponse = true. This field contains the raw data received from the processor after attempting to bill this payment. It does not contain any sensitive information. The field value is a string with the serialized response from the processor in JSON format.
10000The message returned directly from payment processor or a special message provided by system.
500UTC timestamp of the payment processor response (format: YYYY-MM-DDThh:mm:ss).
40Transaction authorization code.
20Payment Processor Transaction Id.
100Standardized internal response code indicating the outcome of the request.
10Message providing additional details about the response code.
500Merchant's unique identifier for the invoice.
100