Upload Orders
Upload orders to the chargeblast system. This will allow you to match disputes and chargebacks to the orders you have uploaded. Amount should be in cents, e.g. $19.99 => amount = 1999. This endpoint is rate limited to 100 requests every 10 seconds.
curl --request POST \
--url https://api.chargeblast.com/api/v2/orders/upload \
--header 'Content-Type: application/json' \
--data '{
"orders": [
{
"ip": "<string>",
"authCode": "<string>",
"amount": 123,
"bin": "<string>",
"descriptor": "<string>",
"id": "<string>",
"currency": "<string>",
"transactionDate": "<string>",
"brand": "<string>",
"gateway": "<string>",
"arn": "<string>",
"status": "<string>",
"last4": "<string>",
"refunded": true,
"receipt": {
"lineItems": [
{
"productName": "<string>",
"productDescription": "<string>",
"currency": "<string>",
"quantity": 123,
"price": 123
}
],
"customerEmail": "<string>",
"customerPhone": "<string>",
"shippingAddress": {
"line1": "<string>",
"line2": "<string>",
"city": "<string>",
"countrySubdivision": "<string>",
"postalCode": "<string>",
"country": "<string>",
"latitude": "<string>",
"longitude": "<string>"
},
"billingAddress": {
"line1": "<string>",
"line2": "<string>",
"city": "<string>",
"countrySubdivision": "<string>",
"postalCode": "<string>",
"country": "<string>",
"latitude": "<string>",
"longitude": "<string>"
},
"name": {
"givenName": "<string>",
"familyName": "<string>"
}
}
}
]
}'{
"message": "<string>"
}Query Parameters
Body
The amount, in cents, of the order. For example, $19.99 would be 1999.
The internal id of the order in your CRM.
The 3 character currency (case insensitive). E.g. 'usd'.
The date of the charge either in yyyy-MM-dd'T'HH:mm:ssZ format or yyyy-MM-dd format.
The ip address of the customer.
The authorization code of the charge. Used for matching purposes.
First 6 digits of the card.
The billing descriptor of the charge.
The brand of the card (case insensitive). visa, mastercard, amex, discover. Other values will default to unknown
If multiple gateways are used, the gateway of the transaction. Used for analytics only.
The acquirer reference number of the charge, if available.
The status of the transaction. Should be either 'succeeded' or 'failed'
Last 4 digits of the card.
Whether the transaction has already been refunded.
Additional info on the transaction. Only required for digital receipts and compelling evidence (pre-dispute re-presentment).
Line items for the receipt.
The name of the product.
A more detailed description of the product.
3 character ISO currency code. If nil, defaults to USD.
The quantity of the line item (defaults to 1).
The total price (in cents) of the line item. For if you bought 5 socks at $2 each, this field would be 1000.
Phone number if applicable, e.g. +14016993099. String in any ISO format is acceptable.
If a physical product, the shipping address of the customer.
For US addresses, the state - two letter coded. E.g. CA
The country spelled out, e.g. 'United States of America' or abbreviated 'USA'.
The billing address of the customer.
For US addresses, the state - two letter coded. E.g. CA
The country spelled out, e.g. 'United States of America' or abbreviated 'USA'.
Response
curl --request POST \
--url https://api.chargeblast.com/api/v2/orders/upload \
--header 'Content-Type: application/json' \
--data '{
"orders": [
{
"ip": "<string>",
"authCode": "<string>",
"amount": 123,
"bin": "<string>",
"descriptor": "<string>",
"id": "<string>",
"currency": "<string>",
"transactionDate": "<string>",
"brand": "<string>",
"gateway": "<string>",
"arn": "<string>",
"status": "<string>",
"last4": "<string>",
"refunded": true,
"receipt": {
"lineItems": [
{
"productName": "<string>",
"productDescription": "<string>",
"currency": "<string>",
"quantity": 123,
"price": 123
}
],
"customerEmail": "<string>",
"customerPhone": "<string>",
"shippingAddress": {
"line1": "<string>",
"line2": "<string>",
"city": "<string>",
"countrySubdivision": "<string>",
"postalCode": "<string>",
"country": "<string>",
"latitude": "<string>",
"longitude": "<string>"
},
"billingAddress": {
"line1": "<string>",
"line2": "<string>",
"city": "<string>",
"countrySubdivision": "<string>",
"postalCode": "<string>",
"country": "<string>",
"latitude": "<string>",
"longitude": "<string>"
},
"name": {
"givenName": "<string>",
"familyName": "<string>"
}
}
}
]
}'{
"message": "<string>"
}