Buybox

Buybox enables you to build an optimized B2C purchase path to maximize the revenue generated by your gift card from your e-commerce and physical stores.

Source: https://www.buybox.net/produits/b2c

Features

Integration type

Embed (no redirection)

Tokenization

Yes

Payment Flow

1-step payment flow : Capture (direct debit)

2-step payment flow : Authorization + Capture

3-step payment flow : Pending Authorization + Authorization + Capture (asynchronous)

Additional features

Information request and CIT

MIT

Server-to-server

How to test?

Test Gift Cards

Code number	Pin Code
X342304R39637323	8531
X342305V34236601	7962
A342306M51901820	4269

Data Mapping & Mandatory Fields

Below is the mapping between your Create Session request and the fields expected by this payment method.

Purse Session field	Mandatory
amount	Yes
order.redirection	Yes
order.reference	Yes
order.currency_code	Yes
customer.reference	Yes

Payment Labels

Label	Method	Payment type
buybox	giftcard	secondary

Actions

Status

PSP status	State	Code	Description
SESSION_DATA_NOT_OK	ERROR	BAD_REQUEST	Session data doesn't meet the partner's requirements
SUCCESS	SUCCESS	SUCCEEDED	Successful operation
ERROR	ERROR	FAILED	Failed operation
001	ERROR	FAILED	Missing parameter.
002	ERROR	FAILED	Parameter is empty.
003	ERROR	FAILED	Unexpected parameter.
004	ERROR	FAILED	Parameter is null.
005	ERROR	FAILED	Parameter is not INT.
006	ERROR	FAILED	Parameter is not FLOAT.
007	ERROR	FAILED	Parameter is negative.
008	ERROR	FAILED	Wrong method.
009	ERROR	AUTHENTICATION_CHECK_FAIL	Authentication error, Cant find triplet (USR/PWD/SIGNATURE).
010	ERROR	FAILED	This shop name already exist in our database. Please change his name.
011	ERROR	INSUFFICIENT_FUNDS	There is not enough money on this card to execute the method DebitCard.
012	ERROR	FAILED	This CODE is already used or doesn’t exist. Use another value of CODE.
013	ERROR	FAILED	This shop doesn’t exist. Please create him or use another id.
014	ERROR	FAILED	This BOUSER doesn’t exist. Please change it.
015	ERROR	FAILED	Can’t use this SHOPID with the identified client. Please change it.
016	ERROR	FAILED	Can’t cancel this card because it was already used.
017	ERROR	CARD_IS_NOT_ACTIVE	This CODE isn’t activated. Can’t deactivate or debit it. Please activate this code to use it.
018	ERROR	WRONG_CARD_DATA	Can’t use this PINCODE with the actual value of CODE.
019	ERROR	FAILED	This parameter is too long to be insert in database.
020	ERROR	INSUFFICIENT_FUNDS	There is no more money on this card. Use another card.
021	ERROR	FAILED	Can’t use this CODE with the identified client. Please change it.
022	ERROR	FAILED	This version doesn’t exist. Refer to the documentation to know which version is usable.
023	ERROR	FAILED	Can’t use this SUBJECT with the identified client. Please change it.
024	ERROR	FAILED	Can’t use this SHOPID with the identified client. Please change it.
025	ERROR	AMOUNT_EXCEEDED	This AMOUNT is over max amount authorised
026	ERROR	UNKNOWN	An error occurred while processing. Please contact Buybox support.
027	ERROR	FAILED	Identified client has no visual in database. Can’t create a card without visual.
029	ERROR	FAILED	Cancellation of this kind of code is not possible technically
031	ERROR	FAILED	This method can’t be requested because it doesn’t exist or it isn’t allowed to be called
032	ERROR	FAILED	Amount is lower than minimum amount allowed for current code
033	ERROR	FAILED	This reference is already used. It can’t be used to create another user.
034	ERROR	FAILED	This reference is already used. It can’t be used to create another shop.
035	ERROR	FAILED	This shopName has not been found.
036	ERROR	FAILED	More than one shop has been found.
037	ERROR	FAILED	This shop doesn’t exist.
038	ERROR	FAILED	This shop doesn’t exist.
039	ERROR	FAILED	This shop criteria doesn't exist.
040	ERROR	FAILED	This user doesn’t exist.
041	ERROR	FAILED	This user doesn’t exist.
042	ERROR	FAILED	This user doesn’t exist.
043	ERROR	FAILED	This parameter is forbidden for this method and must be sent empty.
046	ERROR	FAILED	Debit is handled externally
047	ERROR	FAILED	You cannot send twice the same CUSTOMREF.
048	ERROR	FAILED	Min 10 chars. Max 30 chars. Allowed chars: 0-9a-zA-Z_. Field is optional.
049	ERROR	FAILED	No call to ActivateCard has been found with this custom reference.
050	ERROR	FAILED	Call to ActivateCard has been found with this custom reference but cannot be cancelled.
051	ERROR	FAILED	Call to ActivateCard has been found with this custom reference but cannot be cancelled.
053	ERROR	FAILED	Debit is handled externally so refund of a debit too.
054	ERROR	FAILED	This refund type doesn't exist.
055	ERROR	FAILED	Amount has to be empty on a full refund.
056	ERROR	FAILED	Can't use this TRANSACTIONID with the identified client.
057	ERROR	FAILED	Transaction status doesn’t allow a refund.
058	ERROR	FAILED	Transaction balance doesn’t allow a refund.
062	ERROR	FAILED	Max 30 chars. Allowed chars: 0-9a-zA-Z_. Field is optional.
063	ERROR	FAILED	Max 250 characters. Field is optional.
TIMEOUT	UNCERTAIN	TECHNICAL_ISSUE_TO_CONTACT_PARTNER	Timeout while contacting partner
PARTNER_SERVER_ERROR	UNCERTAIN	TECHNICAL_ISSUE_TO_CONTACT_PARTNER	Received internal server error from partner
PARTNER_BAD_GATEWAY	UNCERTAIN	TECHNICAL_ISSUE_TO_CONTACT_PARTNER	Received bad gateway error from partner
PARTNER_UNAVAILABLE	UNCERTAIN	TECHNICAL_ISSUE_TO_CONTACT_PARTNER	Received service unavailable error from partner