Foundations

Introduction
Auth
Models

Merchant Operations

Introduction
Transaction
Cart
Reporting
Funding
- Get settlement reportget
Models
- Transaction
- Transaction Metadata

Buyer Management

Introduction
Buyer
Buyer Status
Models
Webhooks
- Buyer Updated Event

Checkout

Introduction
Application
Virtual Card
Models
Webhooks

Servicing

Introduction
Servicing
As Low As
- Get As-Low-Asget
- Get financing/loan-termsget
Financing Payment Plan
- Get Financing Payment Planget
Financing Dynamic Disclosure
- Get Financing Dynamic Disclosureget
Disclosures
Disclosure Templates
- Get a disclosure templateget
Webhooks
- Loan Details Changed Event

Payments

Introduction
Payment Methods
Payments
Refunds
Models

Webhook

Introduction
Subscription Management
Events
- List eventsget
- Replay an eventpost
Client Management
- List JWKsget
Models
Webhooks
- Integration Test Event

Tradein

Introduction
Tradein
Payment Agreement
Models

Foundations

Introduction
Auth
Models

Merchant Operations

Introduction
Transaction
Cart
Reporting
Funding
- Get settlement reportget
Models
- Transaction
- Transaction Metadata

Buyer Management

Introduction
Buyer
Buyer Status
Models
Webhooks
- Buyer Updated Event

Checkout

Introduction
Application
Virtual Card
Models
Webhooks

Servicing

Introduction
Servicing
As Low As
- Get As-Low-Asget
- Get financing/loan-termsget
Financing Payment Plan
- Get Financing Payment Planget
Financing Dynamic Disclosure
- Get Financing Dynamic Disclosureget
Disclosures
Disclosure Templates
- Get a disclosure templateget
Webhooks
- Loan Details Changed Event

Payments

Introduction
Payment Methods
Payments
Refunds
Models

Webhook

Introduction
Subscription Management
Events
- List eventsget
- Replay an eventpost
Client Management
- List JWKsget
Models
Webhooks
- Integration Test Event

Tradein

Introduction
Tradein
Payment Agreement
Models

Create a buyer contact

post https://api-preview.platform.breadpayments.com/api/buyer/{id}/contact

Allows a user to create a new contact for a given buyer.

Upon success, the details of the new contact will be returned.

Non-existent buyer IDs will return 404 Not Found. Out of scope buyer IDs will return 401 Unauthorized.

URL Expired

The URL for this request expired after 30 days.

Path Params

uuid

required

Buyer ID

Body Params

Buyer Contact

address

object

Represents a fully defined address for an entity

contactType

string

Optional. Represents the type of contact.

createdAt

date-time

The timestamp value formatted per RFC3339. This does not allow nulls.

string

required

Email address

name

object

required

Represents the full name

phone

string

required

Telephone number including country code

updatedAt

date-time

The timestamp value formatted per RFC3339. This does not allow nulls.

Responses

Response body

object

address

object

Represents a fully defined address for an entity

address1

string

required

First address line

address2

string

Second address line

locality

string

required

The locality (e.g. City) of the address.

postalCode

string

required

The administrative postal code (e.g. Zip Code)

region

string

required

length ≥ 2

The region or first-level administration division (e.g. State/Province) of the address.

country

string

required

length between 2 and 2

The two character ISO-3166-1 country code.

addressType

string

Represents the type of address.

Firm GeneralDelivery HighRise POBox RuralRoute Street NoMatch InternationalNone InternationalAdministrativeArea InternationalLocality InternationalThoroughfare InternationalPremise InternationalDeliveryPoint Other

buyerID

uuid

ID of the buyer associated with this contact.

contactType

string

Optional. Represents the type of contact.

PRIMARY HOME WORK OTHER BILLING SHIPPING

createdAt

date-time

The timestamp value formatted per RFC3339. This does not allow nulls.

string

required

Email address

uuid

Unique ID associated with this contact.

name

object

required

Represents the full name

givenName

string

required

Given name

familyName

