Direct purchases
This functionality allows the PCI merchants to make an authorization sending card data information in one step without the needed of an extra call for card tokenization unlike the basic purchase.
Request URL
You must invoke a POST request to the following URLs according to your needs.
- Production:
https://secure-api.bamboopayment.com/v2/api/purchase - Stage:
https://secure-api.stage.bamboopayment.com/v2/api/purchase
Request example
{
"CardData": {
"CardHolderName": "John Doe",
"Pan": "4507990000004905",
"CVV": "123",
"Expiration": "08/30",
"Email": "john.doe@example.com",
"Document": "74857601"
},
"Capture": true,
"Amount": 15000,
"Currency": "USD",
"TargetCountryISO":"AR",
"Installments": 1,
"Description": "Description",
"Customer": {
"BillingAddress": {
"Country": "BRA",
"City": "São Paulo",
"State": "SP",
"PostalCode": "04538132",
"AddressDetail": "Brig. Faria Lima Avenue 10th Floor "
},
"Email": "john.dose@example.com",
"DocNumber": "74857601",
"PhoneNumber": "+5521987654321",
"FirstName": "John",
"LastName": "Doe",
"DocumentTypeId":4
}
}
The fields CardData, PaymentMediaId and TrxToken are not required; Nevertheless, one of them must be send depending of which flow to use.
CardData: Must be used for transactions using non-tokenized cards.
PaymentMediaId: Identifier of alternative payment method (transference, cash and any flow needing a redirection of the client). This identifier can be found in the Payment Methods by Country section.
TrxToken: The merchant can generate a token and use it to generate transactions if necessary.
Response Example
{
"Response": {
"PurchaseId": 139126,
"Created": "2022-12-08T09:22:58.890",
"Order": "24542341343",
"Transaction": {
"TransactionID": 149462,
"Created": "2022-12-08T09:22:58.857",
"AuthorizationDate": "2022-12-08T09:23:12.060",
"TransactionStatusId": 1,
"Status": "Approved",
"ErrorCode": null,
"Description": "100 ACCEPT",
"ApprovalCode": "831000",
"Steps": [
{
"Step": "Generic External",
"Created": "2022-12-08T09:23:05.917",
"Status": "Authorization OK - Step 1",
"ResponseCode": "200",
"ResponseMessage": "OK",
"Error": "",
"AuthorizationCode": null,
"UniqueID": null,
"AcquirerResponseDetail": ""
},
{
"Step": "Generic External",
"Created": "2022-12-08T09:23:12.033",
"Status": "Authorization OK",
"ResponseCode": "100",
"ResponseMessage": "ACCEPT",
"Error": "",
"AuthorizationCode": "831000",
"UniqueID": null,
"AcquirerResponseDetail": ""
}
]
},
"Capture": true,
"Amount": 2700,
"OriginalAmount": 2700,
"TaxableAmount": null,
"Tip": 0,
"Installments": 1,
"Currency": "UYU",
"Description": "56341245341",
"Customer": {
"CustomerId": 61046,
"Created": "2022-12-05T17:24:43.720",
"CommerceCustomerId": null,
"Owner": "Anonymous",
"Email": "b@s.com",
"Enabled": true,
"ShippingAddress": null,
"BillingAddress": {
"AddressId": 59853,
"AddressType": 2,
"Country": "URY",
"State": "RIVERA",
"AddressDetail": "test 1 ",
"PostalCode": "40000",
"City": "Rivera"
},
"Plans": null,
"AdditionalData": null,
"PaymentProfiles": [
],
"CaptureURL": null,
"UniqueID": null,
"URL": "Customer/61046",
"FirstName": "John",
"LastName": "Doe",
"DocNumber": "74857601",
"DocumentTypeId": null,
"PhoneNumber": "+59899999999"
},
"RefundList": null,
"PlanID": null,
"UniqueID": null,
"AdditionalData": "",
"CustomerUserAgent": null,
"CustomerIP": null,
"URL": "https://api.bamboopayment.com/v1/api/Purchase/139126",
"Acquirer": {
"AcquirerID": 90,
"Name": "VisaNetUYv2",
"CommerceNumber": null
},
"CommerceAction": null,
"PurchasePaymentProfileId": 62872
},
"Errors": []
}
