Skip to main content
Version: 8.8.x

Customer Payment Instructions

Payment instructions provide the required creation details for defining valid payment instruments for corresponding third-party payment providers.

Read Request Instructions Form​

Provides the request payment instructions form for a third-party payment provider.

Workflow​

  1. Start with payment method
  2. GET the link with rel: requestinstructionsform
  3. Render the response

Response Fields​

Type: paymentinstructions.payment-method-configuration​

NameDescriptionType
billing-addressThe billing address information used during the payment instrument creation process.object
  nameThe customer name.object
    given-nameThe person’s given name.string
    family-nameThe person’s family name.string
  addressThe customer address. Address field names are based on the v.card specification. For more information on this specification, see v.card.object
    street-addressStreet address line 1.string
    street-address-2Street address line 2. This field is optional.string
    street-address-3Street address line 3. This field is optional.string
    localityThe city name.string
    regionThe region name. A region typically corresponds to a province or a state of a country.string
    postal-codeThe postal code or zip code.string
    country-nameThe country name.string
  phone-numberThe phone number.string
  organizationThe organization.string

Request Payment Instructions​

Provide the form to request payment instructions for a third-party payment provider.

Workflow​

  1. Start with payment method
  2. GET the link with rel: requestinstructionsform
  3. Fill out the form
  4. POST the form using the link with rel: requestpaymentinstructionsaction

Request Fields​

Type: paymentinstructions.payment-method-configuration​

NameDescriptionType
billing-addressThe billing address information used during the payment instrument creation process.object
  nameThe customer name.object
    given-nameThe person’s given name.string
    family-nameThe person’s family name.string
  addressThe customer address. Address field names are based on the v.card specification. For more information on this specification, see v.card.object
    street-addressStreet address line 1.string
    street-address-2Street address line 2. This field is optional.string
    street-address-3Street address line 3. This field is optional.string
    localityThe city name.string
    regionThe region name. A region typically corresponds to a province or a state of a country.string
    postal-codeThe postal code or zip code.string
    country-nameThe country name.string
  phone-numberThe phone number.string
  organizationThe organization.string