string

required

Family name

additionalName

string

Additional name, if any

phone

string

required

Telephone number including country code

updatedAt

date-time

The timestamp value formatted per RFC3339. This does not allow nulls.

Response body

object

reason

string

Buyer error reason codes

Buyer_Validation Buyer_Search_Validation Buyer_Status_Validation Contact_Validation Normalized_Address_Validation Authorized_Third_Party_Validation Credit_File_Validation Buyer_Not_Found Authorized_Third_Parties_Not_Found Contacts_Not_Found Normalized_Addresses_Not_Found Credit_Files_Not_Found Identity_Mismatch Phone_Exists Email_Exists Dependency_Response_Invalid Dependency_Unavailable Database_Failure Encryption_Failure Buyer_Phone_Invalid_Type Unauthorized Buyer_Conflict

code

int32

required

The underlying http status code

message

string

required

A simple message in english describing the error and can be returned to the consumer

domain

string

required

The domain where the error is originating from as defined by the service

metadata

object

Any additional details to be conveyed as determined by the service. If present, will return map of key value pairs

Has additional fields

Response body

object

reason

string

required

A reason code specific to the service and can be used to identify the exact issue. Should be unique within a domain

code

int32

required

The underlying http status code

message

string

required

A simple message in english describing the error and can be returned to the consumer

domain

string

required

The domain where the error is originating from as defined by the service

metadata

object

Any additional details to be conveyed as determined by the service. If present, will return map of key value pairs

Has additional fields

Response body

object

reason

string

required

A reason code specific to the service and can be used to identify the exact issue. Should be unique within a domain

code

int32

required

The underlying http status code

message

string

required

A simple message in english describing the error and can be returned to the consumer

domain

string

required

The domain where the error is originating from as defined by the service

metadata

object

Any additional details to be conveyed as determined by the service. If present, will return map of key value pairs

Has additional fields

Response body

object

reason

string

Buyer error reason codes

code

int32

required

The underlying http status code

message

string

required

A simple message in english describing the error and can be returned to the consumer

domain

string

required

The domain where the error is originating from as defined by the service

metadata

object

Any additional details to be conveyed as determined by the service. If present, will return map of key value pairs

Has additional fields

Response body

object

reason

string

Buyer error reason codes

code

int32

required

The underlying http status code

message

string

required

A simple message in english describing the error and can be returned to the consumer

domain

string

required

The domain where the error is originating from as defined by the service

metadata

object

Any additional details to be conveyed as determined by the service. If present, will return map of key value pairs

Has additional fields

Updated 1 day ago

Update a buyer

Get a buyer contact

Language

Credentials

Bearer

JWT

URL


xxxxxxxxxx
1
curl --request POST \
2
     --url https://api-preview.platform.breadpayments.com/api/buyer/id/contact \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

text/plain

Updated 1 day ago

Update a buyer

Get a buyer contact

Foundations
Introduction
Auth
Get App Identitiesget
Expire Org Codespost
Authorize Org Codepost
Get Org Codesget
Create Org Codespost
Exchange Service Account JWT For Buyer JWTpost
Authorize a Service Accountpost
Exchange Org User Tokenpost
Refresh a Buyer JWTpost
Login with an OTP Codepost
Authorize a buyer based on buyer credentialspost
Verify an OTP Codepost
Get the status of a Verification OTP Codeget
List codesget
Send a Verification OTP Codepost
Models
UUID
Timestamp
Terms
Term Interval
Region
Phone
Percentage
Payment Product Type
Name
Money
Language Code
Identity
Error
Email
Date
Currency Code
Country Code
Contact
Basis Point
As Low As
Address

