AccountVerification
Authentication
Customers
Invoices
PaymentMethod
Payments
curl --request POST \
--url https://api.revolv3.com/api/Payments/authorization \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json-patch+json' \
--data '
{
"paymentMethod": {
"paymentMethodTypes": [
"CreditCard"
],
"billingAddress": {
"addressId": null,
"addressLine1": "100 Main",
"addressLine2": null,
"city": "Santa Ana",
"state": "CA",
"postalCode": "91111",
"phoneNumber": null,
"email": null,
"country": "US"
},
"creditCard": {
"paymentAccountNumber": "4111111111111111",
"expirationDate": "1025",
"securityCode": null,
"networkToken": null,
"processingMethodType": "CreditCard"
},
"ach": null,
"googlePay": null,
"applePay": null,
"merchantPaymentMethodRefId": null,
"billingFirstName": "Joe",
"billingLastName": "Doe",
"billingFullName": null
},
"networkProcessing": {
"processingType": "InitialRecurring",
"originalNetworkTransactionId": null
},
"amount": {
"currency": "USD",
"value": 30.99
},
"orderProcessingChannel": null,
"dynamicDescriptor": null,
"includeRawProcessorResponse": false
}
'{
"networkTransactionId": "8f64a9bf-7449-4b3f-87a9-ce60bdc76f62",
"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": null,
"paymentMethodAchDetails": null,
"paymentMethodCreditCardDetails": null
},
"paymentProcessor": null,
"processorMerchantId": null,
"responseMessage": "Approved",
"responseCode": "000",
"rawResponse": null,
"message": null
}Authorize With Payment Method Details
Performs a payment authorization using raw payment method details (e.g., card number, expiration date, CVV, or bank account info), without capturing the funds immediately. This is typically used when you want to place a hold on the customer’s account — for example, to confirm availability of funds before fulfillment or booking.
You must provide the full payment data along with invoice details. The payment is validated with the processor, and if successful, an authorization is created and stored for later capture or reversal.
This endpoint is intended for PCI-compliant merchants, as it involves transmitting sensitive payment data directly.
The authorization can later be captured using the Capture endpoint or voided via Reverse Authorization.
curl --request POST \
--url https://api.revolv3.com/api/Payments/authorization \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json-patch+json' \
--data '
{
"paymentMethod": {
"paymentMethodTypes": [
"CreditCard"
],
"billingAddress": {
"addressId": null,
"addressLine1": "100 Main",
"addressLine2": null,
"city": "Santa Ana",
"state": "CA",
"postalCode": "91111",
"phoneNumber": null,
"email": null,
"country": "US"
},
"creditCard": {
"paymentAccountNumber": "4111111111111111",
"expirationDate": "1025",
"securityCode": null,
"networkToken": null,
"processingMethodType": "CreditCard"
},
"ach": null,
"googlePay": null,
"applePay": null,
"merchantPaymentMethodRefId": null,
"billingFirstName": "Joe",
"billingLastName": "Doe",
"billingFullName": null
},
"networkProcessing": {
"processingType": "InitialRecurring",
"originalNetworkTransactionId": null
},
"amount": {
"currency": "USD",
"value": 30.99
},
"orderProcessingChannel": null,
"dynamicDescriptor": null,
"includeRawProcessorResponse": false
}
'{
"networkTransactionId": "8f64a9bf-7449-4b3f-87a9-ce60bdc76f62",
"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": null,
"paymentMethodAchDetails": null,
"paymentMethodCreditCardDetails": null
},
"paymentProcessor": null,
"processorMerchantId": null,
"responseMessage": "Approved",
"responseCode": "000",
"rawResponse": null,
"message": null
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Show child attributes
Show child attributes
The amount information for the payment. Must NOT be less than zero.
USD, AED, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BMD, BND, BOB, BRL, BSD, BWP, BYN, BZD, CAD, CHF, CLP, CNH, CNY, COP, CRC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HTG, HUF, IDR, ILS, INR, IQD, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LYD, MAD, MDL, MKD, MMK, MNT, MOP, MRU, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SEK, SGD, SHP, SLE, SOS, SRD, STN, SVC, SZL, THB, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, UYU, UZS, VEF, VND, VUV, WST, XAF, XCD, XOF, XPF, YER, ZAR, ZMW, AFN, KPW, LRD, LSL, STD, SYP, TJS, ZMK, ZWD, SLL, MGA, HRK, CDF, BTN, BIF Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
None, ProcessorToken, NetworkToken, Ach, CreditCard, GooglePay, ApplePay None, ProcessorToken, NetworkToken, Ach, CreditCard, GooglePay, ApplePay Show child attributes
Show child attributes
Processing type is used to define the initial or subsequent transaction in a recurring or installment stream.
If no value is supplied, a transaction is considered a one-time payment and will not be linked to the initial one.
InitialRecurring, Recurring, InitialInstallment, Installment Element defines the networkTransactionId returned in the response messages for Visa, Mastercard, and Discover Auth/Sale transactions. You must include this element and the original value returned for subsequent (after the initial) recurring/installment payments.
Ecommerce, Moto Show child attributes
Show child attributes
The internal merchant's ID, which is sent to the relevant card scheme.
The merchant name, as is displayed for the transaction on the consumer’s card statement. For payment facilitator only, might consist of the following structure: [Prefix]*[Sub Merchant Name] - where:
- [Prefix] – The PayFac prefix, approved by processor.
- '*' – A fixed character.
- [Sub Merchant Name] – The sub-merchant name. For example: aaa*name
Recommended! An alternative method to define a prefix is by configuring it through the Revolv3 Portal.
Nuvei processor: the maximum length of the parameter is 22. Possible prefix length 3 or 5 or 7 or 12 characters. WorldPay processor: if the value is specified, it must be between 4 and 25 characters. Possible prefix length 3 or 7 or 12 characters. Field accepts numbers, letters and special characters as follows: ampersand, asterisk (zero or one), comma, dash, period, space, or pound sign. BridgePay processor: the maximum length of the parameter is 46.
The merchant (sub-merchant for payment facilitators) contact information, as is displayed for the transaction on the consumer’s card statement.
Nuvei processor: the maximum length of the parameter is 13. It can also be an email address. WorldPay processor: the maximum length of the parameter is 13. Field accepts only numbers. BridgePay processor: the maximum length of the parameter is 13.
The payment facilitator's sub-merchant's 2-letter ISO country code.
City.
Response
OK
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes