Skip to main content
Create Payment Method
curl --request POST \
  --url https://api.revolv3.com/api/PaymentMethod \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json-patch+json' \
  --data '
{
  "billingAddress": {
    "addressId": null,
    "addressLine1": "100 Main Street",
    "addressLine2": null,
    "city": "Santa Ana",
    "state": "CA",
    "postalCode": "90000",
    "phoneNumber": null,
    "email": null,
    "country": "US"
  },
  "creditCard": {
    "paymentAccountNumber": "4111111111111111",
    "expirationDate": "1025",
    "securityCode": null,
    "networkToken": null
  },
  "ach": null,
  "googlePay": null,
  "applePay": null,
  "merchantPaymentMethodRefId": "payment-method-ref-id_hgays-213-4rf4",
  "billingFirstName": "John",
  "billingLastName": "Smith",
  "billingFullName": null
}
'
{
  "paymentMethodId": 1,
  "billingAddressId": 1,
  "billingAddress": {
    "addressId": 1,
    "addressLine1": "123 Main",
    "addressLine2": null,
    "city": "Santa Ana",
    "state": "CA",
    "postalCode": "90000",
    "phoneNumber": null,
    "email": null,
    "country": "US"
  },
  "billingFirstName": "John",
  "billingLastName": "Smith",
  "merchantPaymentMethodRefId": "payment-method-ref-id_hgays-213-4rf4",
  "paymentMethodAchDetails": null,
  "paymentMethodCreditCardDetails": {
    "binNumber": "411111",
    "paymentLast4Digit": "1111",
    "paymentExpirationDate": "1025",
    "accountUpdateMessage": null,
    "accountUpdateDateTime": null
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

billingFirstName
string

Conditional: either both BillingFirstName and BillingLastName or BillingFullName must be provided.

The customers’s first name associated with a payment method that is used for billing purposes.

billingLastName
string

Conditional: either both BillingFirstName and BillingLastName or BillingFullName must be provided.

The customers’s last name associated with a payment method that is used for billing purposes.

billingFullName
string

Conditional: either BillingFullName or both BillingFirstName and BillingLastName must be provided.

The customers’s full name associated with a payment method that is used for billing purposes.

billingAddress
object

The address associated with a payment method that is used for billing purposes. Either an Address ID or detailed address information can be provided.

creditCard
object

Conditional: one payment method type is required.

Payment card information.

ach
object

Conditional: one payment method type is required.

ACH account information.

googlePay
object

Conditional: one payment method type is required.

Google Pay information.

applePay
object
merchantPaymentMethodRefId
string

Merchant's unique identifier for the payment method.

Response

The payment method was successfully created

paymentMethodId
integer<int64>

The unique identifier for the payment method information.

billingAddressId
integer<int64>

The unique identifier of the address.

billingAddress
object

The address associated with a payment method that is used for billing purposes. Either an Address ID or detailed address information can be provided.

billingFirstName
string

Conditional: either both BillingFirstName and BillingLastName or BillingFullName must be provided.

The customers’s first name associated with a payment method that is used for billing purposes.

billingLastName
string

Conditional: either both BillingFirstName and BillingLastName or BillingFullName must be provided.

The customers’s last name associated with a payment method that is used for billing purposes.

merchantPaymentMethodRefId
string

Merchant's unique identifier for the payment method.

paymentMethodAchDetails
object

ACH account information.

paymentMethodCreditCardDetails
object

The details of credit card payment method.