Merchant Operations
Introduction
Transaction
List Transactions CSVget
Transaction Aggregationget
Transaction KPIsget
Settle Transactionpost
Refund Transactionpost
Cancel Transactionpost
Authorize Transactionpost
Add Transaction Fulfillment Detailpost
Get Transaction Fulfillment Detailsget
Get Transaction Historyget
Extend Expirationpost
Update Transactionpatch
Get Transaction by Transaction IDget
Search Transactionsget
Get Transaction by Application IDget
Cart
Notify Buyerpost
Expire Cartpost
Delete Cartdelete
Update Cart informationpatch
Get Cartget
Create a Cartpost
List cartsget
Reporting
List funding daily balance dataget
Get legacy settlement reportget
List settlement report CSVget
List targeting export CSVget
List funding aggregate balance dataget
Get Loan History Report By Nameget
Funding
Get settlement reportget
Models
Transaction Metadata
Transaction

Buyer Management
Introduction
Buyer
Create a buyer bankruptcypost
Get a buyer bankruptcyget
Update a buyer's statusput
Get credit report data via service accountget
Update a buyer contactput
Get a buyer contactget
Create a buyer contactpost
Update a buyerput
Get a buyerget
Lookup buyersget
Register a buyerpost
Buyer Status
Models
Employment Type
Employment
Buyer Sub Status
Buyer Contact Map
Buyer Contact
Buyer
Authorized Third Party
Webhooks
Buyer Updated Event

Checkout
Introduction
Application
Complete Checkout for Instore Applicationpost
Prepare Checkout for Applicationpost
Complete Checkout for Applicationpost
Get Application by IDget
Start an Applicationpost
List Applications by Filterget
Virtual Card
Update Issuance Statuspost
Get wallet and DPANget
Get walletget
Get issuance cardget
Get issuanceget
Issue a new GooglePay digital wallet tokenpost
Issue a new ApplePay digital wallet tokenpost
Issue a new virtual cardpost
Models
Order Item
Order
Disclosure
Application
Webhooks

Servicing
Introduction
Servicing
Get Allowed Payment Method Typesget
Refund Paymentpost
Add an audit action for a payment agreementpost
List audit actions for a payment agreementget
GenerateDocument requests a disclosure document to be generated for the requested agreement ID. This method should only be used for special cases on specific disclosures, such as re-generating a disclosure for resolving an archer issue without notifying the buyer and requesting for acknowledgement.post
Calculate payment for a set of agreementsget
Process Scheduled Paymentspost
Process Single Scheduled Paymentpost
Cancel a future paymentdelete
Cancel a payment agreementdelete
Update the loan amountput
Update Loan Interest Ratepost
Waive principal amountpost
Waive installment due amountpost
Waive remaining outstanding balancepost
Waive any remaining amountpost
Waive an amountpost
List Scheduled Payments by Payment Agreement IDget
Closes a disputeput
Check if eligible to open a disputeget
Open a disputepost
List disputesget
Schedule Future Paymentpost
Get Payment Agreement By Numberget
Set OCC to be manually reviewedpatch
Update OCC requestpatch
Backdate Paymentpatch
Add a payment recordpost
Reallocate Paymentpatch
Cancel a paymentdelete
Make Paymentpost
Get Balance Historyget
Enroll in Autopaypost
Unenroll from Autopaydelete
Get Payment Agreementget
List Scheduled Payment by Buyer IDget
Delete payment agreement tags.delete
Update payment agreement tagsput
List Payment Agreement Summariesget
Add OCC Recordpost
List OCC requestsget
List Buyer Payment Agreementsget
List Autopay Enrollmentsget
As Low As
Get financing/loan-termsget
Get As-Low-Asget
Financing Payment Plan
Get Financing Payment Planget
Financing Dynamic Disclosure
Get Financing Dynamic Disclosureget
Disclosures
List disclosuresget
Get static disclosureget
Get disclosure by targetget
Get disclosure by IDget
Get latest disclosureget
Generate a set of disclosurespost
Disclosure Templates
Get a disclosure templateget
Webhooks
Loan Details Changed Event

