curl --request POST \
--url https://api-sandbox.revolv3.com/api/Payments/sale \
--header 'Content-Type: application/json-patch+json' \
--header 'x-revolv3-token: <api-key>' \
--data '
{
"networkProcessing": null,
"paymentMethod": {
"billingAddress": null,
"creditCard": {
"paymentAccountNumber": "4111111111111111",
"expirationDate": "0835",
"securityCode": null,
"networkToken": null
},
"ach": null,
"googlePay": null,
"applePay": null,
"merchantPaymentMethodRefId": null,
"billingFirstName": "Joe",
"billingLastName": "Doe",
"billingFullName": null
},
"threeDS": null,
"customerId": null,
"includeRawProcessorResponse": false,
"invoice": {
"merchantInvoiceRefId": null,
"orderProcessingChannel": null,
"ecommercePlatformUrl": null,
"amount": {
"currency": "USD",
"value": 30.99
}
},
"dynamicDescriptor": null,
"reportGroup": null
}
'{
"customerId": 1,
"invoiceId": 1234,
"merchantInvoiceRefId": "1234-5678-9101",
"merchantPaymentMethodRefId": null,
"networkTransactionId": "434db22c-485a-4454-9607-9229092b611f",
"invoiceStatus": "Paid",
"invoiceAttemptStatus": "Success",
"message": "Approved",
"amount": {
"currency": "USD",
"value": 30.99
},
"paymentMethodId": 1,
"paymentMethodTypeId": 1,
"paymentProcessor": "WorldPay",
"processorMerchantId": "700010",
"rawResponse": "Processor raw response (without parsing on Revolv3 side)",
"paymentMethodCreditCardDetails": {
"binNumber": "411111",
"paymentLast4Digit": "1111",
"paymentExpirationDate": "0835",
"accountUpdateMessage": null,
"accountUpdateDateTime": null,
"accountUpdateCode": null,
"paymentAccountNumber": null
},
"responseMessage": "Approved",
"responseCode": "00",
"processorResponseDateTime": null,
"authCode": null,
"processorTransactionId": null,
"revolv3ResponseCode": null,
"revolv3ResponseMessage": null
}Sale With Payment Method Details
Processes a direct sale transaction using full payment method details (e.g., card number, expiry, CVV, ACH info). This is a one-step charge operation — the payment is authorized and captured immediately.
You must provide customer and invoice details along with raw payment data. This method is typically used by PCI-compliant merchants who collect and transmit sensitive payment data from their own secure front end. Use this endpoint when a tokenized method is not yet available, or when the payment is initiated for a new customer.
⚠️ PCI DSS compliance is required to handle raw card or bank account data directly.
Quick Starts:
Related Links:
curl --request POST \
--url https://api-sandbox.revolv3.com/api/Payments/sale \
--header 'Content-Type: application/json-patch+json' \
--header 'x-revolv3-token: <api-key>' \
--data '
{
"networkProcessing": null,
"paymentMethod": {
"billingAddress": null,
"creditCard": {
"paymentAccountNumber": "4111111111111111",
"expirationDate": "0835",
"securityCode": null,
"networkToken": null
},
"ach": null,
"googlePay": null,
"applePay": null,
"merchantPaymentMethodRefId": null,
"billingFirstName": "Joe",
"billingLastName": "Doe",
"billingFullName": null
},
"threeDS": null,
"customerId": null,
"includeRawProcessorResponse": false,
"invoice": {
"merchantInvoiceRefId": null,
"orderProcessingChannel": null,
"ecommercePlatformUrl": null,
"amount": {
"currency": "USD",
"value": 30.99
}
},
"dynamicDescriptor": null,
"reportGroup": null
}
'{
"customerId": 1,
"invoiceId": 1234,
"merchantInvoiceRefId": "1234-5678-9101",
"merchantPaymentMethodRefId": null,
"networkTransactionId": "434db22c-485a-4454-9607-9229092b611f",
"invoiceStatus": "Paid",
"invoiceAttemptStatus": "Success",
"message": "Approved",
"amount": {
"currency": "USD",
"value": 30.99
},
"paymentMethodId": 1,
"paymentMethodTypeId": 1,
"paymentProcessor": "WorldPay",
"processorMerchantId": "700010",
"rawResponse": "Processor raw response (without parsing on Revolv3 side)",
"paymentMethodCreditCardDetails": {
"binNumber": "411111",
"paymentLast4Digit": "1111",
"paymentExpirationDate": "0835",
"accountUpdateMessage": null,
"accountUpdateDateTime": null,
"accountUpdateCode": null,
"paymentAccountNumber": null
},
"responseMessage": "Approved",
"responseCode": "00",
"processorResponseDateTime": null,
"authCode": null,
"processorTransactionId": null,
"revolv3ResponseCode": null,
"revolv3ResponseMessage": null
}Headers
Optional identifier generated by the client to match its own logs with this request.
Allowed values: 1 to 128 characters, letters, digits and ., _, :, -.
Examples: order-12345, 3f2b8c1e-9d4a-4e7b-a1c5-6b0d2e8f7a91 (GUID), checkout:2026-11-02.17, retry_1.order-12345.
A valid value is returned in the Client-Request-Id response header and is stored with Revolv3 request logs, so it can be used when contacting support.
An invalid value is ignored and the request is processed normally. Do not send sensitive data in this header.
1 - 128^[A-Za-z0-9._:-]{1,128}$Body
Response
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.
100Conditional. 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.
10000
