Payment Method Distribution

In addition to built-in gateway integration, Spreedly supports the ability to distribute vaulted credit card data to non-gateway third parties, referred to as “receivers”. Distribution differs from third-party vaulting in that the recipient of the card data is not a known and supported gateway; it can be another third party with whom you do business.

How distribution works

Payment method distribution (PMD) allows you to transact against another service’s API while still controlling your customer’s card data by vaulting with Spreedly.

Consider a travel service that books accomodations on behalf of its users. The travel serivce would be able to store its customers’ card data in Spreedly up front and use that data to purchase airline and hotel reservations on behalf of its customers later. The service would ask its customers to enter their credit card information only once but would be able to use that information at any later time to make purchases at multiple independent services (e.g., airlines and hotels).

Spreedly’s payment method distribution enables businesses to transact with multiple endpoints on behalf of their customers via a single integration.

Single vs. batch distribution

Payment method distribution (PMD) can operate in two modes: single card PMD or batch export PMD. If you’re working with an external HTTPS API endpoint that accepts a single card per call, then use single card PMD. If you’re working with an SFTP endpoint that accepts a file containing multiple cards, then use batch export PMD.

In both modes, the basic workflow remains the same: you specify a template that tells Spreedly how to format the request and which card(s) to deliver, and Spreedly executes the call on your behalf. The single card and batch export PMD modes operate very similarly; one small difference between the two is that batch export operates asynchronously, making it a bit more complex.

The following guides explain how to provision a receiver and how to distribute payment methods for the two PMD modes:

Supporting your receiver

You can begin developing and testing your PMD workflow using a test receiver. However, before you can distribute real payment method data, your receiver must be confirmed and whitelisted. Please email the following information to Spreedly to get your receiver in the approval queue:

  • the receiver name and/or company name,
  • a link to their public site, and
  • the production URL you will be invoking with Spreedly payment data. Note that the production URL must utilize SSL.

While the endpoint must utilize SSL, Spreedly does not require the SSL certificate to set up and whitelist the domain, which ensures that you are not affected when the receiver updates their certificates. If there will be a domain change, please contact Spreedly Support and let us know in advance.

Alternatively, if you have an existing relationship or contact at the receiver company, you can send them to Becoming a Receiver so that they can work with Spreedly directly.

We ask that you allow several weeks for Spreedly to approve and configure a receiver for production use. During this time, you can begin testing against a test receiver, which allows test payment methods to be delivered to any user-specified endpoint URL.

Once you’ve set up your receiver, you can see which requests are powered by Spreedly by looking for the X-Transaction-Powered-By: Spreedly header. Filtering requests to ones with this header can be helpful for debugging and for tracking Spreedly-originating transactions.

List of supported receivers

We currently support the following receiver types and their associated whitelisted URLs:

Company Receiver Type and Hostnames
A1 Payments a1_payments
Acapture acapture
Ace Rent a Car ace_rent_a_car
Adquira adquira
Adyen MarketPay adyen_marketpay
Adyen adyen
Airtime Rewards airtime
Alliance Reservations Network alliance_reservations_network
Allianz Global Assistance allianz_global_assistance,
American Express american_express,,,,
s authorize_net,,
AXS axs
Bankwest bankwest
Base Commerce base_commerce
BBC Shop bbc_shop
BestBus bestbus
Bink bink
Blackbaud blackbaud
Blacklane blacklane
Blue Ribbon Bags blue_ribbon_bags
Bluesnap bluesnap bookingcom
Braintree Payments braintree,
Bypass Mobile bypass_mobile
CardConnect CardSecure cardconnect_cardsecure
Cardstream cardstream
Cashbackpoint cashbackpoint
CASHNet cashnet
CDS Global cds_global
CECABank ceca_bank,
Chain Commerce chain_commerce checkout_dot_com,
Clover clover
Cosmic Cart cosmic_cart
Credomatic credomatic
Credorax credorax
CrowdTorch crowd_torch
Cybersource Decision Manager cybersource_decision_manager
CyberSource cybersource
Dalenys dalenys
Mastercard Payment Gateway Services data_cash
Demandware demandware
DHISCO dhisco
DirectConnect direct_connect
Diane Von Furstenberg dvf
Expedia Affiliate Network ean,
Economy Rent a Car economy_rent_a_car
eGlobalfares eglobalfares
8D eight_d,,,
emerchantpay emerchantpay
ePay epay
Electronic Payment Exchange epx
Eventbrite eventbrite
Expedia expedia
FanXchange fan_xchange,,
Farelogix farelogix
Fidel fidel
Finix Payments finix_payments
First Data India Pvt Ltd. first_data_india,
First Pay first_pay
FreedomPay freedom_pay,
Global Technology Partners global_technology_partners
Golf18Network golf18_network
GolfNow golf_now
Green Dot green_dot,,,
Heidelpay heidelpay
Hertz hertz,
iFly Res (IBS) iflyres
Ingenico ingenico
IXOPAY ixopay
JEM Marketing jem_marketing
JustRide justride
Kount kount
Lincoln Center lincoln_center,
Luminate Online luminate_online,
Lyft Bikes lyft_bikes
Mastercard mastercard,
Navitaire navitaire
Network for Good network_for_good
NÜ Car Rentals nu_car_rentals
Office Depot office_depot
Omnivore omnivore
1-800-Flowers one800_flowers
ONPEX onpex
Open Hotel open_hotel
Ordway Labs ordway_labs
Pace Payment Systems pace_payment_systems
PayFabric pay_fabric
Paycorp paycorp
Payflow payflow
Paymark Click paymark_click
Payreto payreto
Payvision payvision
PBSC pbsc,,,,,,,
PCI Booking pci_booking
Poynt poynt,
PrimeSport prime_sport
PromisePay promisepay
Qualpay, Inc qualpay
Ravelin ravelin
RedCoach red_coach
RedShield red_shield,
Routes Car Rental routes_car_rental
Sabre sabre,,,,
SafeCharge safe_charge
Sage Pay sage_pay
SecurionPay securion_pay
Shopify shopify
Shoppable shoppable,
SiteMinder site_minder,
Sixt sixt
SpeedPay speedpay
Spreedly spreedly sprinterbus_net
Storebox storebox
Stripe stripe
SynXis synxis
SysPay syspay
Target target
Transcor Data Services tds_tickets
Telecharge telecharge,,,,
Tempus Technologies tempus
Tessitura tessitura_ramp
https://* ticket_network
Ticketmaster ticketmaster,
Toast toast
TokenEx tokenex
TransferWise transferwise
Travelfusion travel_fusion
Travelport travelport
Travolutionary travolutionary
Truevo truevo
TSD tsd
Two Tap two_tap
USAePay usaepay,
RentPayment vacation_rent_payment,
Viator viator
Virtual Card Services virtual_card_services
Walpay walpay
Wantickets wantickets
Webinc webinc
Windsurfer CRS windsurfer_crs,,
Wirecard wirecard
Worldline worldline
Worldpay RiskGuardian worldpay_riskguardian,,,
YapStone yapstone