Funding Sources
An Funding Source is owned by an Organization and defines the financial instrument/terms responsible for the ad spend. Funding sources are assigned to an Ad Account in order to pay for the activity within that Ad Account.
Attributes
Attribute | Description | Possible Values | Supported for type |
---|---|---|---|
id | ID of the funding source | ALL | |
created_at | Date of creation | ALL | |
updated_at | Date of last update | ALL | |
type | Funding Source type | LINE_OF_CREDIT, CREDIT_CARD, COUPON, PAYPAL | ALL |
status | Status of the funding source | ACTIVE, REDEEMED, SPENT, EXPIRED, DELETED | ALL |
budget_spent_micro | Budget Spent (micro-currency) | LINE_OF_CREDIT | |
currency | Account currency | USD, CAD, GBP, AUD, EUR | LINE_OF_CREDIT, COUPON |
total_budget_micro | Total Budget (micro-currency) | LINE_OF_CREDIT, CREDIT_CARD | |
budget_spent_micro | Budget spent (micro-currency) | LINE_OF_CREDIT, CREDIT_CARD | |
available_credit_micro | Total available credit | LINE_OF_CREDIT, COUPON | |
card_type | Credit Card Type | AMEX, DINERS_CLUB, DISCOVER, JCB, MAESTRO, MASTERCARD, VISA, UNKNOWN | CREDIT_CARD |
name | Name of the Credit Card | ALL | |
last_4 | Last 4 digits of the Credit Card | CREDIT_CARD | |
expiration_year | Expiration year of the Credit Card | CREDIT_CARD | |
expiration_month | Expiration month of the Credit Card | CREDIT_CARD | |
daily_spend_limit_micro | Daily spend limit for Credit Card (micro-currency) | CREDIT_CARD | |
daily_spend_limit_currency | Currency for the daily_spend_limit_micro | USD, CAD, GBP, AUD, EUR | CREDIT_CARD |
value_micro | Value of the COUPON (micro-currency) | COUPON | |
start_date | Start date of the COUPON | COUPON | |
end_date | End date of the COUPON | COUPON | |
Email associated with Paypal | PAYPAL |
Create a Funding Source
Funding sources using credit cards and PayPal can be set up using Business Manager
The Partner Manager team creates all other types of Funding Sources on behalf of partners and advertisers. Please reach out to your partner manager for assistance.
Get All Funding Sources
curl "https://adsapi.snapchat.com/v1/organizations/{organization_id}/fundingsources" \
-H "Authorization: Bearer meowmeowmeow"
The above command returns JSON structured like this:
{
"request_status": "SUCCESS",
"request_id": "59236a2500ff05763ff95f2fcc0001737e7465616d6b6f363139000161646d616e616765722d6170693a6b6162726168616d0001011d",
"fundingsources": [
{
"sub_request_status": "SUCCESS",
"fundingsource": {
"id": "1e224e75-3883-42cf-a5d9-ce505945d2d3",
"updated_at": "2017-05-22T22:46:30.917Z",
"created_at": "2017-05-22T22:46:30.917Z",
"type": "CREDIT_CARD",
"card_type": "DISCOVER",
"name": "My DISCOVER card",
"last_4": "1100",
"expiration_month": "12",
"expiration_year": "2020",
"daily_spend_limit_micro": 25000000,
"daily_spend_currency": "USD"
}
},
{
"sub_request_status": "SUCCESS",
"fundingsource": {
"id": "9d111fbf-da5f-4526-9e7b-226f847b3d7e",
"updated_at": "2017-05-22T22:46:30.920Z",
"created_at": "2017-05-22T22:46:30.920Z",
"type": "LINE_OF_CREDIT",
"available_credit_micro": 2000000000,
"currency": "USD",
"total_budget_micro": 10000000000,
"status": "ACTIVE",
"credit_account_type": "MANAGED",
"budget_spent_micro": 8000000000
}
},
{
"sub_request_status": "SUCCESS",
"fundingsource": {
"id": "d24b4011-3560-47ea-86fa-0ed14c6b90d4",
"updated_at": "2017-05-22T22:46:30.920Z",
"created_at": "2017-05-22T22:46:30.920Z",
"type": "COUPON",
"available_credit_micro": 10000000000,
"currency": "EUR",
"value_micro": 10000000000,
"status": "REDEEMED",
"start_date": "2017-05-22T22:46:30.923Z",
"end_date": "2017-05-22T22:46:30.923Z"
}
}
]
}
This endpoint retrieves all funding sources for the specified Organization.
HTTP Request
GET https://adsapi.snapchat.com/v1/organizations/{organization_id}/fundingsources
Parameters
Parameter | Default | Description |
---|---|---|
organization_id | Organization ID |
Get a Specific Funding Source
curl "https://adsapi.snapchat.com/v1/fundingsources/e703eb9f-8eac-4eda-a9c7-deec3935222d" \
-H "Authorization: Bearer meowmeowmeow"
The above command returns JSON structured like this:
{
"request_status": "success",
"request_id": "57b000ffd800ff05551a197221f10001737e616473617069736300016275696c642d35396264653638322d312d31312d370001010c",
"fundingsources": [
{
"sub_request_status": "success",
"fundingsource": {
"id": "e703eb9f-8eac-4eda-a9c7-deec3935222d",
"updated_at": "2016-08-11T22:03:54.337Z",
"created_at": "2016-08-11T22:03:54.337Z",
"name": "Hooli Test Ad Account Funding Source",
"type": "LINE_OF_CREDIT",
"organization_id": "40d6719b-da09-410b-9185-0cc9c0dfed1d",
"currency": "USD"
}
}
]
}
This endpoint retrieves a specific funding source.
HTTP Request
GET https://adsapi.snapchat.com/v1/fundingsources/{funding_source_id}
URL Parameters
Parameter | Description |
---|---|
funding_source_id | The ID of the funding source to retrieve |