Payments
Introduction
Payment Methods
List Payment Method Failuresget
Create cybersource transient tokenpost
Create Payment Method Access Tokenpost
Delete Payment Methoddelete
Get Payment Methodget
List Payment Methodsget
Create Payment Methodpost
Payments
Search Payment in Cybersourceget
Reverse Paymentput
Receive a paymentput
Lists Payment Audit Recordsget
Fail Single Paymentput
Cancel a paymentput
Get Payment by either transaction id or reconciliation idget
Get Paymentget
Refunds
stop refund paper checkput
Get Refundget
List Refundsget
Models
Card Type
Card Connection Status
Card Connection
Card Account
Bank Provider
Bank Connection Status
Bank Connection
Bank Account

Webhook
Introduction
Subscription Management
Send a Subscription Integration Test Eventpost
Delete a subscriptiondelete
Update a subscriptionpatch
Get a subscriptionget
Create a subscriptionpost
List subscriptionsget
Events
Replay an eventpost
List eventsget
Client Management
List JWKsget
Models
Subscription
Event Dispatch
Create Subscription
Webhooks
Integration Test Event

Tradein
Introduction
Tradein
Creates an Upgradeable loan based on the given payment agreement IDpost
Retrieves the UpgradeableLoan entity by its own idget
Links a buyers old and new loanpost
Retrieves the UpgradeableLoan entity related to a payment agreementget
Applies a payment to an existing loan as part of the tradein processpost
Records user tradein electionpost
Payment Agreement
Models
Upgradeable Loan Entity
Tradein Error Reason
Payment Request
Election Entity

Foundations
Introduction
Auth
Get App Identitiesget
Expire Org Codespost
Authorize Org Codepost
Get Org Codesget
Create Org Codespost
Exchange Service Account JWT For Buyer JWTpost
Authorize a Service Accountpost
Exchange Org User Tokenpost
Refresh a Buyer JWTpost
Login with an OTP Codepost
Authorize a buyer based on buyer credentialspost
Verify an OTP Codepost
Get the status of a Verification OTP Codeget
List codesget
Send a Verification OTP Codepost
Models
UUID
Timestamp
Terms
Term Interval
Region
Phone
Percentage
Payment Product Type
Name
Money
Language Code
Identity
Error
Email
Date
Currency Code
Country Code
Contact
Basis Point
As Low As
Address

Merchant Operations
Introduction
Transaction
List Transactions CSVget
Transaction Aggregationget
Transaction KPIsget
Settle Transactionpost
Refund Transactionpost
Cancel Transactionpost
Authorize Transactionpost
Add Transaction Fulfillment Detailpost
Get Transaction Fulfillment Detailsget
Get Transaction Historyget
Extend Expirationpost
Update Transactionpatch
Get Transaction by Transaction IDget
Search Transactionsget
Get Transaction by Application IDget
Cart
Notify Buyerpost
Expire Cartpost
Delete Cartdelete
Update Cart informationpatch
Get Cartget
Create a Cartpost
List cartsget
Reporting
List funding daily balance dataget
Get legacy settlement reportget
List settlement report CSVget
List targeting export CSVget
List funding aggregate balance dataget
Get Loan History Report By Nameget
Funding
Get settlement reportget
Models
Transaction Metadata
Transaction

Buyer Management
Introduction
Buyer
Create a buyer bankruptcypost
Get a buyer bankruptcyget
Update a buyer's statusput
Get credit report data via service accountget
Update a buyer contactput
Get a buyer contactget
Create a buyer contactpost
Update a buyerput
Get a buyerget
Lookup buyersget
Register a buyerpost
Buyer Status
Models
Employment Type
Employment
Buyer Sub Status
Buyer Contact Map
Buyer Contact
Buyer
Authorized Third Party
Webhooks
Buyer Updated Event

Checkout
Introduction
Application
Complete Checkout for Instore Applicationpost
Prepare Checkout for Applicationpost
Complete Checkout for Applicationpost
Get Application by IDget
Start an Applicationpost
List Applications by Filterget
Virtual Card
Update Issuance Statuspost
Get wallet and DPANget
Get walletget
Get issuance cardget
Get issuanceget
Issue a new GooglePay digital wallet tokenpost
Issue a new ApplePay digital wallet tokenpost
Issue a new virtual cardpost
Models
Order Item
Order
Disclosure
Application
Webhooks

Servicing
Introduction
Servicing
Get Allowed Payment Method Typesget
Refund Paymentpost
Add an audit action for a payment agreementpost
List audit actions for a payment agreementget
GenerateDocument requests a disclosure document to be generated for the requested agreement ID. This method should only be used for special cases on specific disclosures, such as re-generating a disclosure for resolving an archer issue without notifying the buyer and requesting for acknowledgement.post
Calculate payment for a set of agreementsget
Process Scheduled Paymentspost
Process Single Scheduled Paymentpost
Cancel a future paymentdelete
Cancel a payment agreementdelete
Update the loan amountput
Update Loan Interest Ratepost
Waive principal amountpost
Waive installment due amountpost
Waive remaining outstanding balancepost
Waive any remaining amountpost
Waive an amountpost
List Scheduled Payments by Payment Agreement IDget
Closes a disputeput
Check if eligible to open a disputeget
Open a disputepost
List disputesget
Schedule Future Paymentpost
Get Payment Agreement By Numberget
Set OCC to be manually reviewedpatch
Update OCC requestpatch
Backdate Paymentpatch
Add a payment recordpost
Reallocate Paymentpatch
Cancel a paymentdelete
Make Paymentpost
Get Balance Historyget
Enroll in Autopaypost
Unenroll from Autopaydelete
Get Payment Agreementget
List Scheduled Payment by Buyer IDget
Delete payment agreement tags.delete
Update payment agreement tagsput
List Payment Agreement Summariesget
Add OCC Recordpost
List OCC requestsget
List Buyer Payment Agreementsget
List Autopay Enrollmentsget
As Low As
Get financing/loan-termsget
Get As-Low-Asget
Financing Payment Plan
Get Financing Payment Planget
Financing Dynamic Disclosure
Get Financing Dynamic Disclosureget
Disclosures
List disclosuresget
Get static disclosureget
Get disclosure by targetget
Get disclosure by IDget
Get latest disclosureget
Generate a set of disclosurespost
Disclosure Templates
Get a disclosure templateget
Webhooks
Loan Details Changed Event

Payments
Introduction
Payment Methods
List Payment Method Failuresget
Create cybersource transient tokenpost
Create Payment Method Access Tokenpost
Delete Payment Methoddelete
Get Payment Methodget
List Payment Methodsget
Create Payment Methodpost
Payments
Search Payment in Cybersourceget
Reverse Paymentput
Receive a paymentput
Lists Payment Audit Recordsget
Fail Single Paymentput
Cancel a paymentput
Get Payment by either transaction id or reconciliation idget
Get Paymentget
Refunds
stop refund paper checkput
Get Refundget
List Refundsget
Models
Card Type
Card Connection Status
Card Connection
Card Account
Bank Provider
Bank Connection Status
Bank Connection
Bank Account

Webhook
Introduction
Subscription Management
Send a Subscription Integration Test Eventpost
Delete a subscriptiondelete
Update a subscriptionpatch
Get a subscriptionget
Create a subscriptionpost
List subscriptionsget
Events
Replay an eventpost
List eventsget
Client Management
List JWKsget
Models
Subscription
Event Dispatch
Create Subscription
Webhooks
Integration Test Event

Tradein
Introduction
Tradein
Creates an Upgradeable loan based on the given payment agreement IDpost
Retrieves the UpgradeableLoan entity by its own idget
Links a buyers old and new loanpost
Retrieves the UpgradeableLoan entity related to a payment agreementget
Applies a payment to an existing loan as part of the tradein processpost
Records user tradein electionpost
Payment Agreement
Models
Upgradeable Loan Entity
Tradein Error Reason
Payment Request
Election Entity

200The created contact.

400Response for errors returned by buyer service.

401Unauthorized. Indicates that provided credentials is not valid

403Forbidden. Indicates that request cannot be authorized

404Response for errors returned by buyer service.

500Response for errors returned by buyer service.